📊 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 using prompts to defining ‘Skills’ as folders containing instructions, scripts, and knowledge assets. This approach enhances consistency, onboarding, and institutional memory for AI agents. The company ran hundreds of experiments to validate this method, emphasizing its business value.

Anthropic has announced a significant shift in how organizations should build and deploy AI capabilities, emphasizing that Skills are not simple prompts but folders containing instructions, scripts, and reference materials. This approach aims to turn ad-hoc prompting into durable, institutional assets that improve consistency, onboarding, and operational robustness.

According to a detailed write-up from a Claude Code engineer, Anthropic’s Skills are structured as comprehensive folders, not just text prompts. These folders can include instructions, reference documents, runnable scripts, templates, data, and hooks that activate during specific tasks. This design enables AI agents to discover, read, and execute inside these folders, making their behavior more predictable and manageable.

Anthropic’s internal experiments involved running hundreds of Skills across its engineering teams, with the goal of creating reusable, versioned assets that encapsulate tribal knowledge, guardrails, and operational procedures. The company identified nine core categories of Skills, ranging from library references to infrastructure operations, with verification Skills deemed most valuable for ensuring output quality. The approach emphasizes that building high-quality Skills justifies significant engineering effort, as they become assets that improve over time.

At a glance
reportWhen: published March 2024
The developmentAnthropic published insights from running hundreds of Skills internally, demonstrating a new approach to organizing AI agent capabilities as reusable folders, not just 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

Transforming AI Capabilities into Organizational Assets

This development matters because it shifts the paradigm from reactive, prompt-based AI interactions to proactive, structured organizational assets. By packaging knowledge into Skills, companies can achieve more consistent outputs, reduce onboarding time, and develop a scalable library of operational procedures. This approach also enhances the durability and reliability of AI systems, making them more aligned with enterprise needs and compliance requirements.

Amazon

AI development folder organization tools

As an affiliate, we earn on qualifying purchases.

As an affiliate, we earn on qualifying purchases.

From Prompt Engineering to Asset Building

Traditionally, AI teams have relied on prompt engineering—crafting specific instructions for each task. However, this method is ad-hoc and fragile, often requiring repeated effort and lacking institutional memory. Anthropic’s move to define Skills as folders builds on ongoing industry efforts to standardize and scale AI deployment. The concept is rooted in internal experiments and reflects broader trends toward reusable AI components that serve as organizational assets rather than transient prompts.

“Anthropic’s Skills are fundamentally folders—containers for instructions, scripts, and knowledge—shifting the focus from prompts to durable organizational assets.”

— Thorsten Meyer, AI researcher

Handbook of Research on Scripting, Media Coverage, and Implementation of E-learning Training in Lms Platforms

Handbook of Research on Scripting, Media Coverage, and Implementation of E-learning Training in Lms Platforms

As an affiliate, we earn on qualifying purchases.

As an affiliate, we earn on qualifying purchases.

Unclear Aspects of Skill Implementation and Scalability

While Anthropic’s internal results are promising, it is still unclear how broadly applicable this approach is across different industries and AI systems. The process of creating, maintaining, and updating Skills at scale remains to be tested outside Anthropic’s environment. Additionally, the precise technical mechanisms for discovering and executing scripts within folders are still evolving, and the long-term benefits versus traditional prompt engineering are not yet fully quantified.

AI-Driven Knowledge Management Assets: Strategies for the Modern Business Landscape

AI-Driven Knowledge Management Assets: Strategies for the Modern Business Landscape

As an affiliate, we earn on qualifying purchases.

As an affiliate, we earn on qualifying purchases.

Next Steps for Adoption and Industry Validation

Anthropic plans to share more detailed methodologies and case studies to help other organizations adopt this folder-based Skills approach. Industry observers expect to see pilot programs in various sectors testing the scalability and effectiveness of Skills as organizational assets. Further research will likely explore how Skills can be integrated into existing AI workflows and how they perform in dynamic, real-world environments.

The AI Agent Blueprint: A Practical Playbook for Building Agentic Artificial Intelligence: Launch Your First Agent in 30 Days

The AI Agent Blueprint: A Practical Playbook for Building Agentic Artificial Intelligence: Launch Your First Agent in 30 Days

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, reference documents, scripts, and configuration that an AI agent can discover, read, and execute, rather than just a prompt or set of prompts.

How does this improve AI performance?

It makes output more consistent, reduces onboarding time, and allows organizations to capture and reuse tribal knowledge, leading to more reliable and scalable AI systems.

Is this approach applicable outside Anthropic?

While promising, it remains to be seen how well this method scales across industries. Adoption will depend on technical feasibility, maintenance effort, and demonstrated benefits in diverse environments.

What are the main technical challenges?

Developing robust mechanisms for discovering, activating, and updating Skills folders, as well as integrating them into existing workflows, are key technical hurdles.

Will this replace prompt engineering?

Not necessarily; it offers an alternative that emphasizes durable, reusable assets, but prompt engineering may still be useful for quick, one-off tasks.

Source: ThorstenMeyerAI.com

You May Also Like

Why is Doordash not working? DoorDash down for many Sunday

DoorDash experienced a widespread outage Sunday evening, with users reporting app issues. The cause remains unconfirmed, and service is not yet restored.

Why is Doordash not working? DoorDash down for many Sunday

DoorDash experienced widespread outages Sunday evening, with users reporting issues accessing the app. The cause remains unclear, and the service is currently unavailable for many.

SpaceX launches 7.5-ton SiriusXM satellite as part of constellation refresh

SpaceX successfully launched SiriusXM’s SXM-11 satellite, a 7.5-ton high-power satellite, to replace aging assets and enhance coverage across North America.

Unmanned Systems Surges In Global Coverage

Coverage of unmanned systems has surged worldwide, with a 9.3-fold increase in mentions, highlighting growing interest and developments in the sector.