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 ‘Skills’ in AI are best understood as folders containing instructions, scripts, and assets, not just prompts. This approach enhances consistency, onboarding, and institutional knowledge, marking a shift in AI operational practices.

Anthropic has revealed that its ‘Skills’ are better understood as folders containing instructions, scripts, and assets, rather than just prompts. This shift in understanding aims to make AI agent behaviors more consistent, maintainable, and scalable across organizations, according to a detailed internal write-up from a Claude Code engineer. The development underscores a move toward institutionalizing AI workflows as durable, versioned assets rather than ad-hoc prompts.

Anthropic’s recent publication emphasizes that a Skill is a container—essentially a folder—that can include instructions, reference documents, scripts, templates, data, configurations, and hooks. This redefinition moves away from the misconception that Skills are merely saved prompts or markdown notes. Instead, they serve as comprehensive units embodying organizational knowledge and operational procedures.

This approach allows companies to standardize agent output, ensuring tasks are performed consistently regardless of the operator. It also simplifies onboarding by embedding tribal knowledge into reusable assets, reducing reliance on individual expertise. Anthropic reports that their most effective Skills evolved over time, improving through iterative refinement and capturing edge cases, making them valuable organizational assets that appreciate in utility.

Anthropic identified nine core categories of Skills, including data fetching, product verification, code scaffolding, and infrastructure operations. Among these, verification Skills—used to check output quality—are considered most impactful, as they directly improve the reliability of AI-generated results. The company advocates investing significant engineer time to develop high-quality Skills, viewing them as long-term assets rather than costs.

At a glance
reportWhen: published recently, with the core insig…
The developmentAnthropic published insights on running hundreds of Skills, emphasizing their nature as folders that bundle instructions, code, and reference materials, rather than 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

Implications for AI Operational Practices

This development signals a paradigm shift in how organizations deploy and maintain AI agents. By treating Skills as folders with bundled instructions and code, companies can achieve greater consistency, reduce onboarding time, and build a durable institutional memory. It also encourages a more systematic approach to AI workflow management, moving away from fragile, prompt-based interactions toward robust, versioned assets that evolve and improve over time. This approach could redefine best practices in enterprise AI deployment, emphasizing reusability and maintainability.

AI Workflow Systems: AI Prompts for Freelance Consultants: Practical AI workflow prompts to automate client work, boost productivity, and scale consulting ... Frameworks for the Modern World Book 1)

AI Workflow Systems: AI Prompts for Freelance Consultants: Practical AI workflow prompts to automate client work, boost productivity, and scale consulting … Frameworks for the Modern World Book 1)

As an affiliate, we earn on qualifying purchases.

As an affiliate, we earn on qualifying purchases.

From Prompt Engineering to Asset Building

Prior to this insight, most teams relied on prompt engineering—crafting specific instructions for each interaction. While effective in the short term, this method is brittle and difficult to scale. Anthropic’s internal experiments with hundreds of Skills demonstrated that organizing knowledge into folders with scripts and reference materials creates a more reliable and scalable system. This approach aligns with broader trends in software engineering, where modular, versioned assets replace ad-hoc code snippets or notes.

The concept of Skills as folders builds on existing practices but elevates them into a formalized framework that can be shared, versioned, and improved systematically. It reflects an understanding that operational AI requires more than prompts; it needs structured, durable assets that encapsulate tribal knowledge and guardrails.

“A Skill is a folder—containing instructions, scripts, and assets—that can be discovered, read, and executed by the agent.”

— Thorsten Meyer, AI researcher at Anthropic

KMBox NET DropArk, Network Mouse and Keyboard Controller and Emulator, DMA AI KMBox-NET, Network Version 100M DMA, Single Machine Dual Controller USB Converter, DMA Kmbox FPGA

KMBox NET DropArk, Network Mouse and Keyboard Controller and Emulator, DMA AI KMBox-NET, Network Version 100M DMA, Single Machine Dual Controller USB Converter, DMA Kmbox FPGA

High-Speed Input Emulation: Enjoy seamless communication with high-speed input emulation that doesn't consume your USB keyboard and mouse…

As an affiliate, we earn on qualifying purchases.

As an affiliate, we earn on qualifying purchases.

Unclear Aspects of Skill Implementation and Adoption

It is not yet clear how widely organizations will adopt this folder-based approach or how it will impact existing AI workflows. Details on integration with current systems and scalability across different industries remain to be seen.
Sooez 24 Packs Plastic Envelopes Plastic File Folders, Clear Document Organizer Folder US Letter A4 Size Folders for Documents with Label Pocket for School Office Work Home Organization, Fresh Colors

Sooez 24 Packs Plastic Envelopes Plastic File Folders, Clear Document Organizer Folder US Letter A4 Size Folders for Documents with Label Pocket for School Office Work Home Organization, Fresh Colors

Colorful Transparent Folders: Refresh your storage with 5 Pastels Colors:pink, yellow, green, blue, purple, transparent. Each color with…

As an affiliate, we earn on qualifying purchases.

As an affiliate, we earn on qualifying purchases.

Next Steps for Organizations and AI Developers

Organizations interested in this approach should evaluate their current AI workflows and consider developing their own Skills as folders. Further research and case studies are expected to emerge, demonstrating best practices for building, managing, and scaling these assets. Additionally, industry groups may begin to formalize standards around Skills, promoting wider adoption.

Anthropic plans to refine its framework and share more detailed guidance, encouraging other teams to experiment with this model as a way to institutionalize AI knowledge and improve operational reliability.

AI-Native Software Delivery: Proven Practices to Produce High-Quality Software Faster

AI-Native Software Delivery: Proven Practices to Produce High-Quality Software Faster

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, and configuration data that an AI agent can discover, read, and execute, serving as a durable organizational asset.

How does this differ from traditional prompt engineering?

Unlike prompts, which are simple instructions or questions, Skills are comprehensive containers that bundle procedural knowledge and code, making AI behaviors more consistent and maintainable over time.

Why is treating Skills as folders more effective?

This approach enables versioning, reuse, and iterative improvement, transforming ad-hoc prompts into institutional assets that can evolve and scale with organizational needs.

Will this approach work for all types of AI tasks?

While most operational tasks benefit from structured Skills, the effectiveness depends on the complexity of the task and the organization’s ability to formalize procedures into these folder-based assets.

What are the next steps for companies interested in adopting this model?

Companies should start by cataloging existing knowledge, creating Skills as folders for key workflows, and iterating to improve them over time. Industry standards and best practices are likely to develop as adoption grows.

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.
You May Also Like

The Continual Learning Research Map: Where the Memento Constraint Stands in May 2026

An update on the research landscape of the Memento Constraint in continual learning, detailing current approaches, timelines, and remaining uncertainties as of May 2026.

The 90-Day Window Closed. Nobody Sent a Notice.

The 90-day window for responsible vulnerability disclosure has effectively ended as no notices or patches have been sent, raising concerns over security risks.

AI Trading Bot — Week Two: The candidate edge collapsed

The promising BTC fair-value strategy failed in week two, wiping out gains and confirming no reliable edge. Fleet-wide losses now total around $2,500.

Apple Is Reaching For Chinese Memory. Europe Doesn’t Even Have That Option.

Apple seeks U.S. approval to buy Chinese memory chips amid shortages, highlighting Europe’s lack of domestic memory manufacturing and strategic vulnerabilities.