📊 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’ are best understood as folders containing instructions, scripts, and assets, not just prompts. This approach enhances consistency, onboarding, and institutional knowledge in AI workflows. The company shared insights from running hundreds of Skills internally, emphasizing their value as durable organizational assets.

Anthropic has announced that its Skills are not mere prompts but are structured folders containing instructions, scripts, and assets. This approach aims to standardize AI behavior across teams and improve organizational knowledge sharing. The revelation underscores a shift from ad-hoc prompting to durable, reusable operational units that can be versioned and shared within companies, marking a significant evolution in enterprise AI deployment.

In a recent publication from a Claude Code engineer, Anthropic explained that a Skill is fundamentally a folder, not just a saved prompt. These folders can include instructions, reference documents, runnable scripts, templates, data, configuration, and hooks that activate during operation. This redefinition allows AI agents to discover, read, and execute complex, bundled workflows, making their use more reliable and consistent.

Anthropic highlighted that this method transforms how organizations handle AI tasks. Instead of repeatedly retyping prompts, teams can build a library of Skills that encapsulate tribal knowledge, guardrails, and tools. These Skills improve output consistency, streamline onboarding, and grow smarter over time as they are refined through real-world use. The company estimates that teams might justify dedicating an engineer-week to perfecting a single Skill category, viewing Skills as an asset that appreciates with use.

Anthropic identified nine core categories of Skills, ranging from API references and product verification to code scaffolding and infrastructure operations. Among these, verification Skills—those that check and validate outputs—are considered most valuable, as they directly enhance quality and reduce errors. The company emphasizes that building high-quality Skills involves capturing non-obvious, organization-specific knowledge and writing precise, trigger-based descriptions to ensure proper activation.

At a glance
reportWhen: published March 2024, ongoing implement…
The developmentAnthropic published a detailed account of how it uses Skills—defined as folders with instructions and assets—to improve AI deployment and operational consistency.
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 Skills as Folders Mark a Turning Point in AI Deployment

This development signals a shift in enterprise AI from ephemeral prompts to durable, versioned assets that encode organizational knowledge and workflows. By treating Skills as folders with embedded instructions and scripts, companies can achieve greater consistency, reduce onboarding time, and create a growing library of institutional memory. This approach also enables AI systems to operate more reliably in complex, real-world scenarios, potentially transforming how organizations integrate AI into daily operations.

For businesses, this means AI deployment is becoming more scalable and maintainable, with a focus on building reusable, sharable assets rather than one-off prompts. The emphasis on Skills as assets that improve with use could lead to more mature AI practices and better alignment with operational needs, ultimately increasing ROI and reducing risks associated with AI errors.

Amazon

AI workflow automation scripts

As an affiliate, we earn on qualifying purchases.

As an affiliate, we earn on qualifying purchases.

Internal Evolution: From Prompt Engineering to Structured Assets

Until now, many AI teams relied on prompt engineering—crafting specific instructions for each task—as their primary method for controlling AI output. This approach is often ad hoc, requiring repeated effort and lacking consistency across teams. Anthropic’s recent insights stem from running hundreds of Skills internally, which revealed that organizing instructions and tools into folders creates a more durable and scalable system.

Historically, companies have struggled to codify tribal knowledge and operational guardrails in AI workflows. The shift toward folder-based Skills reflects an evolution toward capturing this knowledge systematically, enabling AI agents to perform complex tasks reliably and consistently. This approach aligns with broader industry trends toward modular, reusable AI components that can be versioned and shared across teams and projects.

Anthropic’s categorization of Skills into nine types provides a framework for organizations to evaluate their own capabilities and identify gaps, from basic reference retrieval to complex operational procedures. This structured methodology aims to replace piecemeal prompt tuning with a more disciplined, asset-based approach to AI deployment.

“Building Skills as assets allows us to create reliable, versioned workflows that improve with use, rather than relying on fragile prompts.”

— Anthropic engineer

Amazon

enterprise AI skills management software

As an affiliate, we earn on qualifying purchases.

As an affiliate, we earn on qualifying purchases.

Unclear Aspects of Skills Adoption and Scalability

It remains uncertain how broadly and quickly organizations will adopt this folder-based Skills approach outside Anthropic’s own operations. The scalability of creating and maintaining extensive Skills libraries, especially in large enterprises, is still being tested. Additionally, the process of formalizing tribal knowledge into structured folders may encounter resistance or practical challenges, such as ensuring consistency and avoiding version control issues across teams.

Further, the long-term impact on AI performance, especially in dynamic operational environments, is still under observation. It is not yet clear how well Skills will adapt to evolving workflows or how they will integrate with existing automation tools at scale.

Amazon

AI instruction and asset organization tools

As an affiliate, we earn on qualifying purchases.

As an affiliate, we earn on qualifying purchases.

Next Steps for Broader AI Skill Standardization

Organizations are expected to begin experimenting with folder-based Skills, guided by Anthropic’s framework, to assess its effectiveness in their contexts. Future developments may include tools for easier creation, versioning, and sharing of Skills, as well as industry standards for Skills taxonomy and descriptions.

Research and development efforts are likely to focus on automating the conversion of tribal knowledge into Skills, improving the discoverability and activation of Skills, and integrating this approach with existing DevOps and AI management platforms. The goal is to establish Skills as a core component of enterprise AI infrastructure, akin to code repositories or operational playbooks.

Amazon

AI process version control software

As an affiliate, we earn on qualifying purchases.

As an affiliate, we earn on qualifying purchases.

Key Questions

How does treating Skills as folders improve AI reliability?

By bundling instructions, scripts, and reference materials into a structured folder, Skills ensure that AI agents follow consistent, well-defined workflows, reducing errors caused by vague prompts or ad-hoc instructions.

What are the main categories of Skills identified by Anthropic?

Anthropic classified Skills into nine categories, including library references, product verification, data analysis, automation, code scaffolding, review, deployment, runbooks, and infrastructure operations.

Can this approach be adopted by other organizations easily?

While promising, adopting folder-based Skills requires effort to formalize tribal knowledge, create standardized descriptions, and develop tooling for managing Skills libraries. Scalability and integration challenges remain to be tested in larger, more complex environments.

What is the most valuable type of Skill according to Anthropic?

Verification Skills, which check and validate AI outputs, are considered most valuable because they directly improve output quality and reduce mistakes.

Will Skills replace prompt engineering entirely?

Skills aim to complement prompt engineering by providing structured, reusable assets that embed organizational knowledge, but prompts will likely still be used for flexible, quick tasks.

Source: ThorstenMeyerAI.com

You May Also Like

Capital: The Lever Beneath the Levers

Exploring how the flow of capital underpins AI’s expansion, the circular funding loop, and its risks for the economy and markets in 2026.

A War Room for Your Next Idea: Inside IdeaClyst

Discover how IdeaClyst offers founders a local AI-driven war room to validate and develop startup ideas efficiently, without data leaving their devices.

Mobilisiert, Nicht Ausgegeben: Was Von Europas €200-Milliarden-KI-Offensive üBrig Bleibt

European Commission’s InvestAI aims to mobilize €200 billion for AI, but only a small part is actual public funding; most relies on uncertain private investments.

Scholarship application organizer for school counselors

A new scholarship application organizer is being tested to help high school counselors manage student scholarship applications more efficiently, addressing widespread tracking issues.