A Skill Is a Folder, Not a Prompt: What Anthropic Learned Running Hundreds of Them

📊 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 demonstrated that building AI skills as folders containing instructions, scripts, and assets leads to more durable, reusable, and effective organizational capabilities. This approach shifts the focus from prompts to structured containers, improving consistency and onboarding.

Anthropic has announced that its AI Skills are structured as folders, not prompts, a shift that enhances reusability, consistency, and institutional knowledge. This approach, derived from running hundreds of Skills internally, offers a new model for organizations deploying AI agents, making capabilities more durable and scalable.

In a recent publication, Anthropic’s Claude Code engineer outlined that a Skill is fundamentally a folder containing instructions, reference documents, scripts, templates, and configuration data, rather than a simple prompt stored in a text file. This redefinition enables AI agents to discover, read, and execute complex routines, embedding organizational knowledge directly into operational assets.

This method contrasts sharply with traditional prompt engineering, which treats prompts as ephemeral instructions. Instead, Skills serve as containers for how an organization accomplishes specific tasks, ensuring output consistency regardless of who runs the agent. They also significantly reduce onboarding time by codifying tribal knowledge and guardrails, making it accessible and automatable.

At a glance
reportWhen: published recently, with ongoing implem…
The developmentAnthropic published a detailed report on their approach to developing AI Skills as folders, sharing lessons from running hundreds of them internally.
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 Capabilities into Organizational Assets

This development matters because it shifts the paradigm from ad-hoc prompt tuning to building durable, reusable assets that encode operational knowledge. Organizations can now develop comprehensive Skills libraries that improve consistency, reduce errors, and facilitate onboarding. The approach also promotes continuous improvement, as Skills can be refined iteratively based on edge cases and real-world use.

For businesses, this means AI deployment becomes more reliable and scalable, with capabilities that evolve over time as Skills are improved. It also encourages viewing AI tools as integral parts of workflows, not just temporary prompts, unlocking new levels of automation and operational efficiency.

Amazon

AI development folder structure tools

As an affiliate, we earn on qualifying purchases.

As an affiliate, we earn on qualifying purchases.

From Prompt Engineering to Structured Asset Development

Traditionally, organizations have relied on prompt engineering—crafting specific instructions for AI models on a case-by-case basis. This approach is often brittle, requiring frequent re-tuning, and does not embed organizational knowledge or guardrails effectively.

Anthropic’s new approach, detailed in their recent publication, emphasizes creating Skills as structured folders, a concept inspired by internal practices where hundreds of such units are used to standardize workflows across engineering teams. This shift reflects a broader movement toward treating AI capabilities as assets that can be versioned, shared, and improved systematically.

“Viewing Skills as folders containing instructions and scripts fundamentally changes how organizations build and maintain AI capabilities.”

— Thorsten Meyer, AI expert

Handbook of Research on Scripting, Media Coverage, and Implementation of E-learning Training in Lms Platforms

Handbook of Research on Scripting, Media Coverage, and Implementation of E-learning Training in Lms Platforms

As an affiliate, we earn on qualifying purchases.

As an affiliate, we earn on qualifying purchases.

Unclear Aspects of Scaling and Implementation

It is not yet clear how widely adopted this approach will be outside Anthropic or how easily other organizations can replicate the process. Details about the tooling, integration, and maintenance of Skills libraries at scale remain under development. The long-term impact on AI safety, control, and adaptability also requires further observation.

Asset Protection: Pure Trust Organizations

Asset Protection: Pure Trust Organizations

As an affiliate, we earn on qualifying purchases.

As an affiliate, we earn on qualifying purchases.

Next Steps in Developing and Adopting Skills Frameworks

Organizations interested in this approach should evaluate their internal workflows and tribal knowledge to identify potential Skills. Further, there will likely be new tools and standards emerging to facilitate Skills creation, versioning, and sharing. Anthropic may also publish more detailed best practices and case studies as the approach matures.

Monitoring how other AI developers adopt this model and its impact on operational reliability will be key in the coming months.

Knowledge-Based Software Engineering: 11th Joint Conference, JCKBSE 2014, Volgograd, Russia, September 17-20, 2014. Proceedings (Communications in Computer and Information Science, 466)

Knowledge-Based Software Engineering: 11th Joint Conference, JCKBSE 2014, Volgograd, Russia, September 17-20, 2014. Proceedings (Communications in Computer and Information Science, 466)

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 performance?

It allows for more structured, comprehensive, and reusable assets that encode detailed instructions, reference material, and scripts, leading to more consistent and reliable outputs.

Can this approach be applied outside of Anthropic?

Potentially, yes. Organizations with complex workflows and tribal knowledge could benefit from structuring their AI capabilities as Skills, but implementation details and tooling are still evolving.

What are the main advantages over traditional prompt engineering?

Skills as folders enable durability, version control, easier onboarding, and continuous improvement, reducing the brittleness and ephemeral nature of prompt-based instructions.

Are there any risks or downsides to this approach?

The complexity of managing Skills libraries and ensuring proper updates and versioning could pose operational challenges. Further research is needed on scalability and safety implications.

Source: ThorstenMeyerAI.com

You May Also Like

Chuwi Minibook X: the netbook we deserve

The Chuwi Minibook X is a small, affordable Linux-compatible laptop with impressive specs for its size, sparking renewed interest in portable computing.

Postgres Transactions Are A Distributed Systems Superpower

New developments highlight how Postgres transactions are now capable of supporting distributed systems, enhancing scalability and reliability.

Self-Distillation Enables Continual Learning [pdf]

Researchers introduce Self-Distillation Fine-Tuning (SDFT), a method enabling models to learn new skills from demonstrations without forgetting previous ones.

Working around dragons with the Lemote Yeeloong laptop and OpenBSD

Exploring how enthusiasts use Lemote Yeeloong laptops with Chinese Dragon chips to run OpenBSD, highlighting challenges and significance for free computing.