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 treating Skills as folders—containing instructions, scripts, and knowledge—improves AI agent consistency and scalability. This approach shifts AI development from prompt-based tactics to reusable, institutional assets, impacting how organizations deploy AI.

Anthropic has announced a new approach to building AI agents, defining Skills as folders that contain instructions, scripts, and reference materials rather than just prompts. This shift aims to turn ad-hoc prompting into durable, reusable organizational assets, enhancing consistency and scalability in AI deployment. The revelation is based on Anthropic’s internal experience running hundreds of Skills across its engineering teams, emphasizing the importance of structured containers over simple prompt text.

According to a detailed write-up from Anthropic, a Skill is not merely a saved prompt but a comprehensive folder that can include instructions, reference documents, runnable scripts, templates, data, configuration, and hooks. This architecture allows AI agents to discover, read, and execute within these folders, making the process more robust and maintainable.

Anthropic’s internal experiments revealed that organizing Skills as folders leads to improved output consistency, easier onboarding, and cumulative improvement over time. The company emphasizes that Skills are assets that appreciate in value as they evolve, rather than static prompts or notes. They suggest that organizations could justify dedicating significant engineering effort to perfecting each Skill category, such as verification or automation, to maximize value.

Anthropic identified nine core categories of Skills, including library references, product verification, data analysis, business process automation, code scaffolding, quality review, deployment, runbooks, and infrastructure operations. The company highlights that verification Skills—those that check the work—are among the most valuable because they directly improve output quality.

From a technical standpoint, the key lesson is to avoid telling the agent what it already knows and instead focus on capturing non-obvious, specific knowledge within these folder-based Skills. The description of each Skill acts as a trigger for the agent, ensuring relevant Skills activate appropriately during tasks.

At a glance
reportWhen: published recently, based on internal A…
The developmentAnthropic published insights from running hundreds of Skills internally, showing that Skills are structured folders rather than simple prompts, enabling more durable and scalable AI workflows.
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 Folder-Based Skills

This development matters because it shifts the paradigm from ephemeral prompt engineering to building durable, reusable organizational assets for AI. By structuring Skills as folders, organizations can achieve consistent outputs, reduce onboarding time, and create a scalable knowledge base that improves over time. This approach has the potential to make enterprise AI deployment more reliable and efficient, moving beyond ad-hoc prompts to systematic, versioned assets.

For businesses, adopting this model could mean more predictable AI behavior and easier integration of AI into operational workflows, ultimately reducing costs and increasing trust in AI systems.

Create a Podcast with AI (No Experience Needed) : A Step-by-Step Guide to Planning, Scripting, Recording, Editing, and Launching a Podcast Using ChatGPT, AI Tools, and Automation

Create a Podcast with AI (No Experience Needed) : A Step-by-Step Guide to Planning, Scripting, Recording, Editing, and Launching a Podcast Using ChatGPT, AI Tools, and Automation

As an affiliate, we earn on qualifying purchases.

As an affiliate, we earn on qualifying purchases.

Internal Practices Drive New AI Skill Architecture

Historically, AI teams have relied on prompts—short text instructions—to guide models. However, Anthropic’s recent internal experiments have demonstrated that organizing instructions, scripts, and knowledge into folders—termed Skills—creates a more effective and maintainable system.

This approach emerged from Anthropic’s experience running hundreds of Skills, which revealed that structured containers improve consistency and allow for cumulative refinement. The concept aligns with broader industry trends toward modular, reusable AI components, but Anthropic’s emphasis on the folder structure as an organizational asset is novel.

The company’s detailed write-up frames Skills as a way to codify tribal knowledge, guardrails, and procedures, making them accessible and executable by AI agents. This development is part of a broader move to institutionalize AI best practices within organizations.

“Treating Skills as folders containing instructions, scripts, and knowledge fundamentally changes how we design, deploy, and maintain AI agents.”

— Thorsten Meyer, AI researcher at Anthropic

YvnShine 50 Pack Job Folder for Project Management, Heavy Duty Manila File Jacket 10x12 Inch, Preprinted Cost Tracking & Invoice Organization, Construction Project Management Files 

YvnShine 50 Pack Job Folder for Project Management, Heavy Duty Manila File Jacket 10×12 Inch, Preprinted Cost Tracking & Invoice Organization, Construction Project Management Files 

COMPREHENSIVE PROJECT MANAGEMENT SYSTEM: Professional manila folder designed for contractors and project managers. Organize work orders, service documentation,…

As an affiliate, we earn on qualifying purchases.

As an affiliate, we earn on qualifying purchases.

Unclear Aspects of Folder-Based Skills Implementation

It is not yet clear how broadly this approach will be adopted outside Anthropic or how easily other organizations can implement similar systems. Details about integration challenges, tooling, and scalability at larger enterprise levels remain under discussion. Additionally, the long-term impact on AI safety and consistency across diverse models 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 for Broader Adoption and Refinement

Organizations interested in this approach should begin cataloging their internal procedures into folder-based Skills, focusing on verification and automation categories. Further research and shared best practices are expected to emerge, potentially leading to standardized frameworks. Anthropic may also release tooling or guidelines to facilitate wider adoption of this architecture.

Monitoring how other AI teams experiment with and adapt this model will be key to understanding its scalability and impact on enterprise AI workflows.

Script Fonts Interlock Signmaker's Templates Kit – Letters, Symbols Router Template Sign Making Kit – Polymer Router Template Guide - Template Woodworking Creates Professional Signs w/Cursive Script

Script Fonts Interlock Signmaker's Templates Kit – Letters, Symbols Router Template Sign Making Kit – Polymer Router Template Guide – Template Woodworking Creates Professional Signs w/Cursive Script

Router Sign Making Template: Create professional-looking signs with flowing cursive lettering templates locked together with our router letter…

As an affiliate, we earn on qualifying purchases.

As an affiliate, we earn on qualifying purchases.

Key Questions

How is a Skill different from a traditional prompt?

A Skill is a structured folder containing instructions, scripts, and knowledge, whereas a prompt is a simple text instruction. Skills enable reusable, maintainable, and context-rich organizational assets.

Why does organizing Skills as folders matter?

Folders allow for bundling multiple elements—such as code, references, and configurations—making Skills more durable, scalable, and easier to update than plain prompts.

What categories of Skills did Anthropic identify?

Anthropic identified nine categories, including verification, data analysis, automation, code scaffolding, and infrastructure operations, with verification being the most impactful.

Can this approach improve AI safety and reliability?

Potentially, yes. Structured Skills can enforce guardrails, reduce variability, and ensure consistent outputs, which are important for safe and reliable AI deployment.

What are the main challenges in adopting this model?

Implementing folder-based Skills requires organizational discipline, tooling for managing and updating these assets, and integration with existing AI workflows, which may pose hurdles for some teams.

Source: ThorstenMeyerAI.com

You May Also Like

Capital: The Lever Beneath the Levers

Exploring how capital funding shapes AI development, the circular flow of investments, and the emerging risks of market fragility in 2026.

The Power Bottleneck: AI Data Centers and the Grid Cliff Approaching 2027-2028

AI data centers face a power bottleneck as grid expansion delays threaten to limit hyperscaler growth by 2027-2028, impacting AI deployment and costs.

Mistral. The fourth path.

Mistral raises $830M, becomes Europe’s strongest single-firm AI player, but still trails US leaders in capability, highlighting Europe’s strategic AI choices.

The Ghost Story Became a Forecast.

Clark’s latest essay reveals a 60% chance of AI automation by 2028, with a 40% possibility of fundamental paradigm limitations. This impacts AI research and policy.