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 better understood as folders containing instructions, scripts, and assets rather than just prompts. This approach improves consistency, onboarding, and institutional knowledge, marking a shift in AI operational practices.

Anthropic has revealed that its ‘Skills’ are not merely saved prompts but are structured as folders containing instructions, scripts, and reference materials. This redefinition aims to improve consistency, onboarding, and institutional knowledge management across AI teams, marking a significant shift in how AI capabilities are built and maintained.

The internal Anthropic document, authored by a Claude Code engineer, emphasizes that a Skill is a ‘folder’—a container that holds instructions, reference documents, runnable scripts, templates, data, configuration, and hooks. This structure enables AI agents to discover, read, and execute the contents dynamically, rather than relying on static prompts.

Anthropic’s approach transforms the traditional prompt-based method into a durable, reusable asset that encapsulates how an organization performs a task. The company reports that their best Skills started small but improved over time through iterative refinements, becoming valuable institutional assets. They estimate that dedicating a week of engineering effort to perfect a Skill can justify its development, as it becomes a long-term productivity tool.

Further, Anthropic identified nine categories of Skills, ranging from API references and data analysis to process automation and infrastructure operations. The most impactful, according to the firm, is verification — ensuring output quality by catching mistakes before they escalate. The emphasis on quality control and institutional memory aims to make AI-driven workflows more reliable and scalable.

At a glance
reportWhen: published recently; insights from an in…
The developmentAnthropic published a detailed internal report revealing that Skills are structured as folders rather than prompts, emphasizing their role as durable organizational assets.
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 Operations with Folder-Based Skills

This shift from prompts to folder-structured Skills enables organizations to standardize AI outputs, reduce onboarding time, and create a growing repository of institutional knowledge. It represents a move toward more durable, scalable AI practices that can adapt and improve over time, potentially changing how businesses deploy AI at scale.
Amazon

AI development organization tools

As an affiliate, we earn on qualifying purchases.

As an affiliate, we earn on qualifying purchases.

From Prompting to Asset Management in AI Development

Traditionally, AI teams have relied on prompts—short, static instructions—to guide model outputs. This approach is ad-hoc and difficult to scale or maintain. Anthropic’s internal work suggests that organizing instructions and tools into reusable folders can address these limitations, making AI capabilities more consistent and institutionalized. The concept aligns with broader industry trends toward modular, maintainable AI systems, but Anthropic’s emphasis on the folder as a container is a notable innovation.

“Anthropic’s redefinition of Skills as folders containing comprehensive assets fundamentally changes how organizations can build and maintain AI capabilities.”

— Thorsten Meyer, AI researcher

Amazon

AI script management software

As an affiliate, we earn on qualifying purchases.

As an affiliate, we earn on qualifying purchases.

What Aspects of the Folder Structure Are Still Developing

It is not yet clear how widely this folder-based approach will be adopted outside Anthropic or how it will integrate with existing AI workflows. Details on implementation challenges, scalability, and tooling support remain to be seen as organizations experiment with the model.
Amazon

AI knowledge base organization

As an affiliate, we earn on qualifying purchases.

As an affiliate, we earn on qualifying purchases.

Next Steps for Adopting Folder-Based Skills in AI Workflows

Organizations interested in this approach will likely pilot similar folder-based Skills, refine their internal processes, and develop tooling to support dynamic discovery and execution. Further research and case studies are expected to evaluate effectiveness and best practices in broader contexts.
AI for Bookkeeping Automation and Workflows: Automate Data Entry, Receipts, Categorization, Reconciliation, and Month-End Reporting Using AI and No-Code Tools, Save Hours Every Week for Bookkeepers

AI for Bookkeeping Automation and Workflows: Automate Data Entry, Receipts, Categorization, Reconciliation, and Month-End Reporting Using AI and No-Code Tools, Save Hours Every Week for Bookkeepers

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 structured folder containing instructions, scripts, and assets, whereas a prompt is a static instruction string. The folder approach makes Skills reusable and adaptable over time.

Why does structuring Skills as folders matter for organizations?

It enables consistent outputs, simplifies onboarding, and creates a durable knowledge base that evolves, improving scalability and reliability of AI systems.

Will this approach work with all AI models?

While designed with Anthropic’s models in mind, the concept is adaptable. Its success depends on how well the models can discover, read, and execute the folder contents.

What are the main technical challenges of implementing folder-based Skills?

Challenges include developing tooling for dynamic discovery, managing versioning, and ensuring integration with existing workflows and infrastructure.

How does this change the role of AI engineers?

Engineers will shift from crafting prompts to designing and maintaining comprehensive folder-based Skills, emphasizing modularity, documentation, and iterative improvement.

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 27% Problem: Why Google Wrote a $750M Check to Catch Anthropic

Google commits $750 million to expand enterprise AI, aiming to surpass Anthropic’s 40% market share amid shifting industry dynamics.

Smart Workflows In 2026: Top AI Automation Software You Should Know

Explore the leading AI automation tools of 2026, including OpenCode, Claude Code, and Microsoft 365 guides, and learn how they shape enterprise workflows.

Europe Regulated the Interface and Forgot to Build the Engine

Europe has focused on regulating AI interfaces like cookie banners but has failed to build or fund the underlying AI technology, risking global competitiveness.

Jack Clark Says It Out Loud — Reading the Co-Founder’s 60%/2028 Estimate on Automated AI R&D

Anthropic’s co-founder Jack Clark publicly estimates a 60% probability that autonomous AI systems capable of self-improvement could emerge by 2028, signaling a major policy stance.