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 organizing AI capabilities into reusable ‘Skills’—structured folders with instructions, scripts, and data—improves consistency, onboarding, and institutional knowledge. This approach shifts AI prompting from ad-hoc to durable operational procedures.

Anthropic has revealed that its internal approach to AI capabilities involves organizing ‘Skills’ as folders containing instructions, scripts, and data, rather than simple prompts. This shift aims to make AI workflows more consistent, maintainable, and scalable, transforming ad-hoc prompting into durable organizational assets. The company shared these insights through a detailed write-up from a Claude Code engineer, emphasizing the practical benefits of this method for engineering teams and businesses alike.

According to Anthropic, a Skill is not merely a saved prompt but a comprehensive folder that includes instructions, reference documents, runnable scripts, templates, data, configuration, and hooks. This structure allows AI agents to discover, read, and execute the contents of the folder, effectively turning organizational knowledge into actionable workflows.

Anthropic’s internal experience shows that these Skills help standardize output, reduce onboarding time, and improve over time through continuous refinement. The company categorizes its Skills into nine types, ranging from library references and product verification to infrastructure operations, with verification identified as the most valuable for ensuring quality.

Technical lessons from Anthropic highlight that effective Skills avoid restating obvious information, focus on non-obvious, specific content, and include critical ‘Gotchas’— traps or pitfalls learned from experience. The description of each Skill acts as a trigger for the agent, ensuring accurate matching to user requests, and scripts contain helper functions and code snippets to automate tasks.

At a glance
reportWhen: published recently, based on Anthropic’…
The developmentAnthropic shared insights from running hundreds of ‘Skills’ internally, revealing a new approach to organizing AI workflows as folders rather than prompts.
Crypto market snapshot
Fear & Greed Index
24/100 — Extreme Fear
Bitcoin BTC$63,022▲ 0.6%
Ethereum ETH$1,771▲ 0.5%
Tether USDT$0.999▼ 0.0%
BNB BNB$581.98▲ 2.0%
USDC USDC$0.9998▼ 0.0%
XRP XRP$1.14▲ 0.3%
Solana SOL$80.34▼ 0.0%
TRON TRX$0.329▲ 1.4%
Live data · CoinGecko · alternative.me (24h change)
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

Transforming AI Workflows into Organizational Assets

This approach shifts AI from being a tool for quick prompts to a core part of organizational operations. By packaging knowledge into Skills, companies can achieve more consistent results, accelerate onboarding, and build a cumulative library of institutional knowledge. The strategy also enables continuous improvement, as Skills evolve with each edge case and real-world application, making them valuable assets over time.

For businesses, this means AI can become a reliable process executor, reducing manual effort and error. It also encourages a shift in how organizations think about AI capabilities—viewing them as structured, versioned assets rather than fleeting prompts or notes.

AI Workflow Automation for Bloggers: Build a Simple Content System to Research, Write, Optimize, and Repurpose Posts Faster with AI and No-Code Tools (AI Toolkit for Bloggers 2026 Book 8)

AI Workflow Automation for Bloggers: Build a Simple Content System to Research, Write, Optimize, and Repurpose Posts Faster with AI and No-Code Tools (AI Toolkit for Bloggers 2026 Book 8)

As an affiliate, we earn on qualifying purchases.

As an affiliate, we earn on qualifying purchases.

From Prompt Engineering to Organizational Infrastructure

Traditionally, AI teams have relied on prompt engineering—crafting specific instructions for each task. Anthropic’s internal experience suggests that this ad-hoc method leads to inconsistency and difficult maintenance. Their recent publication emphasizes that organizing AI capabilities as folders containing instructions and scripts creates a more durable, scalable infrastructure.

The concept builds on prior practices but formalizes them into a structured system. Anthropic’s internal cataloging identified nine categories of Skills, from data analysis to deployment, highlighting the broad applicability of this approach across operational domains. This development aligns with broader trends toward treating AI workflows as software assets rather than ephemeral prompts.

“A Skill is a container for how your organization actually does a thing — with the tribal knowledge, the guardrails, and the tools bundled in.”

— Thorsten Meyer, AI researcher at Anthropic

Handbook of Research on Scripting, Media Coverage, and Implementation of E-learning Training in Lms Platforms

Handbook of Research on Scripting, Media Coverage, and Implementation of E-learning Training in Lms Platforms

As an affiliate, we earn on qualifying purchases.

As an affiliate, we earn on qualifying purchases.

Unclear Aspects of Skills Implementation and Adoption

It is not yet clear how broadly this approach has been adopted outside Anthropic or how easily other organizations can implement similar systems. Details on the tooling, integration complexity, and cost of building comprehensive Skills libraries remain unspecified. Additionally, the long-term effectiveness and maintenance requirements of this approach are still to be evaluated as more organizations experiment with it.

Amazon

AI knowledge organization folders

As an affiliate, we earn on qualifying purchases.

As an affiliate, we earn on qualifying purchases.

Next Steps for Broader Adoption and Validation

Organizations interested in this approach should assess their own workflows and identify potential Skills categories. Further research and case studies are expected to emerge as companies adopt this model, testing its scalability and impact on productivity. Anthropic may also develop tooling or frameworks to facilitate the creation and management of Skills, making this approach more accessible.

Meanwhile, AI developers and business leaders will watch for real-world results and refinements to this methodology, potentially shaping future best practices for AI operational management.

Enhanced Living Environments: Algorithms, Architectures, Platforms, and Systems (Lecture Notes in Computer Science Book 11369)

Enhanced Living Environments: Algorithms, Architectures, Platforms, and Systems (Lecture Notes in Computer Science Book 11369)

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

A Skill is a structured folder containing instructions, scripts, reference documents, data, and hooks that define how an AI agent performs a specific task or process.

How does organizing Skills as folders improve AI workflows?

It makes workflows more consistent, maintainable, and scalable by bundling all necessary knowledge and tools in a single, discoverable container, rather than relying on ad-hoc prompts.

Can this approach be adopted by other organizations?

While promising, the approach’s scalability and ease of implementation outside Anthropic are still unproven. Organizations will need to evaluate their own workflows and resources.

What are the main benefits of Skills over traditional prompting?

Skills improve output consistency, reduce onboarding time, and allow continuous refinement, turning AI capabilities into durable organizational assets.

What challenges might organizations face in implementing Skills?

Potential challenges include tooling complexity, maintaining and updating Skills libraries, and ensuring proper integration with existing workflows.

Source: ThorstenMeyerAI.com

Nothing in this article is financial or investment advice. Cryptocurrency and precious-metal investments carry significant risk — do your own research and consider a licensed advisor.
You May Also Like

What Intent-Centric Trading Means in DeFi

Keen on aligning your DeFi actions with your goals? Discover how intent-centric trading reshapes your investment journey and why it matters.

Discover S1: Openai O1’S Surprisingly Affordable Powerhouse Contender, All for Under $50.

Harness the power of S1, OpenAI’s affordable AI contender, and explore the potential it unlocks for researchers and developers everywhere. What could this mean for the future?

Understanding DeFi’s Composability: Risks and Rewards

Just how does DeFi’s composability unlock innovation while posing unique risks? Discover the critical balance in this insightful exploration.

7 Best PC Processors for Prime Day Deals in 2026

Discover the best PC processors to buy during Prime Day 2026, with expert analysis on value, performance, and upgrade paths for all budgets.