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 prompting to organizing AI capabilities using ‘Skills’ as folders containing instructions and tools. This approach enhances consistency, onboarding, and institutional memory, marking a significant change in AI operational practices.

Anthropic has publicly detailed a new approach to managing AI agents, defining Skills as folders that contain instructions, scripts, and assets, rather than just saved prompts. This shift aims to create durable, reusable organizational capabilities, moving beyond ad-hoc prompting to institutionalized procedures.

In a recent publication, Anthropic’s Claude Code engineer explained that Skills are conceptualized as folders—containing not only instructions but also reference documents, scripts, templates, and configuration files—that the AI can discover, read, and execute. This design allows organizations to embed tribal knowledge directly into the AI’s operational environment, making output more consistent and onboarding more efficient.

Anthropic demonstrated that this folder-based approach transforms how AI agents are built and maintained, emphasizing that a Skill is a container for how an organization performs a task, not just a prompt or a note. The company identified nine categories of Skills, ranging from library references to infrastructure operations, with verification Skills ranked as the most impactful for improving output quality.

Technical teams are encouraged to focus on crafting Skills that push the model beyond default behaviors, such as including specific traps or ‘gotchas’ that prevent common errors. These Skills are designed to be triggered by precise descriptions, including internal slang, ensuring they activate only when relevant, thereby optimizing performance and reducing mistakes.

At a glance
reportWhen: announced March 2024
The developmentAnthropic shared insights from running hundreds of Skills internally, emphasizing a shift from prompt-based to folder-based organization for AI tasks.
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 Skills as Folders for AI Organizational Design

This development signals a fundamental shift in how organizations manage AI capabilities, moving from ephemeral prompts to durable, versioned assets. Treating Skills as folders enables better consistency, faster onboarding, and continuous improvement, effectively turning AI into a more reliable operational tool. For businesses, this approach could reduce errors, streamline workflows, and preserve institutional knowledge, making AI deployment more scalable and sustainable.

Building AI-Powered Products: The Essential Guide to AI and GenAI Product Management

Building AI-Powered Products: The Essential Guide to AI and GenAI Product Management

As an affiliate, we earn on qualifying purchases.

As an affiliate, we earn on qualifying purchases.

Background on AI Prompting and Organizational Knowledge Management

Until now, most teams using AI coding agents relied on ad-hoc prompting—retyping instructions daily or creating isolated prompt files. Anthropic’s new approach builds on the recognition that prompt engineering alone is insufficient for scalable, reliable AI deployment. The concept of packaging knowledge into reusable, versioned assets aligns with broader trends in software engineering and organizational knowledge management, emphasizing automation, consistency, and institutional memory.

Previously, AI capabilities were often treated as transient, with little structure for maintaining or improving instructions over time. Anthropic’s internal experiments with Skills—categorizing and cataloging them into nine types—aim to identify gaps and optimize workflows, setting a new standard for operational AI practices.

“Treating Skills as folders containing instructions and assets fundamentally changes how we design and deploy AI agents. It’s about creating durable, reusable organizational capabilities.”

— Thorsten Meyer, AI researcher at Anthropic

Machine Learning: 4 Books in 1: Basic Concepts + Artificial Intelligence + Python Programming + Python Machine Learning. A Comprehensive Guide to Build Intelligent Systems Using Python Libraries

Machine Learning: 4 Books in 1: Basic Concepts + Artificial Intelligence + Python Programming + Python Machine Learning. A Comprehensive Guide to Build Intelligent Systems Using Python Libraries

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 this folder-based Skills approach has been adopted within Anthropic or externally. Details about the specific technical mechanisms, such as how scripts are executed or how Skills are versioned and shared at scale, remain to be clarified. Additionally, the impact on existing workflows and integration with other AI systems is still under assessment.

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.

Next Steps for Adoption and Industry Impact of Skills as Folders

Anthropic plans to further develop and document its Skills framework, encouraging other organizations to adopt similar practices. Industry observers will watch for case studies demonstrating improvements in AI reliability, onboarding speed, and operational consistency. Future updates may include tools for managing Skills libraries at scale and integrating them into broader AI deployment pipelines.

Amazon

AI operational knowledge repositories

As an affiliate, we earn on qualifying purchases.

As an affiliate, we earn on qualifying purchases.

Key Questions

How does treating Skills as folders improve AI performance?

It allows for more consistent output, easier onboarding, and continuous improvement by embedding organizational knowledge directly into the AI’s operational environment.

What are the main categories of Skills identified by Anthropic?

They include library references, product verification, data analysis, business processes, code scaffolding, review, deployment, runbooks, and infrastructure operations.

Can this approach be applied outside of Anthropic?

While designed internally, the principles of organizing AI capabilities into reusable, versioned assets could be adopted broadly, especially in enterprise settings seeking reliable AI operations.

What challenges might organizations face in implementing Skills as folders?

Technical integration, maintaining version control, and ensuring that Skills are triggered correctly based on descriptions are potential hurdles.

Will this change how AI models are trained or just how they are operated?

This approach primarily impacts operational management and deployment, complementing training but not replacing it.

Source: ThorstenMeyerAI.com

You May Also Like

The Defender’s Counter-Cascade.

Google discloses real-world AI exploit; deployment gap in AI-driven security remains critical, impacting global cybersecurity resilience.

Vocal-strain load tracking for working singers

A new app prototype aims to monitor vocal strain in professional singers during tours, helping prevent voice injuries through daily analysis and alerts.

Demis Hassabis Net Worth: DeepMind, AI Research, and Strategic Wealth

By exploring Demis Hassabis’s groundbreaking AI ventures and strategic investments, you’ll discover how his net worth continues to grow beyond initial success.

ChannelHelm – Drop a video. Get a publishing kit.

ChannelHelm introduces an AI-powered tool that automates video asset creation, enabling creators to generate multiple platform-ready assets from a single upload.