📊 Full opportunity report: A Skill Is a Folder, Not a Prompt: What Anthropic Learned Running Hundreds of Them on ThorstenMeyerAI.com — validation score, market gap, and execution plan.

TL;DR

Anthropic has shifted from using prompts to defining Skills as folders that contain instructions, scripts, and reference materials. This approach improves AI output consistency, onboarding, and organizational knowledge retention. The company ran hundreds of Skills internally to refine this method.

Anthropic has revealed that its internal AI engineering teams treat Skills as folders containing instructions, reference documents, scripts, and configuration, not just saved prompts. This shift aims to create durable, reusable organizational assets that improve AI consistency, onboarding, and knowledge retention. The approach is part of Anthropic’s broader effort to institutionalize AI workflows, making them more reliable and scalable across teams.

In a detailed write-up from a Claude Code engineer, Anthropic explains that Skills are conceptualized as folders—not merely text prompts—containing a structured set of resources that an AI agent can discover, read, and execute. These folders include instructions, scripts, templates, reference data, and hooks that activate during specific workflows. This design allows organizations to bundle tribal knowledge, guardrails, and tools into a single, versioned asset, transforming ad-hoc prompting into a systematic, reusable process.

Anthropic emphasizes that this approach addresses common issues in AI deployment, such as output inconsistency and onboarding inefficiencies. By creating a library of Skills, companies can standardize outputs regardless of who runs the agent, compress onboarding time by replacing tribal knowledge with formalized assets, and build an evolving repository that improves over time as more edge cases are documented and refined. The company reports that its most effective Skills started small and improved through iterative use, making them valuable organizational assets.

Anthropic identified nine core categories of Skills, ranging from library references and product verification to infrastructure operations. Among these, verification Skills—used to check outputs—are considered the most impactful because they directly improve output quality. The company advocates for investing engineering effort into building high-quality Skills, especially in areas that catch mistakes and enforce standards.

At a glance
reportWhen: published March 2024
The developmentAnthropic published insights from its internal use of Skills, demonstrating that they are folders containing instructions, scripts, and assets rather than simple prompts, to improve AI deployment and organizational knowledge.
A Skill Is a Folder, Not a Prompt — Insights
AI Dispatch · Insights · 1 July 2026

A Skill is a folder, not a prompt

Anthropic published what it learned running hundreds of Skills across its own engineering org. Read as a business memo, the point is bigger than a coding trick: this is how ad-hoc prompting becomes durable institutional capability — the SOPs your agents actually follow, versioned and shared.

✕ The misconception

“A Skill is just a clever markdown prompt you save in a file.”

✓ What it actually is

A folder the agent can discover, read & run — instructions, scripts, references, templates, config & on-demand hooks.

Anatomy of a Skill — the file system is context engineering
my-skill/the unit you share & version
├─ SKILL.mdroot instructions + a description written for the model (its trigger)
├─ references/deep detail pulled in only when needed — progressive disclosure
├─ scripts/real code, so the agent composes instead of rebuilding boilerplate
├─ assets/templates & files to copy into the output
├─ config.jsonsetup the agent asks for if it’s missing (e.g. which Slack channel)
└─ hooks + memoryon-demand guardrails + an append-only log so it remembers
Why it matters: the folder itself is the knowledge base. The agent reads the root, then reaches deeper only when the task demands it — the same way you’d hand a new hire a one-pager that points to the detailed docs.
The nine types — a gap-analysis map for your own library
1Library / API reference
2Product verification ★ top impact
3Data fetching & analysis
4Business-process automation
5Code scaffolding & templates
6Code quality & review
7CI/CD & deployment
8Runbooks
9Infrastructure operations
By Anthropic’s own measurement, verification Skills — the ones that check the work — moved output quality the most. If you build one category well, build that one.
The craft — what separates a good Skill from a useless one
Gotchas = highest-signal section Describe for the model, not humans (it’s the trigger) Don’t state the obvious Ship scripts, not just prose On-demand guardrail hooks (/careful, /freeze) Let it remember (log / SQLite) Don’t railroad — leave room to adapt
The take

The knowledge of how your organization actually operates can be captured, versioned, shared & executed — and the thing capturing it is a humble folder with a script and a gotchas list inside. For the builder, that’s context engineering with real tools attached. For whoever owns the budget, it’s the difference between AI that starts from zero every morning and an asset that compounds. Caveats: best practices are still evolving, checked-in Skills cost context, and curation beats accumulation. Start with one Skill, one gotcha, and the category that catches your mistakes.

Source: “Lessons from building Claude Code: How we use skills,” Thariq Shihipar (Anthropic), Claude blog, 3 June 2026. Categories, examples & measured claims are Anthropic’s; framing is the author’s. Docs: code.claude.com/docs/en/skills.
thorstenmeyerai.com

