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.

Prime Big Deal Days · Oct 6–7Offer from Amazon

Get smart everyday buys delivered free — and shop member deals

  • Fast, free delivery on millions of items
  • Access to Prime Big Deal Days deals on October 6–7
  • Prime Video, Amazon Music and more included
Start your free Prime trial Free trial for eligible customers · Cancel anytime
As an affiliate, we earn on qualifying purchases.

TL;DR

Anthropic has demonstrated that Skills are not just prompts but comprehensive folders containing instructions, code, and resources. This approach improves consistency, onboarding, and institutional knowledge in AI agent deployment, marking a shift in how organizations manage AI workflows.

Anthropic has announced a significant shift in how organizations should design AI agents, emphasizing that Skills are folders containing instructions, scripts, and resources, rather than mere prompts. This insight, drawn from their internal experience running hundreds of Skills, aims to make AI outputs more consistent, scalable, and easier to onboard. The revelation underscores a move toward institutionalizing AI workflows as reusable, versioned assets.

Anthropic’s recent publication details a new conceptual framework: Skills are folders that bundle instructions, reference documents, executable scripts, templates, data, and configuration. This approach contrasts sharply with the common practice of saving prompts as text snippets. By treating Skills as containers, organizations can standardize processes, reduce onboarding complexity, and improve the quality and consistency of AI outputs. The company reports that its most valuable Skills focus on verification tasks—ensuring AI-generated results meet quality standards—highlighting the importance of building robust, error-catching Skills. Internally, Anthropic has categorized Skills into nine types, including API references, data analysis, automation, code scaffolding, and runbooks, which serve as comprehensive operational assets rather than ad-hoc instructions. The core lesson is that effective Skills are those that push models beyond default behavior by encoding specific, non-obvious knowledge, and that descriptions serve as triggers for matching requests to the appropriate Skills.
At a glance
reportWhen: published March 2024
The developmentAnthropic published insights from running hundreds of Skills internally, revealing that Skills are folders with instructions, scripts, and assets, not simple 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

Impact of Skills as Organizational Assets

This development signals a fundamental shift in how organizations deploy and manage AI agents. By framing Skills as folders that encapsulate all necessary knowledge and tools, companies can achieve greater consistency, reduce manual effort, and preserve institutional knowledge. This approach also enables continuous improvement, as Skills evolve with each iteration, becoming valuable assets that appreciate over time. For businesses, adopting this model can lead to more reliable AI workflows, faster onboarding, and better control over outputs, ultimately making AI a more integral and dependable part of operations.

Amazon

AI workflow management software

As an affiliate, we earn on qualifying purchases.

As an affiliate, we earn on qualifying purchases.

From Prompt Engineering to Asset Management

Until now, most AI teams relied on prompt engineering—crafting and reusing prompts to guide model outputs. This method often results in inconsistent results and requires repeated effort to adapt prompts for different situations. Anthropic’s approach, inspired by their internal experience, shifts the focus toward creating structured, reusable units—Skills—that act as containers for organizational knowledge. This aligns with broader trends in AI development emphasizing modularity, version control, and asset management, similar to software engineering practices. The insight emerged from Anthropic’s internal experiments, where they discovered that organizing instructions and assets into dedicated folders improved both reliability and scalability. The nine-category Skills map provides a framework for identifying gaps in organizational workflows, from code review to infrastructure management, emphasizing that these Skills are not static but evolve with use.

“A Skill is not just a prompt saved in a text file; it’s a folder containing instructions, scripts, and assets that the agent can discover and execute.”

— Thorsten Meyer, AI researcher at Anthropic

Amazon

AI instruction scripting tools

As an affiliate, we earn on qualifying purchases.

As an affiliate, we earn on qualifying purchases.

Unresolved Questions About Implementation

While the concept of Skills as folders is compelling, it remains unclear how broadly this approach has been adopted outside Anthropic or how easily it can be integrated into existing AI systems. Details about how organizations will manage versioning, security, and scaling of Skills are still emerging. Additionally, it is not yet confirmed whether this model will be adopted by other AI developers or how it compares in effectiveness to traditional prompt engineering in diverse real-world applications.

Amazon

AI automation and scripting platforms

As an affiliate, we earn on qualifying purchases.

As an affiliate, we earn on qualifying purchases.

Next Steps for Adoption and Development

Organizations interested in this approach should begin cataloging their internal workflows into Skills folders, focusing on high-value areas like verification and automation. Future developments may include tools for managing Skills repositories, version control, and automated updates. Anthropic is expected to publish further guidance and case studies demonstrating how other teams can implement and benefit from this model. Monitoring industry adoption will be key to understanding its impact on AI deployment practices.

Amazon

AI version control tools

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, templates, and configuration data that guide an AI agent’s behavior, making it a reusable organizational asset rather than a simple prompt.

How does treating Skills as folders improve AI workflows?

It standardizes outputs, simplifies onboarding, and allows continuous improvement by evolving Skills over time, leading to more reliable and consistent AI performance.

Can this approach be applied outside of Anthropic?

While promising, broader adoption depends on how easily organizations can integrate this model into their existing systems and workflows. Further industry validation is expected.

What are the main challenges in implementing Skills as folders?

Managing version control, security, and ensuring that Skills stay up-to-date as organizational needs evolve are potential hurdles that need addressing.

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.
FALL

Fall Picks

As an affiliate, we earn on qualifying purchases.

You May Also Like

Using AI To Streamline Scope-of-Work Reviews For B2B SaaS Agencies

AI tools now enable SMBs and mid-market firms to evaluate marketing agency proposals more effectively, reducing risks and improving decision-making.

14 AI Automation Tools That Will Change How You Work In 2026

A roundup of 14 AI automation tools that will reshape how businesses and professionals operate by 2026, highlighting key features and implications.

The United Kingdom: The Pragmatist’s Hedge

Analyzing the UK’s balanced, flexible welfare and labor policies post-Brexit amid economic shifts and AI developments.

The Nordics: Protect the Worker, Not the Job

The Nordic model emphasizes safeguarding workers over preserving jobs, fostering adaptation to automation and economic shifts. Here’s what it entails and why it matters.