📊 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 organizing AI skills as folders containing instructions, scripts, and assets leads to more durable, consistent, and reusable capabilities. This approach moves beyond simple prompts, enabling organizations to institutionalize AI workflows.

Anthropic has revealed that its internal AI capabilities, called Skills, are best understood as folders containing instructions, scripts, and assets, rather than simple prompts. You can learn more about this approach in A Skill Is a Folder, Not a Prompt. This approach aims to create durable, reusable organizational assets that improve AI consistency and operational efficiency, marking a significant shift in how AI capabilities are built and maintained.

In a detailed write-up from a Claude Code engineer, Anthropic explains that Skills are structured as folders that include instructions, reference documents, scripts, templates, and configuration data. This design allows AI agents to discover, read, and execute the contents dynamically, rather than relying on static prompts. For a deeper dive into how skills are structured and managed, see A Skill Is a Folder, Not a Prompt. This redefinition shifts the focus from prompt engineering to asset management, enabling organizations to embed tribal knowledge, guardrails, and operational procedures into AI workflows.

Anthropic emphasizes that Skills serve three core functions: ensuring output consistency, simplifying onboarding, and enabling compound learning through iterative improvements. The company has identified nine categories of Skills—ranging from library references and product verification to infrastructure operations—each addressing different organizational needs. Among these, verification Skills, which check the quality of outputs, are considered most valuable because they directly improve output accuracy.

Technical lessons highlight that effective Skills should avoid restating obvious information, instead focusing on non-obvious, organization-specific knowledge. The description of each Skill acts as a trigger for the AI, matching user requests with the appropriate folder contents, including scripts and hooks. Bundling real code and helper functions within Skills further enhances their utility and robustness.

At a glance
reportWhen: announced March 2024
The developmentAnthropic published insights from running hundreds of Skills internally, emphasizing that Skills are folders, not prompts, to improve AI consistency and reusability.
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 Infrastructure

This development signifies a move toward systematized, reusable AI capabilities that can be shared, versioned, and improved over time. By treating Skills as structured folders, organizations can better embed institutional knowledge into their AI workflows, reduce duplication, and improve consistency across teams. This approach also shifts the focus from ad-hoc prompt tuning to building robust, maintainable assets—a crucial step toward scaling AI in enterprise settings. The emphasis on verification Skills highlights the importance of output quality control, which directly impacts operational reliability and trust in AI systems.

AI Workflow Systems: AI Prompts for Freelance Consultants: Practical AI workflow prompts to automate client work, boost productivity, and scale consulting ... Frameworks for the Modern World Book 1)

AI Workflow Systems: AI Prompts for Freelance Consultants: Practical AI workflow prompts to automate client work, boost productivity, and scale consulting … Frameworks for the Modern World Book 1)

As an affiliate, we earn on qualifying purchases.

As an affiliate, we earn on qualifying purchases.

From Prompt Engineering to Asset Management

Until now, most organizations relied on prompt engineering—crafting specific instructions for each task—to guide AI outputs. However, this method often results in fragile, one-off solutions that are difficult to maintain or scale. Anthropic’s internal experience shows that packaging knowledge into structured folders with scripts and reference documents creates a more durable and scalable approach. This insight aligns with broader industry trends toward treating AI capabilities as assets that can be versioned, shared, and refined over time, similar to software components.

Anthropic’s nine-category Skills map provides a framework for organizations to identify gaps in their AI workflows, from data fetching to deployment automation. The focus on verification and operational Skills underscores the importance of building AI systems that are not only capable but also trustworthy and maintainable.

“Viewing Skills as folders transforms how organizations build, share, and improve their AI capabilities, moving beyond simple prompts to durable assets.”

— Thorsten Meyer, AI researcher

AI in Asset Management: Tools, Applications, and Frontiers

AI in Asset Management: Tools, Applications, and Frontiers

As an affiliate, we earn on qualifying purchases.

As an affiliate, we earn on qualifying purchases.

Unanswered Questions About Skills Adoption

It remains unclear how broadly organizations will adopt this folder-based approach outside of Anthropic, and what challenges they might face in integrating Skills into existing workflows. Details about the tooling, standards, and interoperability of Skills across different platforms are still emerging. Additionally, the long-term impact on AI maintenance costs and team workflows has yet to be fully evaluated.

Enhanced Living Environments: Algorithms, Architectures, Platforms, and Systems (Lecture Notes in Computer Science Book 11369)

Enhanced Living Environments: Algorithms, Architectures, Platforms, and Systems (Lecture Notes in Computer Science Book 11369)

As an affiliate, we earn on qualifying purchases.

As an affiliate, we earn on qualifying purchases.

Next Steps for Organizations Implementing Skills

Organizations interested in adopting this approach should begin by cataloging their existing knowledge assets and experimenting with packaging them into Skills folders. Developing standards for description, versioning, and script bundling will be critical. Industry-wide, expect further research and tooling support to facilitate Skills integration, along with case studies demonstrating impact on operational efficiency and output quality. Monitoring how other companies evolve their AI capabilities using this model will inform best practices.

AI Workflows for Dental Office Managers: ChatGPT Playbook to Automate Patient Scheduling, Streamline Insurance Verification, and Eliminate Administrative Burnout

AI Workflows for Dental Office Managers: ChatGPT Playbook to Automate Patient Scheduling, Streamline Insurance Verification, and Eliminate Administrative Burnout

As an affiliate, we earn on qualifying purchases.

As an affiliate, we earn on qualifying purchases.

Key Questions

What exactly is a Skill in Anthropic’s framework?

A Skill is a structured folder containing instructions, scripts, reference documents, and configuration data that define how an AI agent performs a specific task, making it a reusable organizational asset.

How does this differ from traditional prompt engineering?

Unlike prompts, which are static instructions, Skills are dynamic containers that include scripts and reference materials, enabling more consistent, maintainable, and scalable AI capabilities.

Why focus on verification Skills?

Verification Skills are considered most valuable because they directly improve the quality and reliability of AI outputs, reducing errors and increasing trust.

What are the main benefits of organizing Skills as folders?

Organizing Skills as folders enhances reusability, version control, institutional memory, and operational consistency across teams and workflows.

Will this approach be adopted widely outside Anthropic?

It is still uncertain how broadly other organizations will adopt this model, as tooling, standards, and cultural shifts are needed for widespread implementation.

Source: ThorstenMeyerAI.com

You May Also Like

Alphabet has its worst day in over a year on AI concerns after high-profile exits

Alphabet experiences its worst day in over a year amid fears over AI development following a high-profile executive departure.

Where’s My Jetpack? Why Some Futuristic Tech Predictions Haven’t Happened (Yet)

Where’s my jetpack? Discover why technological, safety, and regulatory hurdles are delaying our futuristic dreams from becoming reality.

Cloud’s Hidden Memory Bill

The cloud faces a hidden memory surcharge as prices rise due to a global memory shortage, impacting costs for cloud and on-premise users alike.

The pyramid cracks. What agentic AI does to the consulting leverage model.

Generative AI is disrupting the traditional consulting pyramid, shifting value from analysis to deployment and causing structural industry splits.