Transforming AI Workflows into Reusable Organizational Assets

This approach represents a shift in how companies can manage AI systems at scale. By framing Skills as folders that contain all necessary instructions and tools, organizations can achieve more consistent outputs, reduce onboarding time, and create a living knowledge base that improves over time. This method moves away from fragile prompt engineering toward durable, versioned assets that embed tribal knowledge and guardrails, potentially setting a new standard for enterprise AI deployment.

Amazon

AI workflow management software

As an affiliate, we earn on qualifying purchases.

As an affiliate, we earn on qualifying purchases.

From Prompting to Asset-Based AI Management

Prior to this development, most teams relied on ad-hoc prompts—short instructions or templates—to guide AI behavior. These prompts are often fragile, difficult to maintain, and inconsistent across different users and contexts. Anthropic’s internal experiments with hundreds of Skills have demonstrated that organizing instructions, scripts, and reference data into folders creates a more robust, scalable approach. This method aligns with broader industry trends toward formalizing AI workflows and institutional knowledge, moving beyond simple prompt tuning.

The company’s internal use of Skills has been ongoing, with continuous refinement. Anthropic’s focus on verification Skills reflects a recognition that catching mistakes early has the greatest impact on output quality, especially in complex operational tasks.

“Skills are not just prompts; they are folders containing the instructions, scripts, and data that define how an organization actually gets work done with AI.”

— Thorsten Meyer, AI Engineer at Anthropic

Amazon

AI instruction and script organization tools

As an affiliate, we earn on qualifying purchases.

As an affiliate, we earn on qualifying purchases.

Unclear Aspects of Skills Implementation and Adoption

While Anthropic’s internal results are promising, it is not yet clear how broadly this approach will be adopted outside the company or how it will scale in larger, more complex organizations. Details about the process of creating, maintaining, and updating Skills at scale remain under development. Additionally, the impact on AI safety, governance, and compliance is still being evaluated, and the long-term benefits of this method are yet to be fully demonstrated.

Amazon

AI knowledge base software

As an affiliate, we earn on qualifying purchases.

As an affiliate, we earn on qualifying purchases.

Next Steps for Industry Adoption and Evaluation

Organizations interested in this approach should consider auditing their current AI workflows to identify repetitive tasks and tribal knowledge that could be encapsulated as Skills. Further research and case studies are expected to emerge, demonstrating how Skills can be scaled and maintained over time. Anthropic is likely to continue refining its internal process and share best practices for broader industry adoption, including tooling support for creating and managing Skills.

Amazon

AI prompt management system

As an affiliate, we earn on qualifying purchases.

As an affiliate, we earn on qualifying purchases.

Key Questions

How does treating Skills as folders improve AI consistency?

By bundling instructions, scripts, and reference data into a single, versioned asset, Skills ensure that the same task is performed consistently regardless of who runs the agent or when. This reduces variability caused by ad-hoc prompting.

Can Skills be used across different AI models or platforms?

While Anthropic’s approach is tailored to its own systems, the concept of organizing instructions and tools into reusable folders could potentially be adapted for other AI platforms, provided they support similar modular asset management.

What is the most valuable type of Skill according to Anthropic?

Verification Skills, which check the outputs and catch mistakes, are considered the most impactful because they directly improve output quality and reliability.

What are the challenges in implementing Skills as folders?

Creating, maintaining, and updating these structured assets requires engineering effort and discipline. Ensuring that descriptions trigger the correct Skills and that scripts stay synchronized with evolving workflows are ongoing challenges.

Will this approach replace prompt engineering entirely?

Not immediately. Instead, Skills as folders provide a more durable, scalable foundation for managing complex AI workflows, complementing prompt engineering rather than replacing it altogether.

Source: ThorstenMeyerAI.com

You May Also Like

Infrared vs. Steam Sauna: The Real Differences (No Marketing Fluff)

Learn the key differences between infrared and steam saunas to determine which type best suits your wellness needs and safety considerations.

When Does Cheap Memory Come Back? The 2027–2029 Question

Experts predict memory prices will stabilize around 2027, but relief may be modest and delayed until 2028–2029, with potential for lasting higher costs.

The bridge. Why the AI buildout runs on a nuclear story and a gas reality.

Exploring how AI data centers rely on gas for immediate power while nuclear promises arrive late, revealing a gap between energy narratives and infrastructure.

Staying steamy with some P.M. storm chances through the Holiday Weekend

Forecast shows afternoon and evening thunderstorms possible through the holiday weekend, with potential impacts on outdoor plans and safety.