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.

Building AI Agents for Network Operations: Design LLM-powered NetOps workflows with Python, Ollama, MCP, and tool calling

Building AI Agents for Network Operations: Design LLM-powered NetOps workflows with Python, Ollama, MCP, and tool calling

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 AUTOMATION TOOLKIT FOR SMALL BUSINESSES

AI AUTOMATION TOOLKIT FOR SMALL BUSINESSES

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

Creating An AI WAMI Exploitation Stack From Scratch: Day 1 Of Corvus ISR

Corvus ISR unveils its first public prototype of a synthetic WAMI scene with live detection and tracking, marking a significant step in autonomous ISR software development.

The Bubble Question, Disentangled: 1999 vs 2026 Category by Category

Analyzing the differences and similarities between the 1999 dotcom bubble and the 2026 AI cycle across various categories to understand bubble risks and value drivers.

Europe Regulated the Interface and Forgot to Build the Engine

Europe prioritized regulating AI interfaces but failed to build the underlying technology, risking its global competitiveness and innovation leadership.

Fable 5 Is Back. GPT-5.6 Is Next. And Anthropic Reportedly Already Has Something Stronger.

Fable 5 is back after an 18-day blackout, GPT-5.6 is in preview, and rumors suggest Anthropic has an even more advanced model hidden.