📊 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 prompts to a folder-based approach for AI Skills, enhancing consistency, onboarding, and institutional memory. This method transforms ad-hoc prompts into durable organizational assets.

Anthropic has announced a new approach to building AI Skills, defining them as folders that contain instructions, scripts, and assets rather than simple prompts. This shift aims to create durable, reusable units that improve consistency and institutional knowledge within AI systems, according to a detailed internal write-up. This development matters because it suggests a fundamental change in how organizations can embed operational procedures into AI agents, moving beyond ad-hoc prompting to structured, versioned assets.

In a recent publication, Anthropic detailed its experience of running hundreds of Skills internally, framing them as comprehensive folders rather than static prompts. Each Skill folder can include instructions, reference documents, executable scripts, templates, data, configuration, and hooks that activate during operation. This structure allows AI agents to discover, read, and execute content within the folder, making Skills more akin to organizational assets than simple prompts.

This approach addresses key issues in AI deployment: it ensures output consistency across different users and roles, accelerates onboarding by encapsulating tribal knowledge, and allows Skills to evolve and improve over time through iteration. Anthropic emphasizes that investing engineering effort into refining Skills can yield long-term benefits, with teams dedicating engineer-weeks to perfect specific Skills, viewing them as appreciating assets rather than costs.

At a glance
reportWhen: published March 2024
The developmentAnthropic published insights from running hundreds of Skills internally, redefining Skills as folders containing instructions, scripts, and assets, not just prompts.
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 Organizational AI Deployment

This development signifies a shift toward more durable and scalable AI systems within organizations. By structuring Skills as folders containing all necessary knowledge and tools, companies can embed operational procedures, guardrails, and best practices directly into their AI agents. This enhances output reliability, reduces onboarding time, and creates a living repository of institutional knowledge that improves over time. For businesses, this approach could lead to more predictable AI performance and easier management of complex workflows.

Your Company Mandated AI: Instructions Not Provided

Your Company Mandated AI: Instructions Not Provided

As an affiliate, we earn on qualifying purchases.

As an affiliate, we earn on qualifying purchases.

From Prompt Engineering to Asset Building

Until now, many teams have relied on prompt engineering—crafting specific instructions each time they use AI models. Anthropic’s internal experiments revealed that this ad-hoc method is limited in scalability and consistency. Their new approach of creating Skills as folders represents a significant evolution, aiming to institutionalize knowledge and procedures within AI systems. This aligns with broader industry trends toward modular, reusable AI components and operational automation.

Anthropic’s insights come after extensive internal testing, where Skills were developed, refined, and categorized into nine types, from reference materials to operational runbooks. The company highlights verification Skills as the most valuable, since they catch errors and improve output quality. This reflects a focus on quality assurance and error prevention as core benefits of the folder-based approach.

“A Skill is not just a prompt saved in a file; it’s a folder that contains everything needed to perform a task reliably and consistently.”

— Thorsten Meyer, AI researcher at Anthropic

Amazon

AI scripting and asset organization software

As an affiliate, we earn on qualifying purchases.

As an affiliate, we earn on qualifying purchases.

Unclear Aspects of the Folder-Based Skills Model

It is not yet clear how widely this approach will be adopted outside Anthropic or how easily other organizations can implement similar systems. Details about integration with existing workflows, tooling, and the scalability of managing large Skills libraries remain to be seen. Additionally, the impact on AI model training and maintenance processes is still evolving, and the long-term effectiveness of this method is under observation.

Ebay Auction Templates Starter Kit

Ebay Auction Templates Starter Kit

Used Book in Good Condition

As an affiliate, we earn on qualifying purchases.

As an affiliate, we earn on qualifying purchases.

Next Steps for Industry Adoption and Development

Organizations interested in this approach will likely experiment with creating their own Skills folders, focusing on automating and standardizing procedures. Industry-wide, we can expect further research and case studies on the effectiveness of folder-based Skills, as well as the development of tools to facilitate their creation, management, and versioning. Anthropic may also continue refining its methodology and share more insights on best practices and integration strategies.

AI for Bookkeeping Automation and Workflows: Automate Data Entry, Receipts, Categorization, Reconciliation, and Month-End Reporting Using AI and No-Code Tools, Save Hours Every Week for Bookkeepers

AI for Bookkeeping Automation and Workflows: Automate Data Entry, Receipts, Categorization, Reconciliation, and Month-End Reporting Using AI and No-Code Tools, Save Hours Every Week for Bookkeepers

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, scripts, and knowledge within a structured folder, Skills ensure that AI agents follow the same procedures, reducing variability and errors across different users and roles.

Can this approach be applied outside of AI coding agents?

Yes, any organizational process that benefits from standardization and institutional memory could potentially adopt folder-based Skills, including operational workflows, customer support, and compliance procedures.

What challenges might organizations face in implementing folder-based Skills?

Challenges include managing version control, integrating with existing systems, and developing the tooling needed to create, discover, and update Skills efficiently.

Will this method replace prompt engineering entirely?

Not necessarily; it offers a more structured, durable alternative for complex or critical workflows, but prompts will still be useful for ad-hoc or simple tasks.

Source: ThorstenMeyerAI.com

You May Also Like

Vibe Coding in Large-Scale Projects: Strategies and Pitfalls

Practicing vibe coding in large-scale projects requires strategic approaches and awareness of common pitfalls to ensure success.

The Safari MCP Server For Web Developers

Apple introduces the Safari MCP server, a new tool for web developers to improve testing and deployment of web applications.

Quantum Computing 101 for Developers: Q# and Qiskit Intro

For developers eager to unlock quantum potential, this intro to Q# and Qiskit reveals essential concepts that will transform your understanding of the future of computing.

World Model Readiness: Are You Ready for AI That Acts?

An emerging diagnostic tool evaluates organizations’ preparedness for AI systems that predict and act, marking a shift from language models to world models.