📊 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 conceptualizing Skills as folders containing instructions, scripts, and assets enhances AI deployment. This approach improves consistency, onboarding, and organizational learning, moving beyond simple prompts.

Anthropic has revealed that its approach to building AI Skills involves packaging them as folders—containing instructions, scripts, and reference materials—rather than simple prompts. This method has been tested across its engineering organization, leading to more consistent and durable AI behaviors. The development underscores a shift from ad-hoc prompting to institutionalized capabilities, which could influence how organizations deploy AI models at scale.

In a detailed write-up, Anthropic’s Claude Code engineer explained that a Skill is not just a saved prompt, but a folder that can include instructions, reference documents, runnable scripts, templates, data, configuration, and hooks. This structure allows AI agents to discover, read, and execute the contents, making their operations more reliable and repeatable. For organizations, this means transforming tacit knowledge into shareable, versioned assets that improve over time.

Anthropic’s internal analysis identified nine categories of Skills, ranging from library references and product verification to infrastructure operations. The most valuable, according to the company, is verification Skills—those that check and validate outputs—since they significantly enhance output quality. The approach emphasizes that building these Skills requires dedicated effort, with companies potentially investing a week of engineering time to perfect a category.

At a glance
reportWhen: published recently, with insights from…
The developmentAnthropic published a detailed account of how it uses folder-based Skills to improve AI agent performance and organizational knowledge management.
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

Impact of Folder-Based Skills on AI Deployment

This approach matters because it shifts AI development from one-off prompts to structured, reusable assets that embed tribal knowledge and guardrails directly into the agent’s workflow. It leads to more consistent outputs, easier onboarding of new team members, and a scalable way to improve AI behavior over time. For businesses, adopting this model could mean more reliable AI systems and a competitive edge in operational efficiency.

Amazon

AI development folder structure tools

As an affiliate, we earn on qualifying purchases.

As an affiliate, we earn on qualifying purchases.

Evolution from Prompt Engineering to Asset-Based Methods

Until now, most AI teams have relied on prompt engineering—retyping instructions daily or creating static prompts. Anthropic’s approach marks a departure by formalizing these instructions into durable, versioned folders. This shift aligns with broader trends toward modular, maintainable AI systems. The idea of packaging knowledge as assets is gaining traction as organizations seek to embed institutional memory into their AI workflows.

Anthropic’s internal taxonomy of Skills into nine categories provides a framework for identifying organizational gaps and prioritizing development efforts. The focus on verification Skills reflects a recognition that quality control is central to trustworthy AI deployment.

“Treating Skills as folders containing comprehensive assets fundamentally changes how organizations can codify and reuse knowledge in AI systems.”

— Thorsten Meyer, AI researcher

Generative AI Apps with LangChain and Python: A Project-Based Approach to Building Real-World LLM Apps

Generative AI Apps with LangChain and Python: A Project-Based Approach to Building Real-World LLM Apps

As an affiliate, we earn on qualifying purchases.

As an affiliate, we earn on qualifying purchases.

Unresolved Questions About Folder-Based Skills Implementation

It is not yet clear how widely this approach has been adopted outside Anthropic or how it performs across different industries. Details about the scalability, maintenance, and integration challenges of managing large Skills libraries remain to be seen. Additionally, the precise impact on long-term AI reliability and organizational workflows is still under evaluation.

Knowledge Management: Systems and Processes in the AI Era

Knowledge Management: Systems and Processes in the AI Era

As an affiliate, we earn on qualifying purchases.

As an affiliate, we earn on qualifying purchases.

Next Steps for Broader Adoption and Evaluation

Organizations interested in this approach will likely experiment with creating their own Skills libraries based on Anthropic’s framework. Further research and case studies are expected to assess how this method scales and influences operational outcomes. Anthropic may also refine its taxonomy and tooling to support wider deployment of folder-based Skills.

ALMULOO Gimbal Bearing Alignment Tool for Marine Applications Compatible with Mercruiser Alpha, Alpha 1, Bravo, OMC, Cobra & MR Models Heavy-Duty Galvanized Steel Engine Alignment Bar

ALMULOO Gimbal Bearing Alignment Tool for Marine Applications Compatible with Mercruiser Alpha, Alpha 1, Bravo, OMC, Cobra & MR Models Heavy-Duty Galvanized Steel Engine Alignment Bar

Compatibility:A universal marine tool compatible with most boat models including Mercruiser Alpha, Alpha 1, Bravo, OMC, MR, Cobra,…

As an affiliate, we earn on qualifying purchases.

As an affiliate, we earn on qualifying purchases.

Key Questions

What is the main advantage of treating Skills as folders?

The main advantage is that folders enable organizations to embed comprehensive, reusable knowledge and scripts into AI agents, resulting in more consistent, reliable, and maintainable behaviors.

How does this approach differ from traditional prompt engineering?

Instead of static prompts, folder-based Skills contain instructions, code, and reference materials that can be discovered and executed by the agent, making the process more durable and scalable.

What types of Skills did Anthropic identify as most valuable?

The most valuable are verification Skills, which check and validate outputs, significantly improving output quality and trustworthiness.

Can this method be applied outside of AI development teams?

Yes, the approach is relevant for any organization seeking to codify operational procedures, tribal knowledge, or guardrails into AI systems for consistent performance.

Source: ThorstenMeyerAI.com

You May Also Like

Opus 4.8 Lands, and the Quiet Headline Is Honesty

Anthropic releases Claude Opus 4.8, highlighting improved honesty and safety features alongside benchmark gains, amid a focus on transparency.

AI compliance brief generator for small clinics

Small clinics are set to trial an AI-powered compliance brief generator to streamline regulatory updates, with a focus on operational efficiency and compliance.

Rebrandable client delivery dashboard for AI agencies

A new rebrandable client delivery dashboard for AI agencies is being tested as a minimal viable product, aiming to improve client transparency and trust.

Phone-based injury-risk movement screening for hiring

A new remote movement screening tool using phone cameras is being piloted for industrial hiring to assess injury risk efficiently and affordably.