📊 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 from prompt-based AI instructions to a folder-based system called Skills, enabling more consistent, scalable, and durable AI operations. This approach treats Skills as containers for organizational knowledge, not just prompts.

Anthropic has publicly detailed its new approach to AI management, revealing that Skills are structured as folders containing instructions, scripts, and configuration, rather than just saved prompts. This shift aims to create more durable, consistent, and scalable AI operations within organizations, moving beyond ad-hoc prompting to institutionalized capabilities. The change is based on Anthropic’s experience running hundreds of Skills internally, which they describe as a fundamental reframe for building reliable AI systems.

According to a detailed write-up from an Anthropic engineer, a Skill is not merely a prompt saved as text but a folder that can include instructions, reference documents, runnable scripts, templates, data, configurations, and hooks. This structure allows AI agents to discover, read, and execute within a comprehensive container, making the process more reliable and maintainable.

Anthropic emphasizes that Skills serve three core functions for organizations: ensuring output consistency, simplifying onboarding, and enabling continuous improvement. The company has identified nine categories of Skills, ranging from library references and data analysis to operational procedures and code review, which serve as building blocks for organizational AI workflows.

The most valuable Skills, according to Anthropic, are those that verify work—ensuring quality and catching mistakes—highlighting the importance of robust validation processes in AI deployment. The approach aims to reduce the need for repeated, ad-hoc prompting, replacing it with versioned, shareable assets that grow smarter over time.

At a glance
reportWhen: announced March 2024
The developmentAnthropic shared insights from its internal experience running hundreds of Skills, revealing a new model where Skills are folders with instructions, scripts, and assets, 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

Why Folder-Based Skills Transform AI Operations

This development matters because it shifts the way organizations build and maintain AI systems. Moving from prompts to structured folders creates a durable, reusable asset that can be versioned, shared, and improved over time. It reduces reliance on individual expertise and ad-hoc instructions, making AI deployment more predictable and scalable across teams.

For businesses, this approach offers a way to embed tribal knowledge, guardrails, and operational procedures directly into AI workflows, enabling more consistent outputs and faster onboarding. It also positions Skills as assets that appreciate in value, as they are refined and expanded with each use case or edge case encountered.

Ultimately, this approach could influence industry standards for AI management, emphasizing structured, asset-based workflows over simple prompt engineering.

Amazon

AI development folder structure tools

As an affiliate, we earn on qualifying purchases.

As an affiliate, we earn on qualifying purchases.

Internal Experience and Industry Shift Toward Structured Assets

Anthropic’s revelation stems from its internal experience managing hundreds of Skills across its engineering teams. Previously, most organizations relied on prompt engineering—reusing text instructions with little structure or version control. Anthropic’s approach treats Skills as comprehensive containers, enabling more reliable and scalable AI behavior.

This shift reflects broader industry trends toward making AI systems more maintainable and aligned with organizational processes. The concept of Skills as folders aligns with practices in software engineering, where modular, versioned assets are standard. Anthropic’s detailed account provides a practical blueprint for other organizations seeking to improve AI reliability and operational consistency.

While the idea of reusable assets is not new in software, applying it to AI prompt management represents a significant evolution in how organizations think about AI workflows.

“Transforming Skills into folders with instructions, scripts, and assets fundamentally changes how organizations build durable AI capabilities.”

— Thorsten Meyer, AI researcher

Amazon

AI instruction scripting software

As an affiliate, we earn on qualifying purchases.

As an affiliate, we earn on qualifying purchases.

Unclear Aspects of the Folder-Based Skills System

It is not yet clear how widely this approach has been adopted outside Anthropic or how it performs at scale in different organizational contexts. Details about the integration process, tooling, and potential limitations remain undisclosed. Additionally, how this model compares to other emerging AI asset management strategies is still to be evaluated.

Amazon

AI asset management tools

As an affiliate, we earn on qualifying purchases.

As an affiliate, we earn on qualifying purchases.

Next Steps for Broader Adoption and Validation

Organizations interested in this approach will likely experiment with implementing folder-based Skills, assessing their impact on consistency and onboarding. Further case studies and tooling support are expected to emerge, potentially standardizing this method across the industry. Anthropic may also refine and expand its Skills categories based on ongoing internal experience and external feedback.

Amazon

AI validation and testing software

As an affiliate, we earn on qualifying purchases.

As an affiliate, we earn on qualifying purchases.

Key Questions

How does a Skill as a folder improve AI consistency?

By encapsulating instructions, scripts, and assets in a structured container, Skills ensure that AI agents perform tasks in a repeatable and reliable manner, reducing variability caused by ad-hoc prompting.

Can this approach be applied outside Anthropic?

Yes, the concept of containerized, asset-based AI workflows can be adopted by other organizations, though implementation details and tooling may vary.

What are the main categories of Skills identified?

Anthropic’s nine categories include library references, product verification, data analysis, business automation, code scaffolding, quality review, CI/CD, runbooks, and infrastructure operations.

What remains uncertain about this system?

It is still unclear how scalable and adaptable this approach is across different industries and organizational sizes, and how it integrates with existing AI infrastructure.

Source: ThorstenMeyerAI.com

You May Also Like

The Labor Displacement Data: What Q1-Q2 2026 Actually Shows

New data from early 2026 shows significant AI-driven layoffs concentrated in specific cohorts, indicating a structural labor market change rather than mass displacement.

Drones in Disaster Response: Helping After Hurricanes and Earthquakes

Offering rapid, precise disaster assessment, drones are revolutionizing response efforts—discover how they transform rescue operations after hurricanes and earthquakes.

Birds Vs Drones: How to Prevent Bird Attacks on Your Drone

What strategies can you use to prevent bird attacks on your drone and ensure safe, uninterrupted flights?

The Defender’s Counter-Cascade.

On May 11, 2026, Google disclosed the first confirmed use of an AI-built zero-day exploit, highlighting the deployment gap in AI-driven cybersecurity defenses.