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 ‘Skills’ in AI systems are best understood as folders containing instructions, scripts, and assets, not simple prompts. This approach enhances consistency, onboarding, and institutional knowledge. The company ran hundreds of Skills internally, emphasizing their value as reusable, evolving assets.

Anthropic has revealed that its internal AI development approach treats Skills as folders containing instructions, reference documents, scripts, and configuration, rather than simple prompts. This redefinition aims to create durable, reusable organizational assets that improve AI consistency and efficiency, marking a significant shift in how enterprise AI systems are built and maintained.

According to a detailed write-up from a Claude Code engineer, Skills are conceptualized as folders that bundle instructions, scripts, data, and hooks, allowing AI agents to discover and execute complex workflows. This approach moves away from the common practice of reusing prompts, instead creating structured containers that encode tribal knowledge, guardrails, and operational procedures. Anthropic’s internal experience shows that deploying hundreds of Skills across its teams has improved output consistency, simplified onboarding, and allowed Skills to evolve through continuous refinement. The company has identified nine key categories of Skills, ranging from library references to infrastructure operations, with verification Skills deemed most impactful for quality assurance. The core lesson is that effective Skills are those that push the model off its defaults by capturing non-obvious, organization-specific knowledge and including precise trigger descriptions for activation. This methodology transforms ad-hoc prompting into a standardized, versioned, and sharable institutional capability.
At a glance
reportWhen: published March 2024
The developmentAnthropic published insights from its internal use of Skills, showing they are folders containing instructions, scripts, and assets rather than prompts, transforming how organizations deploy AI.
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

Why Reframing Skills as Folders Matters for AI Deployment

This shift from prompts to folder-based Skills represents a fundamental change in enterprise AI management. It enables organizations to create consistent outputs across teams, streamlines training and onboarding by encapsulating tribal knowledge, and fosters continuous improvement as Skills evolve. By treating Skills as assets that can be versioned, shared, and refined, companies can build more reliable and scalable AI systems. For businesses, this approach reduces reliance on ad-hoc prompts and manual adjustments, leading to more predictable and maintainable AI workflows.

Amazon

AI development instruction management software

As an affiliate, we earn on qualifying purchases.

As an affiliate, we earn on qualifying purchases.

Internal Adoption of Skills Reflects Broader Industry Trends

Anthropic’s internal use of Skills emerged from its efforts to improve AI reliability and operational efficiency. The company identified nine categories of Skills, from code scaffolding to operational runbooks, emphasizing their role in automating complex workflows and quality control. This approach aligns with broader industry movements toward modular, reusable AI components that can be versioned and shared across teams. Previously, many organizations relied on static prompts or scripts; Anthropic’s experience suggests that encapsulating tribal knowledge in structured folders is a more durable and scalable strategy, especially as AI systems grow more complex.

“Skills are not just prompts—they are folders containing instructions, scripts, and assets that can be discovered and executed by our agents.”

— Thorsten Meyer, AI engineer at Anthropic

Amazon

AI scripting and asset organization tools

As an affiliate, we earn on qualifying purchases.

As an affiliate, we earn on qualifying purchases.

Unclear How Skills Will Scale Across Different Organizations

While Anthropic’s internal experience demonstrates the benefits of folder-based Skills, it is not yet clear how easily other organizations can adopt this approach or how it scales in different operational contexts. The specifics of implementing and maintaining such Skills across large, diverse teams remain to be seen.

Amazon

enterprise AI workflow automation tools

As an affiliate, we earn on qualifying purchases.

As an affiliate, we earn on qualifying purchases.

Next Steps for Broader Adoption and Standardization

Organizations interested in this approach should begin cataloging their internal procedures as Skills, focusing on capturing tribal knowledge and guardrails. Further research and case studies are expected to clarify best practices for scaling this methodology, as well as tools to facilitate the creation, versioning, and sharing of Skills across enterprise AI systems.

Amazon

AI knowledge base and asset management

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 folder containing instructions, scripts, reference documents, data, and hooks that an AI agent can discover and execute, serving as a reusable organizational asset.

How does this approach improve AI performance?

It enhances consistency, reduces onboarding time, and allows continuous refinement of operational procedures, leading to more reliable and scalable AI systems.

Can other companies implement this Skills methodology?

While promising, adoption depends on organizational capacity to catalog procedures as structured folders. Further industry testing is needed to determine scalability and best practices.

What is the most impactful category of Skills according to Anthropic?

Verification Skills, which check and validate outputs, are considered most impactful for improving AI quality and safety.

Source: ThorstenMeyerAI.com

You May Also Like

Grammy CEO Takes Stance: No AI Creativity Awards

As the CEO of the Recording Academy, I have firmly supported the…

How Does AI Boost Manufacturing Industry Productivity?

Are you ready to see the manufacturing industry reach new heights? Brace…

Discover Your Perfect AI Solution for Enhanced Customer Experiences

At AI Solutions, our aim is to assist you in discovering the…

Maximize Business Growth With Predictive Analytics

Is your business ready to unlock its maximum potential? We, as experts…