A Skill Is A Folder, Not A Prompt: What Anthropic Learned Running Hundreds Of Them
AIThis post was created with the assistance of artificial intelligence (AI).

📊 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.

Prime Big Deal Days · Oct 6–7Offer from Amazon

Get tech for your team delivered free — and shop member deals

  • Fast, free delivery on millions of items
  • Access to Prime Big Deal Days deals on October 6–7
  • Prime Video, Amazon Music and more included
Start your free Prime trial Free trial for eligible customers · Cancel anytime
As an affiliate, we earn on qualifying purchases.

TL;DR

Anthropic has demonstrated that modeling Skills as folders—containing instructions, scripts, and reference materials—improves consistency, onboarding, and organizational learning in AI systems. This approach shifts from prompts to structured, reusable units.

Anthropic has revealed a new approach to building AI Skills, defining them as folders containing instructions, scripts, and assets rather than simple prompts. This shift aims to improve consistency, onboarding, and institutional knowledge retention, making AI systems more reliable and scalable. The development was shared by a Claude Code engineer in a detailed write-up, emphasizing its significance for organizations deploying AI.

According to the report, a Skill is not merely a prompt saved in a text file; it is a folder that can include instructions, reference documents, scripts, templates, data, configurations, and hooks. This structure allows AI agents to discover, read, and execute the contents dynamically, making organizational knowledge more durable and accessible.

Anthropic’s internal experiments involved running hundreds of Skills across its engineering teams, leading to three key benefits: output consistency regardless of who runs the agent, accelerated onboarding by embedding tribal knowledge directly into Skills, and compound improvement as Skills evolve through edge cases and refinements. The company emphasizes that a Skills library is an appreciating asset that captures how work is done, rather than a cost or static resource.

The report highlights a nine-category map of Skills, including library references, product verification, data analysis, automation, code scaffolding, quality review, deployment, runbooks, and infrastructure operations. The most valuable category, according to Anthropic, is verification, which ensures output quality and mistake catching. Technical lessons stress that effective Skills should focus on non-obvious, organization-specific content and include ‘gotchas’—traps or pitfalls that have been learned through experience.

At a glance
reportWhen: announced March 2024
The developmentAnthropic shared insights from its internal experiments showing that Skills should be viewed as folders rather than prompts, leading to more durable and scalable AI capabilities.
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

Implications for AI Deployment and Organizational Knowledge

This approach signals a shift from ad-hoc prompting to structured, reusable organizational assets for AI. By treating Skills as folders, companies can create more consistent, scalable, and maintainable AI systems. It also enhances knowledge retention, reduces onboarding time, and provides a clear framework for continuous improvement. This methodology could redefine best practices in enterprise AI deployment, emphasizing durability over fleeting prompt engineering.

Amazon

AI development knowledge management tools

As an affiliate, we earn on qualifying purchases.

As an affiliate, we earn on qualifying purchases.

How This Reframes AI Skill Building in Practice

Traditional AI prompting often involves crafting specific instructions for each task, which are then used once or infrequently. Anthropic’s insight shifts this paradigm by embedding knowledge into structured folders, making Skills reusable assets that evolve over time. This approach builds on prior efforts to standardize AI workflows but emphasizes durability and institutional memory. The concept aligns with broader trends toward modular, component-based AI systems, and reflects ongoing industry efforts to make AI deployment more reliable and scalable.

“Viewing Skills as folders containing instructions and assets fundamentally changes how organizations can build durable AI capabilities.”

— Thorsten Meyer, AI researcher

Amazon

AI scripting and instruction folders

As an affiliate, we earn on qualifying purchases.

As an affiliate, we earn on qualifying purchases.

Unresolved Questions About Implementation and Scalability

It is not yet clear how widely this folder-based Skills approach has been adopted outside Anthropic or how it performs in large-scale, real-world deployments. Details on integration with existing systems, maintenance overhead, and long-term evolution of Skills remain under discussion. Further, the extent to which this method can be standardized across different industries or AI frameworks is still uncertain.

Amazon

organizational AI asset libraries

As an affiliate, we earn on qualifying purchases.

As an affiliate, we earn on qualifying purchases.

Next Steps for Industry Adoption and Validation

Organizations interested in this approach will likely experiment with building their own Skills libraries based on Anthropic’s framework. Industry leaders and AI developers may seek to validate the effectiveness of folder-based Skills through pilot projects and case studies. Additionally, further research and shared best practices are expected to emerge, aiming to refine how Skills are structured, maintained, and integrated into enterprise AI workflows.

Amazon

AI onboarding templates and scripts

As an affiliate, we earn on qualifying purchases.

As an affiliate, we earn on qualifying purchases.

Key Questions

How does defining Skills as folders improve AI consistency?

By encapsulating instructions, reference materials, and scripts within a structured folder, Skills provide a stable, reusable asset that ensures the AI performs tasks uniformly, regardless of who runs it or when.

Can this approach be integrated with existing prompt-based systems?

While the folder-based Skills approach offers a more durable structure, it can complement prompt-based systems by providing a foundational asset that prompts can invoke or extend, enhancing overall robustness.

What are the main challenges in adopting folder-based Skills?

Challenges include establishing standards for organizing and maintaining Skills, integrating them into existing workflows, and ensuring that updates and refinements are systematically managed.

Is this approach suitable for all types of AI tasks?

It is most beneficial for tasks requiring consistency, institutional knowledge, and complex workflows, but may be less necessary for simple or one-off AI applications.

Source: ThorstenMeyerAI.com

HALLOWEEN

Halloween Picks

As an affiliate, we earn on qualifying purchases.

You May Also Like

The Bubble Is Not in Valuations: It’s in the Productivity Gap

Analysis of recent data shows AI’s productivity gains are modest, revealing a structural bubble in expectations rather than asset valuations.

Best AI Automation Software For Small Business Compared

Compare Zapier and Make for small-business automation: ease of use, workflow power, integrations, pricing, and which tool fits your needs.

How AI Is Making Corporate Survival A Constant Digital Broadcast

Firmulate’s live experiment reveals how AI-driven organizations face real-time survival pressures, highlighting gaps between diagnosis and action.

A Texas Drainage District Walked Its Ditch on a Routine Inspection. They Found a Pipe They Didn’t Recognize Discharging Black Liquid From Tesla’s $1 Billion Lithium Refinery

Routine inspection revealed Tesla’s wastewater pipe discharging dark liquid into a Texas ditch, raising environmental concerns amid regulatory gaps.