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

AI Workflow Automation for Bloggers: Build a Simple Content System to Research, Write, Optimize, and Repurpose Posts Faster with AI and No-Code Tools (AI Toolkit for Bloggers 2026 Book 8)

AI Workflow Automation for Bloggers: Build a Simple Content System to Research, Write, Optimize, and Repurpose Posts Faster with AI and No-Code Tools (AI Toolkit for Bloggers 2026 Book 8)

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

Bridging Knowledge, Data, and AI: Harnessing the Semantic Layer Framework to Drive Intelligence

Bridging Knowledge, Data, and AI: Harnessing the Semantic Layer Framework to Drive Intelligence

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.

AI Month-End Close Assistant for Accountants: Copy-Paste Prompts, Templates, and AI Workflows to Save Time on Close Checklists, Variance Notes, Financial ... Tasks (AI Systems for Accountants Book 8)

AI Month-End Close Assistant for Accountants: Copy-Paste Prompts, Templates, and AI Workflows to Save Time on Close Checklists, Variance Notes, Financial … Tasks (AI Systems for Accountants Book 8)

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.
You May Also Like

Quiet GPUs for Local AI: Acoustic and Thermal Roundup

An in-depth roundup of the quietest and coolest GPUs for local AI in 2026, focusing on acoustics, thermal performance, and suitability for different model sizes.

7 Best PC Processors for Prime Day Deals in 2026

Discover the best PC processor deals for Prime Day 2026, including AMD and Intel options suitable for gaming, productivity, and future upgrades.

Different Game, or Already Lost? Reading Mistral’s Sovereignty Bet

Mistral emphasizes sovereignty, open weights, and local deployment in Europe’s AI scene. Is this a strategic advantage or a sign of falling behind US and Chinese giants?