A Skill Is a Folder, Not a Prompt: What Anthropic Learned Running Hundreds of Them
AIThis post was created with the assistance of artificial intelligence (AI).

📊 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 using prompts to defining Skills as folders containing instructions, scripts, and assets. This approach enhances consistency, onboarding, and institutional knowledge in AI workflows, moving beyond simple prompt reuse.

Anthropic has announced a significant shift in how organizations should structure AI capabilities, emphasizing that Skills are folders, not prompts. This approach involves packaging instructions, scripts, and reference assets into reusable units that can be discovered and executed by AI agents. The development reflects a move away from ad-hoc prompting toward durable, institutionalized workflows, based on lessons learned from running hundreds of Skills internally.

In a detailed write-up from a Claude Code engineer, Anthropic describes Skills as folders containing instructions, reference documents, scripts, templates, data, and configuration. Unlike simple prompts, these folders serve as containers that the AI can discover, read, and execute, enabling more consistent and reliable outputs across different users and tasks. This method aims to formalize knowledge and processes within organizations, making AI-driven work more predictable and easier to onboard new team members.

Anthropic identified nine core categories of Skills, ranging from library references and code scaffolding to verification and infrastructure operations. The company emphasizes that the most valuable Skills are those that verify output quality, as they directly reduce mistakes and improve reliability. The approach also involves careful crafting of descriptions and scripts that trigger specific Skills, ensuring the AI applies the correct procedures based on context.

At a glance
reportWhen: published recently, with ongoing implem…
The developmentAnthropic published insights from running hundreds of Skills internally, demonstrating a new method of structuring AI capabilities as reusable, organized folders rather than static 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

Why Structuring Skills as Folders Changes AI Workflows

This shift from prompts to folder-based Skills offers a new paradigm for organizational AI use. It enables consistent output regardless of who operates the agent, simplifies onboarding by embedding institutional knowledge, and creates an evolving library of best practices that improve over time. For businesses, this approach reduces errors, enhances reliability, and turns ad-hoc instructions into valuable assets that appreciate in utility as they are refined.

Where AI Fits Part 1

Where AI Fits Part 1

As an affiliate, we earn on qualifying purchases.

As an affiliate, we earn on qualifying purchases.

Internal Lessons from Anthropic’s Deployment of Hundreds of Skills

Anthropic’s internal experience with deploying hundreds of Skills has revealed that categorizing and formalizing knowledge into structured folders improves AI performance and consistency. The company’s analysis identified nine key Skill categories, emphasizing verification as the most impactful. This methodology builds on the idea that AI workflows should be treated as institutional assets, not just one-off prompts, aligning with broader trends toward operationalizing AI in enterprise settings.

“Treating Skills as folders containing comprehensive instructions and assets transforms ad-hoc prompting into durable, reusable organizational routines.”

— Thorsten Meyer, AI researcher

Script Fonts Interlock Signmaker's Templates Kit for Router Signs

Script Fonts Interlock Signmaker's Templates Kit for Router Signs

  • Router Sign Making Template: Create professional signs with cursive templates
  • Perfect Letter Alignment: Interlocking templates ensure seamless flow
  • Split-Free Letter Creation: Guide bushing and two-stage routing prevent splits

As an affiliate, we earn on qualifying purchases.

As an affiliate, we earn on qualifying purchases.

Unanswered Questions About Skills Implementation and Scalability

It is not yet clear how widely adopted this folder-based Skills approach will become outside Anthropic or how it scales across different organizational sizes and industries. Details about how organizations will manage versioning, updates, and integration with existing workflows remain under development. Additionally, the long-term impact on AI performance and maintenance costs is still being evaluated.

AI-Driven Knowledge Management Assets: Strategies for the Modern Business Landscape

AI-Driven Knowledge Management Assets: Strategies for the Modern Business Landscape

As an affiliate, we earn on qualifying purchases.

As an affiliate, we earn on qualifying purchases.

Next Steps for Broader Adoption and Tool Development

Organizations interested in this approach should begin cataloging their internal processes into structured Skills, focusing on verification and automation categories. Industry groups and AI platform providers may develop tools to facilitate the creation, management, and sharing of Skills libraries. Further research and case studies are expected to emerge as more companies experiment with this model, potentially leading to standardized frameworks for organizational AI assets.

Claude AI for Beginners: 6 Books in 1: Build Apps, Create Content, Automate Work, and Make Money with AI

Claude AI for Beginners: 6 Books in 1: Build Apps, Create Content, Automate Work, and Make Money with AI

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 approach?

A Skill is a structured folder containing instructions, scripts, reference documents, and other assets that can be discovered and executed by an AI agent, transforming ad-hoc prompts into reusable organizational routines.

How does this improve AI consistency and reliability?

By encapsulating processes and knowledge into Skills, organizations ensure that the same task is performed uniformly, reducing variability caused by different operators or prompt formulations.

Can this method be applied outside of AI development teams?

Yes, any organization that relies on AI for operational workflows, automation, or decision-making can benefit from structuring their knowledge and procedures as Skills for better management and scalability.

What are the main challenges in adopting this Skills framework?

Challenges include creating comprehensive and well-described Skills, managing updates and versioning, and integrating the system into existing workflows without disrupting current operations.

Will Skills replace prompts entirely?

Skills are intended to complement prompts by providing a more durable, organized, and automated way to encode organizational knowledge, rather than replacing simple prompts in all contexts.

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

The Memory Squeeze: Why Your RAM Bill Doubled

Memory prices have surged dramatically in 2026 due to AI-driven chip reallocation, causing shortages and industry shifts. Here’s what you need to know.

10 Future AI Technologies That Will Impact 2026

A detailed look at 10 emerging AI technologies expected to shape the landscape by 2026, with confirmed developments and ongoing uncertainties.

7 Best PC Tablets for Prime Day Deals in 2026

Discover the best PC tablets on Prime Day 2026, including the Samsung Galaxy Tab S9, Surface Pro 11, and iPad 9th Gen, with detailed analysis and buying tips.

Auto Trends Highlight: Mercedes-Benz’s Large-Scale Electric Motor Production

Mercedes-Benz has started mass production of its electric axial flux motors, signaling a major shift in EV manufacturing and technology.