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 successful AI capabilities are best understood as ‘Skills’—comprehensive folders with instructions and tools—rather than simple prompts. This approach enhances consistency, onboarding, and long-term improvement in AI operations.

Anthropic has revealed that its approach to building AI capabilities involves packaging knowledge into ‘Skills’—not just prompts, but folders containing instructions, scripts, and reference materials. This shift aims to create durable, reusable organizational assets that improve AI output consistency and streamline onboarding, marking a significant departure from traditional prompt engineering.

In a detailed write-up from a Claude Code engineer, Anthropic explains that a Skill is not merely a saved prompt, but a folder that can include instructions, reference documents, runnable scripts, templates, data, configuration, and hooks. The agent can discover, read, and execute the contents of these folders, making Skills a container for operational knowledge rather than a static prompt.

This approach transforms prompt engineering into a durable institutional capability. It enables organizations to standardize output, automate complex workflows, and capture tribal knowledge in a reusable format. Anthropic emphasizes that a Skills library is an appreciating asset, improving over time as it is refined through edge cases and feedback.

Anthropic identified nine core categories of Skills, ranging from library references and product verification to infrastructure operations. The most valuable, according to their analysis, is verification—ensuring the AI’s outputs are correct—because it directly impacts output quality and safety. Building high-quality Skills in these categories can significantly improve organizational AI performance.

At a glance
reportWhen: published March 2024
The developmentAnthropic published a detailed analysis showing that organizing AI ‘Skills’ as folders with instructions and assets improves organizational consistency and knowledge retention.
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 Development and Business Operations

This approach signals a shift in how organizations develop and maintain AI systems, emphasizing reusable, versioned assets over ad-hoc prompts. It enables better consistency, reduces onboarding time, and creates a long-term knowledge base that improves with use. For businesses, this means AI can become a more reliable and integral part of workflows, with capabilities that evolve systematically rather than through repeated prompt tuning.

Moreover, by framing Skills as containers for operational knowledge, companies can embed tribal knowledge, guardrails, and best practices directly into their AI systems, reducing errors and increasing trustworthiness. The focus on verification Skills highlights the importance of quality control in AI deployment—an area that has historically been challenging to standardize.

Amazon

AI development instruction folders

As an affiliate, we earn on qualifying purchases.

As an affiliate, we earn on qualifying purchases.

From Prompt Engineering to Institutional Asset

Traditional prompt engineering often involves crafting specific instructions for each task, which can be fragile and hard to scale. Prior to this, many teams relied on manual prompt tuning, reusing prompts with little structure or version control.

Anthropic’s internal experiments with Skills began as a way to codify tribal knowledge and operational procedures. The concept evolved into a systematic approach where Skills are cataloged, refined, and reused across projects, leading to more predictable and reliable AI outputs. The idea aligns with broader trends toward modular, reusable components in software engineering.

“A Skill is a folder—containing instructions, scripts, and assets—not just a prompt. This fundamentally changes how organizations design and deploy AI capabilities.”

— Thorsten Meyer, AI researcher

Amazon

AI scripting and reference materials

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 organizations will adopt this approach or how it will scale across different industries. Details about the practical challenges of creating, maintaining, and updating Skills at large scale remain under discussion. Additionally, the impact on existing workflows and prompt engineering practices is still being evaluated.

AI for Bookkeeping Automation and Workflows: Automate Data Entry, Receipts, Categorization, Reconciliation, and Month-End Reporting Using AI and No-Code Tools, Save Hours Every Week for Bookkeepers

AI for Bookkeeping Automation and Workflows: Automate Data Entry, Receipts, Categorization, Reconciliation, and Month-End Reporting Using AI and No-Code Tools, Save Hours Every Week for Bookkeepers

As an affiliate, we earn on qualifying purchases.

As an affiliate, we earn on qualifying purchases.

Next Steps in Skills Development and Industry Adoption

Organizations are expected to experiment with building their own Skills libraries based on Anthropic’s framework. Future developments may include tooling for easier creation, version control, and sharing of Skills across teams. Industry-wide adoption could lead to new standards for AI operational assets, with further research on best practices and automation.

Artificial Intelligence Safety and Security (Chapman & Hall/CRC Artificial Intelligence and Robotics Series)

Artificial Intelligence Safety and Security (Chapman & Hall/CRC Artificial Intelligence and Robotics Series)

As an affiliate, we earn on qualifying purchases.

As an affiliate, we earn on qualifying purchases.

Key Questions

How does a Skill differ from traditional prompt engineering?

A Skill is a structured folder containing instructions, scripts, and reference materials, rather than a simple text prompt. It enables reusable, versioned, and context-rich assets for AI tasks.

What benefits does organizing Skills as folders provide?

It improves output consistency, simplifies onboarding, captures tribal knowledge, and allows continuous refinement of operational procedures.

Will this approach work for all types of AI tasks?

While promising, the effectiveness of Skills depends on the task complexity and organizational context. Adoption is likely to be gradual and tailored to specific workflows.

What challenges might organizations face in implementing Skills?

Creating comprehensive, maintainable Skills libraries requires effort, discipline, and tooling support. Scaling updates and ensuring alignment across teams can also be difficult.

Is this approach specific to Anthropic’s models or applicable broadly?

While developed by Anthropic, the concept of Skills as structured assets could be adapted for other AI systems, depending on technical compatibility and organizational needs.

Source: ThorstenMeyerAI.com

You May Also Like

7 Best Graphics Card Prime Day Deals for PC Upgrades in 2026

Discover the best graphics card deals for PC upgrades during Prime Day 2026, including top picks for performance, value, and compact builds.

The Local-First Agentic Operator

A single operator, using agentic AI, has built an 18-product portfolio across diverse domains, challenging traditional organizational needs.

So many employees have booked time off for GTA 6, that one company is having an ‘operational pause’ on November 19

A company is pausing operations on November 19 after many employees booked time off for GTA 6 release, highlighting widespread anticipation.

The High-End PC And Workstation Tax

Memory prices surge in 2026, making high-end PC and workstation building more expensive and challenging for DIY builders, with supply constraints and market volatility.