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 treating AI Skills as folders—containing instructions, scripts, and data—improves consistency, onboarding, and scalability. They ran hundreds of these Skills internally, emphasizing their value as institutional assets.

Anthropic has revealed that its internal AI Skills are best understood as folders—comprehensive containers that include instructions, scripts, data, and configuration—rather than mere prompts. This approach has allowed the company to standardize AI outputs, accelerate onboarding, and build a durable knowledge base, marking a significant shift in how organizations deploy AI agents.

In a detailed write-up, a Claude Code engineer explains that a Skill is not just a prompt saved as text but a folder containing multiple assets—instructions, reference documents, scripts, and hooks—that the AI can discover and execute. This redefinition enables organizations to embed tribal knowledge, guardrails, and operational procedures directly into their AI systems, making behaviors consistent across different users and instances.

Anthropic’s internal experimentation involved running hundreds of Skills across nine categories, including data analysis, verification, automation, and infrastructure operations. The company emphasizes that the most valuable Skills are those that verify outputs, catching mistakes before they reach users, which has significantly improved output quality and reliability.

Technical lessons highlight that effective Skills should avoid restating obvious information, instead focusing on non-obvious, specific content that pushes the model off its default responses. The description of each Skill acts as a trigger, matching user requests precisely, and scripts are bundled to perform complex tasks reliably.

At a glance
reportWhen: announced April 2024
The developmentAnthropic published insights from running hundreds of Skills internally, redefining Skills as folders with comprehensive resources rather than simple 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 of Skills as Modular Folders for AI Deployment

This approach transforms AI deployment from ad-hoc prompting to structured, reusable assets that embed institutional knowledge and guardrails. It enables companies to standardize outputs, reduce onboarding time, and build a scalable library of operational procedures, making AI systems more reliable and easier to manage at scale.

By framing Skills as containers that include scripts, data, and configuration, organizations can treat AI behaviors as assets that appreciate over time, improving with each iteration. This methodology addresses common challenges like inconsistency, knowledge silos, and operational risk, offering a practical blueprint for enterprise AI adoption.

Amazon

AI development folder templates

As an affiliate, we earn on qualifying purchases.

As an affiliate, we earn on qualifying purchases.

From Prompts to Folders: Evolving AI Skill Design

Traditional AI prompt engineering often involves writing and reusing short instructions, which can lead to inconsistent results and poor scalability. Recent developments, including Anthropic’s internal experiments, suggest a shift toward organizing knowledge into folders that contain all necessary assets for a specific task or process.

Anthropic’s insights build on earlier work in prompt engineering but emphasize that the real power lies in bundling instructions, code, and reference materials into a single, discoverable unit. This approach aligns with broader trends in enterprise AI, where reliability, repeatability, and institutional memory are paramount.

Prior to this, most organizations relied on ad-hoc prompts or static documentation, which proved insufficient for scaling complex AI applications. The concept of Skills as folders offers a way to formalize and version operational knowledge, making AI deployment more akin to software engineering.

“Treating Skills as folders transforms how organizations embed tribal knowledge, guardrails, and scripts into AI systems, making behaviors consistent and scalable.”

— Thorsten Meyer, AI researcher

Amazon

AI scripting and instruction management tools

As an affiliate, we earn on qualifying purchases.

As an affiliate, we earn on qualifying purchases.

Unclear Aspects of Skills Implementation and Scalability

It is not yet confirmed how broadly applicable this approach is across different industries or AI models outside Anthropic’s internal environment. The long-term maintenance and evolution of Skills, especially in dynamic operational contexts, remain to be tested at scale. Additionally, the precise tooling and workflows needed for organizations to adopt this model widely are still under development.

AI Engineering: Building Applications with Foundation Models

AI Engineering: Building Applications with Foundation Models

As an affiliate, we earn on qualifying purchases.

As an affiliate, we earn on qualifying purchases.

Next Steps for Enterprise Adoption of Folder-Based Skills

Organizations are expected to start experimenting with organizing their AI knowledge into folder-based Skills, guided by Anthropic’s framework. Future developments may include dedicated tools for creating, managing, and versioning Skills, as well as industry-specific templates. Monitoring how these Skills perform in real-world operational settings will determine their scalability and impact.

AI Prompts For Real Estate Contracts, Offers, Disclosures And Inspections: Plain-language 170+ AI prompts that protect your clients, save you hours, and close more deals.

AI Prompts For Real Estate Contracts, Offers, Disclosures And Inspections: Plain-language 170+ AI prompts that protect your clients, save you hours, and close more deals.

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 consistency?

By bundling instructions, scripts, and reference materials into a single container, Skills ensure that the AI performs tasks in a standardized way, reducing variability across users and instances.

What are the main categories of Skills identified by Anthropic?

Anthropic categorizes Skills into nine types, including data fetching, verification, automation, code scaffolding, review, deployment, runbooks, and infrastructure operations.

Can this approach be applied outside of Anthropic?

While promising, the approach’s effectiveness in other organizations depends on their ability to develop and manage complex folder-based assets, which is still under exploration.

What technical lessons did Anthropic learn about designing Skills?

Effective Skills avoid restating obvious information, focus on non-obvious, specific content, and include precise trigger descriptions to match user requests accurately.

Source: ThorstenMeyerAI.com

You May Also Like

Best VPN for Streaming World Cup: Tested on July 1st.

A comprehensive test of top VPNs for streaming the World Cup was conducted on July 1st, revealing which services offer the best performance and reliability.

Immich 3.0

Immich 3.0 introduces new features and improvements to its open-source photo backup platform, enhancing user experience and security.

The 27% Problem: Why Google Wrote a $750M Check to Catch Anthropic

Google commits $750 million to boost enterprise AI, aiming to surpass Anthropic’s 40% market share and reshape AI distribution dynamics.

One Model, a Whole Portfolio: What Ten Days on Fable Mean for a Business Building on Frontier AI

A developer ran nearly all their projects through Anthropic’s Claude Fable 5 for ten days, demonstrating the model’s ability to manage a diverse portfolio, but facing a government shutdown.