A Skill Is a Folder, Not a Prompt: What Anthropic Learned Running Hundreds of Them
AIThis post was created with the assistance of artificial intelligence (AI).

📊 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.

PRIME GAMING

Play games included with Prime

Start a Prime free trial and play with Amazon Luna on your devices.

Start playing

As an affiliate, we earn on qualifying purchases.

TL;DR

Anthropic has demonstrated that AI Skills should be viewed as folders containing instructions, code, and assets rather than simple prompts. This approach improves consistency, onboarding, and knowledge retention in AI-driven workflows. The company ran hundreds of Skills internally, emphasizing their value as durable organizational assets.

Anthropic has announced a new conceptual framework for AI Skills, defining them as folders containing instructions, scripts, and data rather than mere prompts. This shift aims to make AI-driven processes more consistent, maintainable, and scalable within organizations. The company’s internal experiments with hundreds of Skills highlight their potential as durable assets that codify tribal knowledge and operational procedures, moving beyond ad-hoc prompting.

In a detailed write-up from a Claude Code engineer, Anthropic explains that a Skill is a folder that can include instructions, reference documents, scripts, templates, configuration, and hooks. This structure allows AI agents to discover, read, and execute complex workflows, making the process more reliable and repeatable. The company emphasizes that Skills are not just prompts but containers that encapsulate organizational knowledge and procedures, turning them into reusable assets.

Anthropic’s internal research identified nine categories of Skills, ranging from library references and API integrations to business process automation, code scaffolding, and infrastructure operations. The most impactful, according to the company, is verification Skills, which ensure output quality by checking and validating work, thereby reducing errors and increasing trustworthiness. The company advocates dedicating significant effort—up to an engineer-week—to perfecting a Skill in a specific category, viewing these as assets that appreciate in value over time.

Technical lessons include avoiding restating obvious information, focusing on non-trivial, organization-specific content, and carefully designing trigger descriptions that match user requests precisely. Bundling real code, helper functions, and context-specific details into Skills enhances their effectiveness and durability.

At a glance
reportWhen: published March 2024
The developmentAnthropic published insights from its internal experience running hundreds of Skills, revealing a new approach to designing and managing AI capabilities as structured folders rather than 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

Implications for Organizational AI Deployment

This approach fundamentally changes how organizations can manage AI capabilities, shifting from ephemeral prompts to structured, versioned assets that encode tribal knowledge and operational procedures. It enables consistent output across teams, accelerates onboarding, and creates a scalable library of reusable skills that improve over time. For enterprises, this means more reliable AI applications, better knowledge retention, and a competitive edge in automation and AI-driven workflows.

Amazon

AI workflow automation tools

As an affiliate, we earn on qualifying purchases.

As an affiliate, we earn on qualifying purchases.

Evolution of AI Skill Management Strategies

Prior to this development, most organizations relied on simple prompts or loosely organized scripts to interact with AI models. Anthropic’s internal experiments with hundreds of Skills demonstrate that structured folders containing instructions, code, and assets can serve as durable, scalable units of organizational knowledge. This aligns with broader trends toward modular, maintainable AI systems and reflects a maturation in how companies leverage AI for operational tasks.

The concept echoes existing practices in software engineering, where code and documentation are stored as versioned assets. Anthropic’s framing emphasizes that Skills are not just technical artifacts but organizational assets that can be improved iteratively, making them central to enterprise AI strategy.

“A Skill is a folder — one that can contain instructions, reference documents, runnable scripts, templates, data, configuration, and even hooks that fire only while the Skill is active.”

— Thorsten Meyer, AI engineer at Anthropic

Amazon

AI knowledge management software

As an affiliate, we earn on qualifying purchases.

As an affiliate, we earn on qualifying purchases.

Remaining Questions on Skills Adoption and Scalability

It is not yet clear how widely organizations will adopt this folder-based approach outside of Anthropic, nor how scalable and maintainable these Skills will be at very large enterprise levels. The effort required to develop and update Skills at scale remains to be quantified, and integration with existing workflows could pose challenges.

Amazon

AI scripting and 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 Tooling

Organizations interested in this approach will likely experiment with building their own Skills libraries, focusing on categories like verification and automation. Anthropic may release tooling or frameworks to facilitate this process, and further research will assess how Skills evolve, are maintained, and integrated into larger AI ecosystems. Monitoring industry uptake and case studies will be crucial to understanding the long-term impact.

Amazon

AI process automation templates

As an affiliate, we earn on qualifying purchases.

As an affiliate, we earn on qualifying purchases.

Key Questions

How does a Skill differ from a prompt?

A Skill is a structured folder containing instructions, scripts, and assets, whereas a prompt is a simple text input. Skills enable durable, reusable workflows that encapsulate organizational knowledge.

What are the main benefits of using Skills as folders?

Skills improve consistency, streamline onboarding, and create a scalable library of organizational procedures that can be refined over time, acting as assets that appreciate in value.

Will this approach work for all organizations?

While promising, the effectiveness depends on the organization’s ability to invest in developing and maintaining Skills. Larger, process-driven companies may benefit most, but widespread adoption remains to be seen.

What technical skills are needed to implement Skills as folders?

Developers need to design instructions, scripts, and trigger descriptions carefully, focusing on organization-specific content and edge cases, similar to software engineering best practices.

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.
FALL

Fall Picks

As an affiliate, we earn on qualifying purchases.

You May Also Like

Apple Is Reaching for Chinese Memory. Europe Doesn’t Even Have That Option.

Apple is lobbying US authorities to buy memory chips from China’s CXMT, exposing Europe’s lack of options in the global chip supply chain and its vulnerabilities.

The Essential Guide To Signal Monitoring In Tech With 500 Lines Of C++

An in-depth look at a new approach to signal monitoring in tech using a compact 500-line C++ implementation, tailored for small software teams.

Transforming Construction With AI: The Gewerkton Platform In Focus

Gewerkton, a new AI-driven construction platform, was built in a single night using verified code techniques, aiming to revolutionize industry workflows.

Creative industries. The bifurcated reality.

New data shows a ‘middle squeeze’ in creative sectors, with routine roles declining sharply while top-tier professionals augment with AI tools. The impact is significant for the future of creative work.