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 building AI skills as structured folders, rather than simple prompts, improves consistency, onboarding, and scalability. This approach is based on extensive internal testing and offers a new framework for enterprise AI deployment.

Anthropic has revealed that its approach to developing AI Skills involves packaging them as folders containing instructions, scripts, and reference assets, rather than relying on standalone prompts. This method, tested across hundreds of internal projects, aims to create more durable, reusable, and scalable AI capabilities for organizations. The revelation underscores a significant shift in how enterprise AI systems are designed and maintained, moving away from ad-hoc prompting toward structured, asset-based solutions.

In a detailed write-up by a Claude Code engineer, Anthropic explained that a Skill is fundamentally a folder—a container that can include instructions, reference documents, runnable scripts, data, templates, configuration files, and hooks that activate during specific tasks. This redefinition marks a departure from the common perception of a Skill as merely a prompt or a set of instructions. For technical teams, this change impacts how AI capabilities are designed, emphasizing modularity and reusability. For businesses, it translates into more consistent outputs, simplified onboarding, and the ability to iteratively improve Skills over time.

Anthropic’s internal experience shows that Skills cluster into nine categories, ranging from library references and code scaffolding to operational runbooks and infrastructure management. The company highlights that the most valuable Skills tend to be those that verify and check work, as they directly improve output quality. The approach encourages organizations to invest in building high-quality, reusable Skills, which can evolve and compound over time, transforming organizational knowledge into an asset rather than a cost.

At a glance
reportWhen: published recently, with ongoing implic…
The developmentAnthropic published a detailed account of their experience running hundreds of AI Skills, emphasizing a shift from prompts to folder-based assets for organizational AI capabilities.
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 of Folder-Based Skills for Enterprise AI

This development matters because it offers a new paradigm for building robust, maintainable AI systems in organizations. By structuring Skills as folders that contain all necessary instructions, code, and context, companies can achieve greater consistency, reduce onboarding time, and foster continuous improvement. This approach aligns with enterprise needs for scalability, reliability, and institutional memory, potentially transforming how AI is integrated into operational workflows and decision-making processes. It also signals a move toward standardized, version-controlled assets that can be shared and reused across teams, reducing duplicated effort and errors.

Amazon

AI development folder structure tools

As an affiliate, we earn on qualifying purchases.

As an affiliate, we earn on qualifying purchases.

From Prompts to Asset-Based AI Capabilities

Historically, most organizations have relied on prompt engineering—crafting specific instructions to guide AI outputs. This method, while flexible, often results in inconsistent results and requires repeated effort to refine prompts. Anthropic’s internal experiments with hundreds of Skills suggest that a more durable approach involves creating structured containers—folders—that bundle instructions, scripts, and knowledge assets. This shift is part of a broader trend toward formalizing AI capabilities within organizational workflows, emphasizing repeatability and institutional memory.

The concept echoes practices in software engineering, where modular, version-controlled assets improve maintainability. Anthropic’s nine-category Skills map provides a framework for identifying gaps in organizational capabilities, from data analysis to operational procedures, and underscores the importance of verification and quality control in AI deployment.

“A Skill is not just a prompt; it’s a folder that contains everything needed to execute a task reliably and consistently.”

— Thorsten Meyer, AI researcher at Anthropic

Amazon

enterprise AI scripting and asset management software

As an affiliate, we earn on qualifying purchases.

As an affiliate, we earn on qualifying purchases.

What Aspects of Folder-Based Skills Are Still Unclear

It is not yet clear how widely adopted or effective this approach will be outside Anthropic’s internal environment. Specific best practices for designing, managing, and updating Skills as folders are still emerging, and the scalability of this method across different organizational sizes and industries remains to be proven. Additionally, the transition from prompt-based to folder-based Skills may involve technical challenges and cultural shifts that are not fully understood.

A Guide to The Project Management Body of Knowledge (PMBOK Guide) Paperback

A Guide to The Project Management Body of Knowledge (PMBOK Guide) Paperback

As an affiliate, we earn on qualifying purchases.

As an affiliate, we earn on qualifying purchases.

Next Steps for Organizations Adopting Folder-Based Skills

Organizations interested in this approach should begin by cataloging their existing capabilities and identifying gaps aligned with Anthropic’s nine categories. Developing initial Skills as structured folders, focusing on verification and operational procedures, can provide immediate value. Future developments may include tooling for easier creation, versioning, and sharing of Skills, as well as industry standards for asset management. Monitoring how Anthropic and other firms refine this model will be key to understanding its broader applicability.

Amazon

AI skills modular asset containers

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 consistency?

Folders bundle instructions, scripts, and context, reducing variability and ensuring the same task is performed consistently across different agents and team members.

What is the main advantage of this approach over traditional prompting?

It creates durable, reusable assets that can be maintained, improved, and shared, rather than relying on ad-hoc, one-time prompts.

Can this method be applied outside of Anthropic?

While promising, adoption depends on technical infrastructure and organizational culture. Many organizations are exploring similar modular approaches to AI capabilities.

What are the biggest challenges in implementing folder-based Skills?

Designing comprehensive, non-obvious instructions, managing version control, and integrating these assets into existing workflows pose significant technical and cultural challenges.

Will this approach replace prompt engineering entirely?

Not immediately; it offers a complementary framework that enhances durability and scalability but may coexist with prompt-based methods during transition phases.

Source: ThorstenMeyerAI.com

Nothing in this article is financial or investment advice. Cryptocurrency and precious-metal investments carry significant risk — do your own research and consider a licensed advisor.
You May Also Like

The Bottleneck Moved: Inside Anthropic’s Expansion of Project Glasswing

Anthropic is extending its cybersecurity initiative, Project Glasswing, to more organizations worldwide, shifting focus from finding vulnerabilities to fixing them rapidly.

Cybersecurity operations signal monitor: A backdoor in a LinkedIn job offer

Cybersecurity operations have identified a backdoor in a LinkedIn job offer, raising concerns about targeted cyber threats and organizational security.

7 Best Office Product Scanners for Prime Day Deals in 2026

Discover the best office scanners on Prime Day 2026, including top picks for shared workspaces, solo use, and portable needs. Find your ideal scanner now.

What Are Liquidity Providers in Cryptocurrency

Uncover the essential role of liquidity providers in cryptocurrency and how they impact trading dynamics, but what risks could affect your returns?