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 shifted its approach to AI agent design, treating Skills as folders that bundle instructions, code, and reference materials. This method enhances consistency, onboarding, and institutional knowledge. The company ran hundreds of these Skills internally, emphasizing their value as evolving assets.

Anthropic has announced that its internal AI engineering teams now treat Skills as folders containing instructions, scripts, and reference materials, rather than simple prompts. This approach aims to make AI agent outputs more consistent, improve onboarding, and capture institutional knowledge. The revelation, from a Claude Code engineer, marks a significant shift in how organizations can develop and manage AI capabilities.

In its latest publication, Anthropic describes a new framework where Skills are conceptualized as folders—containers that hold instructions, reference documents, scripts, templates, data, and configuration. These folders can be discovered, read, and executed by AI agents, creating a more durable and reusable asset than traditional prompts. This approach moves away from ad-hoc prompting, aiming to standardize and institutionalize operational procedures within organizations.

Anthropic’s internal experience shows that this method improves output consistency across different users and roles, simplifies onboarding by encapsulating tribal knowledge, and allows Skills to improve over time through iterative refinement. The company estimates that dedicating a week of engineering effort to perfect a specific Skill category can significantly enhance organizational efficiency and reliability.

The company identified nine core Skill categories, including verification, data analysis, automation, code scaffolding, and infrastructure operations. Among these, verification Skills—those that check and validate outputs—are considered the most valuable, as they directly impact output quality and error reduction.

At a glance
reportWhen: published recent write-up, ongoing impl…
The developmentAnthropic published insights from its internal use of Skills, demonstrating how treating Skills as folders improves AI agent reliability and organizational knowledge management.
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 Asset Management for Businesses

This development signals a shift toward more organized, scalable, and reliable AI deployment within companies. By treating Skills as folders that bundle all necessary knowledge and tools, organizations can standardize procedures, reduce errors, and accelerate onboarding. This approach also fosters continuous improvement, as Skills evolve through repeated use and refinement, turning them into assets that appreciate in value over time. For businesses, adopting this model could lead to more predictable AI behavior and better operational control, making AI a more integral part of daily workflows.

AI Bookkeeping Automation Prompt System: Copy-Paste Prompts, Templates, and AI Workflows to Save Time on Categorization, Reconciliation, and Reporting (AI Systems for Accountants Book 1)

AI Bookkeeping Automation Prompt System: Copy-Paste Prompts, Templates, and AI Workflows to Save Time on Categorization, Reconciliation, and Reporting (AI Systems for Accountants Book 1)

As an affiliate, we earn on qualifying purchases.

As an affiliate, we earn on qualifying purchases.

From Prompt Engineering to Asset Building

Traditionally, AI teams have relied on prompt engineering—crafting specific instructions for each task. However, this method often results in inconsistent outputs and requires repeated effort. Anthropic’s new approach, detailed in its recent publication, shifts focus toward creating modular, reusable units—Skills—that encapsulate organizational knowledge and procedural logic. This evolution aligns with broader trends in AI deployment, emphasizing reliability, scalability, and institutional memory.

Anthropic’s internal experiments with hundreds of Skills have demonstrated that this approach can significantly improve output quality and operational efficiency. The concept of Skills as folders is a response to the limitations of prompt-based methods, offering a more durable and manageable solution for enterprise AI applications.

“Treating Skills as folders containing instructions and scripts fundamentally changes how organizations can build and manage AI capabilities.”

— Thorsten Meyer, AI researcher

Agentic Spec-Driven Development: A Practical Method for Using AI to Build Complete Specifications for Software, Products, and Knowledge Work

Agentic Spec-Driven Development: A Practical Method for Using AI to Build Complete Specifications for Software, Products, and Knowledge Work

As an affiliate, we earn on qualifying purchases.

As an affiliate, we earn on qualifying purchases.

Unclear Impact and Adoption Challenges

While Anthropic’s internal results are promising, it is not yet clear how broadly this approach will be adopted outside the company or how it will perform across different industries. The scalability of maintaining large libraries of Skills, as well as integration with existing systems, remains to be seen. Additionally, the process of continuously refining Skills to keep them effective poses ongoing challenges.

Amazon

AI scripting and instruction folders

As an affiliate, we earn on qualifying purchases.

As an affiliate, we earn on qualifying purchases.

Next Steps for Broader Implementation and Validation

Anthropic plans to share more detailed methodologies and case studies demonstrating how organizations can implement Skills at scale. Industry observers expect other AI developers to explore similar container-based approaches, testing their effectiveness in various operational contexts. Further research and practical trials will determine how this model influences enterprise AI deployment in the coming months.

Google’s Agent Development Kit Explained: Building, Securing, and Scaling AI Agents with Google ADK: From Core Concepts and Deployment to Advanced Architectures and Domain Applications

Google’s Agent Development Kit Explained: Building, Securing, and Scaling AI Agents with Google ADK: From Core Concepts and Deployment to Advanced Architectures and Domain Applications

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 folder containing not just a prompt but instructions, scripts, data, and reference materials, making it a reusable, organized asset rather than a one-time instruction.

Why does treating Skills as folders matter for organizations?

It allows organizations to standardize procedures, improve consistency, capture tribal knowledge, and continuously refine operational assets over time.

Can this approach improve AI reliability?

Yes, by encapsulating procedural knowledge and guardrails within Skills, organizations can reduce errors and improve output quality across different users and scenarios.

What are the main challenges of adopting Skills as folders?

Maintaining large libraries of Skills, ensuring they stay up-to-date, and integrating them with existing workflows are potential hurdles.

Will other companies follow Anthropic’s lead?

It is likely, as the approach addresses common issues in enterprise AI deployment, but widespread adoption will depend on demonstrated success and ease of implementation.

Source: ThorstenMeyerAI.com

You May Also Like

The 9‑Year‑Old Who Built a Working Fusion Reactor In Minecraft

A 9-year-old has created a working fusion reactor in Minecraft, showcasing how…

The Switch: You Never Owned the AI You Depend On

Recent events show governments and companies can shut down AI models instantly, exposing dependency risks. Here’s what happened and what it means.

How Console Makers Keep Expanding Beyond Consoles

Discover how console makers are expanding beyond traditional hardware to revolutionize gaming accessibility and experience.

The Switch: You Never Owned the AI You Depend On

Exploring how governments and companies can instantly cut off AI access, revealing the fragility of reliance on API-based models in 2026.