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 shifted from using prompts to defining Skills as folders containing instructions, scripts, and assets. This approach enhances consistency, onboarding, and institutional knowledge in AI workflows, moving beyond simple prompt reuse.

Anthropic has announced a significant shift in how organizations should structure AI capabilities, emphasizing that Skills are folders, not prompts. This approach involves packaging instructions, scripts, and reference assets into reusable units that can be discovered and executed by AI agents. The development reflects a move away from ad-hoc prompting toward durable, institutionalized workflows, based on lessons learned from running hundreds of Skills internally.

In a detailed write-up from a Claude Code engineer, Anthropic describes Skills as folders containing instructions, reference documents, scripts, templates, data, and configuration. Unlike simple prompts, these folders serve as containers that the AI can discover, read, and execute, enabling more consistent and reliable outputs across different users and tasks. This method aims to formalize knowledge and processes within organizations, making AI-driven work more predictable and easier to onboard new team members.

Anthropic identified nine core categories of Skills, ranging from library references and code scaffolding to verification and infrastructure operations. The company emphasizes that the most valuable Skills are those that verify output quality, as they directly reduce mistakes and improve reliability. The approach also involves careful crafting of descriptions and scripts that trigger specific Skills, ensuring the AI applies the correct procedures based on context.

At a glance
reportWhen: published recently, with ongoing implem…
The developmentAnthropic published insights from running hundreds of Skills internally, demonstrating a new method of structuring AI capabilities as reusable, organized folders rather than static 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

Why Structuring Skills as Folders Changes AI Workflows

This shift from prompts to folder-based Skills offers a new paradigm for organizational AI use. It enables consistent output regardless of who operates the agent, simplifies onboarding by embedding institutional knowledge, and creates an evolving library of best practices that improve over time. For businesses, this approach reduces errors, enhances reliability, and turns ad-hoc instructions into valuable assets that appreciate in utility as they are refined.

Blue Summit Supplies 50 Project File Folders, Reinforced Straight Cut Tab, 2 Inch Expansion Pocket, Preprinted Project Management Folder Design, Letter Size, Manila, 50 Pack

Blue Summit Supplies 50 Project File Folders, Reinforced Straight Cut Tab, 2 Inch Expansion Pocket, Preprinted Project Management Folder Design, Letter Size, Manila, 50 Pack

Expandable Project File Jackets with Preprinted Project Tracking Layout – Dedicated sections for project details, task tracking, follow-up…

As an affiliate, we earn on qualifying purchases.

As an affiliate, we earn on qualifying purchases.

Internal Lessons from Anthropic’s Deployment of Hundreds of Skills

Anthropic’s internal experience with deploying hundreds of Skills has revealed that categorizing and formalizing knowledge into structured folders improves AI performance and consistency. The company’s analysis identified nine key Skill categories, emphasizing verification as the most impactful. This methodology builds on the idea that AI workflows should be treated as institutional assets, not just one-off prompts, aligning with broader trends toward operationalizing AI in enterprise settings.

“Treating Skills as folders containing comprehensive instructions and assets transforms ad-hoc prompting into durable, reusable organizational routines.”

— Thorsten Meyer, AI researcher

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.

Unanswered Questions About Skills Implementation and Scalability

It is not yet clear how widely adopted this folder-based Skills approach will become outside Anthropic or how it scales across different organizational sizes and industries. Details about how organizations will manage versioning, updates, and integration with existing workflows remain under development. Additionally, the long-term impact on AI performance and maintenance costs is still being evaluated.

AI-Driven Knowledge Management Assets: Strategies for the Modern Business Landscape

AI-Driven Knowledge Management Assets: Strategies for the Modern Business Landscape

As an affiliate, we earn on qualifying purchases.

As an affiliate, we earn on qualifying purchases.

Next Steps for Broader Adoption and Tool Development

Organizations interested in this approach should begin cataloging their internal processes into structured Skills, focusing on verification and automation categories. Industry groups and AI platform providers may develop tools to facilitate the creation, management, and sharing of Skills libraries. Further research and case studies are expected to emerge as more companies experiment with this model, potentially leading to standardized frameworks for organizational AI assets.

Claude AI for Beginners: 6 Books in 1: Build Apps, Create Content, Automate Work, and Make Money with AI

Claude AI for Beginners: 6 Books in 1: Build Apps, Create Content, Automate Work, and Make Money with AI

As an affiliate, we earn on qualifying purchases.

As an affiliate, we earn on qualifying purchases.

Key Questions

What exactly is a Skill in Anthropic’s approach?

A Skill is a structured folder containing instructions, scripts, reference documents, and other assets that can be discovered and executed by an AI agent, transforming ad-hoc prompts into reusable organizational routines.

How does this improve AI consistency and reliability?

By encapsulating processes and knowledge into Skills, organizations ensure that the same task is performed uniformly, reducing variability caused by different operators or prompt formulations.

Can this method be applied outside of AI development teams?

Yes, any organization that relies on AI for operational workflows, automation, or decision-making can benefit from structuring their knowledge and procedures as Skills for better management and scalability.

What are the main challenges in adopting this Skills framework?

Challenges include creating comprehensive and well-described Skills, managing updates and versioning, and integrating the system into existing workflows without disrupting current operations.

Will Skills replace prompts entirely?

Skills are intended to complement prompts by providing a more durable, organized, and automated way to encode organizational knowledge, rather than replacing simple prompts in all contexts.

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

NicheCommand: A Firehose Becomes a Shortlist

NicheCommand now filters and ranks expired domains, turning a flood of data into a manageable shortlist with detailed provenance and scoring.

AI Is the Alibi. The Reorg Is the Signal.

Coinbase’s recent layoffs and restructuring are officially linked to AI, but underlying factors suggest market pressures and cost-cutting are primary drivers. Here’s what’s confirmed and what remains unclear.

7 Best Internal Solid State Drives for Prime Day Deals in 2026

Discover the best internal SSD deals for Prime Day 2026, including top picks like SK Hynix Gold P31 2TB and Corsair MP600 Mini 2TB, with buying tips.

When One Agent Isn’t Enough: Claude Now Builds Its Own Team of Agents on the Fly

Anthropic’s Claude now autonomously creates and manages its own team of agents for complex tasks, enhancing performance in high-value workflows.