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 revealed that its AI agents now utilize ‘Skills’ structured as folders containing instructions, scripts, and assets. This approach enhances consistency, onboarding, and continuous improvement in AI operations, moving beyond simple prompts.

Anthropic has introduced a new methodology for managing AI agents, emphasizing the use of folder-structured Skills rather than traditional prompts. This approach aims to improve output consistency, streamline onboarding, and create an asset library that evolves over time, according to a detailed internal write-up from a Claude Code engineer.

In its latest publication, Anthropic explains that a Skill is not merely a saved prompt but a folder containing instructions, reference documents, scripts, templates, and configuration data. This structure allows AI agents to discover, read, and execute the contents dynamically, making their behavior more robust and repeatable.

The shift from prompt-based instructions to folder-based Skills is intended to embed tribal knowledge, guardrails, and tools directly into the agent’s operational framework. This enables organizations to standardize tasks, accelerate onboarding, and improve over time as Skills are refined through practical use.

Anthropic identified nine core categories of Skills, ranging from library references and product verification to infrastructure operations. The most valued category, according to the company, is verification Skills, which help catch mistakes before they reach production, significantly improving output quality. The company emphasizes that developing a high-quality Skill requires focusing on non-obvious, specific knowledge and trap avoidance, rather than restating known facts.

At a glance
reportWhen: announced March 2024
The developmentAnthropic published insights from its internal experiments showing that packaging AI knowledge into folder-based Skills improves operational consistency and knowledge retention.
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 of Folder-Based Skills for AI Operations

This development signals a shift in how organizations manage AI agents, moving from ad-hoc prompting to structured, reusable assets. By treating Skills as containers for operational knowledge, companies can achieve greater consistency, faster onboarding, and continuous improvement. This approach could set a new standard in enterprise AI deployment, making AI systems more reliable and maintainable.

The AI Workshop: The Complete Beginner's Guide to AI: Your A-Z Guide to Mastering Artificial Intelligence for Life, Work, and Business—No Coding Required (THE AI WORKSHOP by Milo Foster)

The AI Workshop: The Complete Beginner's Guide to AI: Your A-Z Guide to Mastering Artificial Intelligence for Life, Work, and Business—No Coding Required (THE AI WORKSHOP by Milo Foster)

As an affiliate, we earn on qualifying purchases.

As an affiliate, we earn on qualifying purchases.

Background on AI Prompting and Organizational Knowledge Management

Traditional AI prompt engineering involves crafting specific instructions for each task, often leading to inconsistency and high onboarding costs. Recent industry efforts focus on making AI behavior more predictable and scalable. Anthropic’s internal experiments with Skills reflect a broader trend toward knowledge encapsulation and asset management in AI workflows, aiming to embed tribal knowledge directly into operational routines.

“Packaging knowledge into folder-based Skills transforms ad-hoc prompting into a durable, institutional capability.”

— Thorsten Meyer, AI researcher

Amazon

folder-based AI knowledge repositories

As an affiliate, we earn on qualifying purchases.

As an affiliate, we earn on qualifying purchases.

Unresolved Questions About Skills Implementation

It remains unclear how widely Anthropic plans to adopt this approach across its entire product suite or how easily other organizations can implement similar folder-based Skills. Additionally, the long-term impact on AI performance, maintenance, and scalability is still being evaluated. Details on how Skills are versioned, shared, and integrated with existing systems are also not yet fully disclosed.

Script Fonts Interlock Signmaker's Templates Kit – Letters, Symbols Router Template Sign Making Kit – Polymer Router Template Guide - Template Woodworking Creates Professional Signs w/Cursive Script

Script Fonts Interlock Signmaker's Templates Kit – Letters, Symbols Router Template Sign Making Kit – Polymer Router Template Guide – Template Woodworking Creates Professional Signs w/Cursive Script

Router Sign Making Template: Create professional-looking signs with flowing cursive lettering templates locked together with our router letter…

As an affiliate, we earn on qualifying purchases.

As an affiliate, we earn on qualifying purchases.

Next Steps in Skills Development and Adoption

Anthropic is expected to continue refining its Skills framework, potentially releasing tools or best practices for external organizations. Monitoring how these Skills perform in real-world deployments will be crucial, as will observing whether other AI developers adopt similar container-based approaches. Further research and case studies are anticipated to assess the long-term benefits and challenges of this methodology.

Amazon

AI onboarding and training kits

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 traditional prompt?

A Skill is a folder containing instructions, scripts, and assets, whereas a prompt is a simple text instruction. Skills enable dynamic discovery and execution of complex workflows, making AI behavior more consistent and maintainable.

What categories of Skills did Anthropic identify?

Anthropic identified nine categories, including library reference, verification, data analysis, automation, code scaffolding, review, deployment, runbooks, and infrastructure operations.

Why is verification considered the most valuable Skills category?

Verification Skills help catch errors before reaching production, significantly improving output quality and reducing costly mistakes.

Can other organizations adopt this Skills approach easily?

While the concept is promising, implementation complexity and integration with existing systems may vary. Further guidance from Anthropic is expected to clarify best practices.

What are the main benefits of using Skills over prompts?

Skills provide standardization, reusability, and continuous improvement, making AI systems more predictable, scalable, and easier to maintain.

Source: ThorstenMeyerAI.com

You May Also Like

Drone Specs Explained for Curious Buyers

Knowledge of drone specs reveals what to prioritize, but understanding the details can truly help you choose the perfect model for your needs.

Thrymvault: A System Around Your Content

Thrymvault launches as a private, self-hosted platform integrating content creation, management, AI prompts, and client collaboration in one place.

The CFO’s new operating system. Anthropic, OpenAI, and the consulting margin that just got compressed.

Anthropic’s $1.5B JV and OpenAI’s parallel move transform enterprise AI with integrated operating systems, bypassing traditional consulting models.

Phase 1 synthesis. What the four sectors crystallize.

Empirical research confirms four distinct labor displacement patterns across sectors, revealing sector-specific structural signatures in AI-driven workforce shifts.