📊 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 comprehensive folders, not prompts, enhances consistency, onboarding, and institutional knowledge. This approach is being adopted internally and offers a new model for enterprise AI workflows.

Anthropic has disclosed that its internal use of AI Skills involves packaging complex knowledge and procedures into folders containing instructions, scripts, and assets, rather than simple prompts. This shift aims to create durable, reusable organizational capabilities that improve consistency and onboarding across teams.

According to a detailed write-up from an Anthropic engineer, a Skill is not just a saved prompt but a folder that can include instructions, reference documents, scripts, templates, data, and configuration. The agent can discover and execute these components, making the process more structured and reliable.

This approach transforms ad-hoc prompting into a standard operating procedure, versioned and shared across the organization. Anthropic’s internal testing shows that Skills improve output consistency, reduce onboarding time, and accumulate value as they are refined over time. The company has identified nine core categories of Skills, ranging from library references to operational runbooks, with verification Skills deemed most critical for quality control.

At a glance
reportWhen: published March 2024
The developmentAnthropic published insights from running hundreds of AI Skills as folders, showing a shift from prompts to structured, reusable assets for organizational AI applications.
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-Driven Organizational Processes

This development signals a shift from simple prompt engineering to creating robust, reusable AI assets that embed institutional knowledge and guardrails. For organizations, this means more reliable AI outputs, faster onboarding, and a scalable way to capture tribal knowledge. It also suggests a move toward formalizing AI workflows as shared assets, potentially transforming enterprise AI management and operational standards.

Amazon

AI development folder structure

As an affiliate, we earn on qualifying purchases.

As an affiliate, we earn on qualifying purchases.

Background on Skills Development and Use

Traditionally, AI teams have relied on iterative prompt tuning, often reusing prompts without structure. Anthropic’s recent publication emphasizes that their internal approach treats Skills as comprehensive containers, enabling more consistent and maintainable AI behavior. This methodology aligns with broader industry trends toward modular AI components but emphasizes formalized, versioned assets rather than ad-hoc prompts. The concept builds on prior efforts to codify AI best practices but advances it by framing Skills as organizational tools akin to software assets.

“A Skill is a folder — one that can contain instructions, reference documents, scripts, templates, data, and configuration, making it a durable organizational asset.”

— Thorsten Meyer, AI researcher

Amazon

enterprise AI workflow tools

As an affiliate, we earn on qualifying purchases.

As an affiliate, we earn on qualifying purchases.

Unanswered Questions About Skill Scalability

It is not yet clear how widely this folder-based approach will be adopted outside Anthropic or how it will scale across different organizations and AI use cases. Details on how Skills are maintained, updated, and governed over time remain to be seen, as well as how this approach integrates with existing enterprise workflows and tools.

Amazon

AI scripting and reference assets

As an affiliate, we earn on qualifying purchases.

As an affiliate, we earn on qualifying purchases.

Next Steps for Broader Adoption and Validation

Organizations interested in this approach will likely experiment with creating their own Skills as folders, testing their impact on consistency and onboarding. Industry observers will watch for case studies and benchmarks demonstrating the effectiveness of this method. Additionally, AI platform providers may incorporate folder-based Skills into their offerings, formalizing this paradigm shift.

Amazon

AI project version control software

As an affiliate, we earn on qualifying purchases.

As an affiliate, we earn on qualifying purchases.

Key Questions

How does packaging Skills as folders improve AI performance?

Folders consolidate instructions, reference data, and scripts, enabling the AI to access structured, context-rich assets, leading to more consistent and reliable outputs.

Can this approach replace prompt engineering entirely?

While it significantly enhances robustness and reuse, prompt engineering remains useful for quick, ad-hoc tasks. The folder approach aims to formalize and scale organizational capabilities.

What categories of Skills did Anthropic identify?

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

What are the main benefits of Skills as folders for businesses?

Benefits include improved output consistency, faster onboarding, capturing tribal knowledge, and creating an organized, versioned asset library that evolves with the organization’s needs.

Will this approach work with all AI models and platforms?

It is still uncertain how universally applicable this method will be, but its principles can be adapted to various enterprise AI environments seeking structured, maintainable workflows.

Source: ThorstenMeyerAI.com

You May Also Like

Multivariate Analysis of Variance (MANOVA) Explained

A comprehensive explanation of MANOVA reveals how this powerful statistical tool compares multiple outcomes across groups, prompting further exploration.

Structural Equation Modeling: Everything You Need to Know

Investigate how SEM unifies factor analysis and regression to unlock complex relationships—discover why it’s essential for your research.

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

Assess your organization’s readiness for AI systems capable of predicting and acting, as world models become the next frontier in AI development.

Owning Mistral Forge: The Key To Greater AI Flexibility And Control

Mistral announced Forge at Nvidia GTC 2026, offering organizations the ability to own and train their own AI models for greater control and sovereignty.