📊 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 organizing AI capabilities as folders—called Skills—enables more durable, consistent, and scalable agent behavior. This approach shifts away from simple prompts to a container-based model, improving organizational knowledge transfer and automation.

Anthropic has announced that effective AI Skills are best conceptualized as folders—comprehensive containers of instructions, scripts, and data—rather than simple prompts. This insight emerged from their experience running hundreds of Skills internally, revealing a new paradigm for building durable, scalable AI capabilities that can be shared and reused across organizations. This development matters because it shifts the way companies design, deploy, and maintain AI agents, emphasizing structured, asset-based approaches over ad-hoc prompting.

According to a detailed write-up from an Anthropic engineer, a Skill is not just a prompt saved as text, but a folder that can contain instructions, reference documents, scripts, templates, configuration files, and hooks. The agent can discover and read these folders, executing the contained assets to perform complex tasks reliably. This reframing changes how technical teams develop AI behaviors and how organizations institutionalize their knowledge.

Anthropic highlights that this approach makes agent output more consistent, simplifies onboarding by encapsulating tribal knowledge, and allows Skills to improve over time as they are refined through usage. The company has cataloged its internal Skills into nine categories—ranging from library references to operational runbooks—and finds that focusing on verification Skills yields the greatest quality improvements.

The core lesson is that a well-designed Skill leverages real code and specific instructions, especially in the ‘Gotchas’ section, to prevent common errors, such as silent failures or mismatched data fields. The description of each Skill acts as a trigger, ensuring the agent activates the correct container based on user requests.

At a glance
reportWhen: published recently, based on Anthropic’…
The developmentAnthropic shared insights from running hundreds of Skills internally, showing that Skills are best understood as folders containing instructions, scripts, and assets, not just 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

Transforming AI Development with Containerized Skills

This shift from prompt-based to folder-based Skills represents a fundamental change in how organizations develop and maintain AI capabilities. It enables more durable, shareable, and scalable institutional knowledge, reducing reliance on ad-hoc prompts and enabling automation of complex workflows. Companies can justify investing significant engineering effort into perfecting Skills, knowing they become assets that improve over time and across teams.

By framing Skills as comprehensive containers, organizations can standardize outputs, accelerate onboarding, and build a library of reusable components. This approach also supports continuous improvement, as Skills evolve with usage, leading to higher quality and more reliable AI systems.

Claude AI for Beginners Bible: [5 in 1] The Ultimate Guide to Automate Your Work, Save Hours Every Week, and Use AI for Real-World Results

Claude AI for Beginners Bible: [5 in 1] The Ultimate Guide to Automate Your Work, Save Hours Every Week, and Use AI for Real-World Results

As an affiliate, we earn on qualifying purchases.

As an affiliate, we earn on qualifying purchases.

From Prompt Engineering to Asset-Based AI Strategies

Prior to this development, the common approach in AI development involved crafting prompts that elicited desired behaviors. However, prompts are fragile, context-dependent, and hard to maintain at scale. Anthropic’s internal experience running hundreds of Skills revealed that a container-based approach offers a more robust and manageable solution.

This insight aligns with broader trends in AI engineering, emphasizing modularity, version control, and institutional memory. The concept of Skills as folders builds on existing practices in software development, such as code repositories and configuration management, adapted for AI agent behaviors.

Anthropic’s nine-category Skills map provides a framework for organizations to identify gaps and prioritize investments—especially in verification, data handling, and operational procedures—highlighting the importance of structured, asset-based design.

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

— Thorsten Meyer, AI researcher at Anthropic

Express Schedule Free Employee Scheduling Software [PC/Mac Download]

Express Schedule Free Employee Scheduling Software [PC/Mac Download]

Simple shift planning via an easy drag & drop interface

As an affiliate, we earn on qualifying purchases.

As an affiliate, we earn on qualifying purchases.

Uncertainties in Implementing Folder-Based Skills

While Anthropic’s internal experience demonstrates promising results, it is not yet clear how broadly applicable this approach is across different industries or AI systems. Details about the specific technical challenges in managing large Skills libraries, or how organizations can best structure their folders, remain under discussion. Additionally, the long-term impact on AI maintenance and evolution is still being evaluated.

The AI Workshop: The Complete Beginner's Guide to AI: Your A-Z Guide to Mastering Artificial Intelligence for Life, Work, and Business—No Coding Required (THE AI WORKSHOP by Milo Foster Book 1)

The AI Workshop: The Complete Beginner's Guide to AI: Your A-Z Guide to Mastering Artificial Intelligence for Life, Work, and Business—No Coding Required (THE AI WORKSHOP by Milo Foster Book 1)

As an affiliate, we earn on qualifying purchases.

As an affiliate, we earn on qualifying purchases.

Next Steps for Organizations Adopting Skills Frameworks

Organizations interested in this approach should begin by cataloging their existing knowledge and workflows into structured folders, focusing on verification and operational Skills first. Further research and development are expected to refine best practices for organizing, versioning, and scaling Skills. Anthropic and other AI developers may release tools to facilitate this transition, and industry-wide standards could emerge to support broader adoption.

Knowledge Engineering: Unifying Knowledge Base and Database Design (Artificial Intelligence)

Knowledge Engineering: Unifying Knowledge Base and Database Design (Artificial Intelligence)

Used Book in Good Condition

As an affiliate, we earn on qualifying purchases.

As an affiliate, we earn on qualifying purchases.

Key Questions

How does a Skill differ from a prompt?

A Skill is a folder containing instructions, scripts, and assets that enable consistent and scalable AI behaviors, whereas a prompt is a simple text instruction that can be fragile and context-dependent.

Why is organizing Skills as folders more effective?

Folders allow encapsulating tribal knowledge, configuration, and code, making AI behaviors more durable, shareable, and easier to update across teams and workflows.

What are the main categories of Skills identified by Anthropic?

The nine categories include library references, product verification, data analysis, business automation, code scaffolding, review, deployment, runbooks, and infrastructure operations.

What are the challenges in adopting this Skills approach?

Key challenges include structuring and managing large libraries of Skills, ensuring accurate trigger descriptions, and integrating this model into existing workflows and tools.

Source: ThorstenMeyerAI.com

You May Also Like

Micro-agency Proposal Scope Checker

A new AI-powered tool for small web agencies to review and flag scope risks in fixed-scope proposals is being tested as a first step toward reducing margin loss.

IEEE Rolls Out Large Language Models Training Course

IEEE has announced a new training course focused on the development and deployment of large language models, aimed at professionals and researchers.

60% Fable Cost Cut By Converting Code To Images And Having The Model OCR It

Fable cuts development costs by 60% by converting code into images and employing OCR for processing, streamlining their workflow.

Single Digits: The April That Closed the Open-Weight Gap

The benchmark gap between open and closed AI models has fallen to single digits, reshaping enterprise AI economics and strategy in April 2026.