📊 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 learned that effective AI Skills are best understood as folders containing instructions, scripts, and knowledge, not just prompts. This approach enhances consistency, onboarding, and institutional memory. The company ran hundreds of Skills internally, viewing them as assets that improve over time.

Anthropic has announced that its internal AI development team has shifted from using simple prompts to building Skills as folders containing instructions, scripts, and reference materials. This change aims to improve the consistency and durability of AI outputs, marking a significant evolution in enterprise AI practices.

The company’s recent publication describes Skills not as static prompts but as containers that hold a variety of assets — instructions, code, reference documents, and configurations. This structural approach allows the AI to discover, read, and execute inside these folders, enabling more robust and repeatable task execution.

Anthropic’s internal experiments show that building Skills as folders helps standardize outputs across different team members, simplifies onboarding by encapsulating tribal knowledge, and allows Skills to improve iteratively as they are refined over time. The company estimates that dedicating an engineer-week to perfect a Skill can yield long-term benefits, viewing Skills as assets that appreciate in value.

In their taxonomy, Anthropic identified nine categories of Skills, ranging from library references and verification to deployment and runbooks. Among these, verification Skills — which check the quality of outputs — are considered most impactful for reducing errors.

At a glance
reportWhen: published March 2024
The developmentAnthropic published insights from its internal use of Skills, emphasizing that Skills are folders, not prompts, to improve AI agent reliability and organizational knowledge management.
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 towards systematic, reusable knowledge assets in enterprise AI. By framing Skills as folders, organizations can embed tribal knowledge and standard operating procedures directly into their AI systems, leading to more consistent, reliable outputs. It also reduces reliance on ad-hoc prompting, which can be error-prone and hard to maintain.

For businesses, this approach offers a pathway to scale AI capabilities across teams, improve onboarding efficiency, and create a library of institutional memory that evolves with the organization. The emphasis on continuous improvement of Skills aligns with the broader trend of making AI systems more trustworthy and manageable.

Amazon

AI development folder templates

As an affiliate, we earn on qualifying purchases.

As an affiliate, we earn on qualifying purchases.

From Prompts to Asset-Based AI Strategies

Until now, most teams using AI coding agents relied on repeatedly crafting and refining prompts, which are often fragile and difficult to scale. Anthropic’s internal experience demonstrates that treating Skills as modular, reusable assets can transform this process. Their approach builds on prior efforts to improve prompt engineering but moves toward a structured, asset-based framework.

Anthropic’s publication reflects a broader industry interest in organizing knowledge and automating complex workflows through AI. The company’s taxonomy of Skills into nine categories provides a blueprint for other organizations seeking to formalize their AI practices and reduce operational risks.

While the concept of Skills as folders is new in this context, it echoes broader trends in software engineering that favor modularity and version control. The key difference is applying these principles directly to AI agent behavior and knowledge management.

“Skills are not just prompts; they are folders containing instructions, scripts, and reference materials that make AI behavior more reliable and maintainable.”

— Thorsten Meyer, AI researcher at Anthropic

Amazon

enterprise knowledge management tools

As an affiliate, we earn on qualifying purchases.

As an affiliate, we earn on qualifying purchases.

Unclear Aspects of Skills Implementation and Adoption

It is not yet clear how widely other organizations will adopt this folder-based approach or how it scales in different contexts. The long-term impact on AI reliability and maintenance costs remains to be validated outside Anthropic’s internal environment. Additionally, the specifics of integrating Skills into existing workflows and tools are still under development, and industry-wide best practices are evolving.

Amazon

AI instruction scripts software

As an affiliate, we earn on qualifying purchases.

As an affiliate, we earn on qualifying purchases.

Next Steps for Broader Adoption and Development

Anthropic plans to further refine its Skills framework and share more detailed implementation guidelines. Other organizations are likely to experiment with similar asset-based methods, potentially leading to industry standards. Monitoring how Skills evolve and influence AI reliability and operational efficiency will be crucial, along with assessing integration with existing enterprise systems.

In the near term, expect more case studies and tooling support aimed at making Skills a core component of enterprise AI deployment strategies.

Amazon

AI verification tools

As an affiliate, we earn on qualifying purchases.

As an affiliate, we earn on qualifying purchases.

Key Questions

How does a Skill differ from a prompt?

A Skill is a folder containing instructions, scripts, and reference materials, making it a durable asset. A prompt is just a text instruction that can be fragile and ephemeral.

Why are Skills considered an asset rather than just instructions?

Skills encapsulate tribal knowledge, guardrails, and tools, enabling consistent and reliable outputs. They can be refined over time and serve as a record of organizational procedures.

What are the main categories of Skills identified by Anthropic?

Anthropic categorizes Skills into nine types, including library references, verification, data analysis, automation, code scaffolding, review, deployment, runbooks, and infrastructure operations.

What are the challenges in implementing Skills as folders?

Key challenges include designing effective trigger descriptions, managing versioning, and integrating Skills into existing workflows. Adoption outside Anthropic’s environment remains untested.

Will this approach reduce AI errors and improve reliability?

Initial internal results suggest that Skills focused on verification significantly reduce errors, but broader validation is needed to confirm long-term benefits.

Source: ThorstenMeyerAI.com

This content is for general information only and is not financial, tax or legal advice. Consult a qualified professional for decisions about your money.
You May Also Like

Vending Card Reader Retrofits Work Best With the Right Connectivity Strategy

Just choosing the right connectivity strategy is crucial for optimal vending card reader retrofits—discover how to keep your system secure and reliable.

AI and Machine Learning in Fraud Prevention for Payment Systems

With AI and machine learning transforming fraud prevention in payment systems, discover how these innovations are reshaping security and what it means for your transactions.

How Smart Retry Logic Improves Subscription Collections

Greatly enhancing subscription collection success, smart retry logic offers innovative strategies to turn payment failures into retention opportunities—discover how inside.