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 viewing AI skills as prompts to treating them as folders containing instructions, scripts, and knowledge assets. This approach enhances consistency, onboarding, and institutional memory within organizations. The company demonstrated this by running hundreds of such Skills internally, emphasizing their value as durable, reusable assets.

Anthropic has announced a significant shift in how organizations should think about AI Skills, moving away from prompts to treating Skills as folders containing instructions, scripts, and assets. This approach was derived from the company’s experience running hundreds of Skills internally, which has implications for consistency, onboarding, and institutional knowledge sharing across teams.

In a detailed write-up, Anthropic explained that a Skill is not simply a saved prompt; it is a folder that can include instructions, reference documents, scripts, templates, configuration, and hooks. This redefinition changes both technical design and business strategy, emphasizing that Skills are containers for how organizations actually perform tasks, not just prompts or notes. The company demonstrated that by running hundreds of Skills internally, they improved output consistency, reduced onboarding time, and built a library of reusable, improving assets.

Anthropic identified nine core categories of Skills, ranging from library and API references to infrastructure operations. The most impactful, according to the company, are verification Skills—those that check the work—because they directly improve output quality. The company advocates for investing significant engineering effort into developing high-quality Skills, viewing them as assets that appreciate over time, rather than costs.

At a glance
reportWhen: published recently; insights shared in…
The developmentAnthropic published insights from its internal use of hundreds of Skills, showing a new method of structuring AI capabilities as folders rather than prompts.
Crypto market snapshot
Fear & Greed Index
24/100 — Extreme Fear
Bitcoin BTC$62,972▲ 0.4%
Ethereum ETH$1,769▲ 0.4%
Tether USDT$0.999▼ 0.0%
BNB BNB$581.52▲ 1.8%
USDC USDC$0.9998▼ 0.0%
XRP XRP$1.14▲ 0.2%
Solana SOL$80.31▼ 0.1%
TRON TRX$0.3291▲ 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

Implications for Organizational AI Deployment

This development matters because it offers a new model for how companies can embed AI into their workflows more reliably. By packaging organizational knowledge into Skills as folders, companies can ensure consistent outputs, accelerate onboarding, and create a durable knowledge base. This approach shifts AI deployment from ad-hoc prompting to structured, versioned, and shareable assets, potentially transforming operational efficiency and quality control in AI-driven processes.

CANVA USER GUIDE FOR BEGINNERS: Mastering Design Tools to Create Stunning Social Media, Business Content and Presentations with Step-by-Step Instructions, Templates, AI Features and Video Editing

CANVA USER GUIDE FOR BEGINNERS: Mastering Design Tools to Create Stunning Social Media, Business Content and Presentations with Step-by-Step Instructions, Templates, AI Features and Video Editing

As an affiliate, we earn on qualifying purchases.

As an affiliate, we earn on qualifying purchases.

Background on AI Skills and Organizational Use

Prior to this, most organizations relied on prompt engineering—crafting specific instructions for each use case—without a standardized, reusable structure. Anthropic’s internal experience with hundreds of Skills revealed that treating Skills as folders improved consistency and learning over time. The company’s approach contrasts with the common practice of saving prompts as text snippets, instead emphasizing structured containers that include scripts, documentation, and configuration. This insight aligns with broader trends toward modular, maintainable AI assets in enterprise settings.

“A Skill is a folder that can contain instructions, reference documents, scripts, templates, and hooks—it’s a container for how your organization actually does a thing.”

— Thorsten Meyer, Anthropic engineer

Create a Podcast with AI (No Experience Needed) : A Step-by-Step Guide to Planning, Scripting, Recording, Editing, and Launching a Podcast Using ChatGPT, AI Tools, and Automation

Create a Podcast with AI (No Experience Needed) : A Step-by-Step Guide to Planning, Scripting, Recording, Editing, and Launching a Podcast Using ChatGPT, AI Tools, and Automation

As an affiliate, we earn on qualifying purchases.

As an affiliate, we earn on qualifying purchases.

Unanswered Questions About Skill Implementation

It is not yet clear how widely adopted this folder-based Skill approach will become outside Anthropic or how it will integrate with existing enterprise workflows. Details about the technical standards for Skills, their management, and how organizations will scale and govern them remain to be seen. Additionally, the long-term impact on AI performance and maintenance is still developing, and some industry experts question how this approach compares to traditional prompt engineering at scale.

Amazon

AI knowledge management software

As an affiliate, we earn on qualifying purchases.

As an affiliate, we earn on qualifying purchases.

Next Steps for Adoption and Development

Organizations interested in this approach should evaluate how to structure their internal Knowledge Assets as Skills, focusing on creating reusable, versioned containers. Anthropic plans to share more detailed best practices and tooling to facilitate this transition. Future developments may include standardized frameworks for Skills management and integration with enterprise AI platforms, as well as broader industry adoption and validation of this model.

Amazon

AI workflow automation assets

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?

By bundling instructions, scripts, and knowledge assets into structured folders, Skills enable more consistent, maintainable, and scalable AI deployment, reducing variability and errors.

Can this approach be applied to existing prompt-based systems?

Potentially, yes. Organizations can start by organizing their prompt libraries into more structured containers, gradually evolving toward folder-based Skills for better management.

What categories of Skills did Anthropic identify?

Anthropic identified nine categories, including library references, product verification, data analysis, automation, code scaffolding, review, deployment, runbooks, and infrastructure operations.

Is this approach suitable for all organizations?

This approach is most beneficial for organizations with complex workflows and institutional knowledge that can be effectively captured and reused as Skills. Smaller teams may find simpler prompt-based methods sufficient initially.

Will Anthropic provide tools to manage Skills as folders?

While not specified in detail, Anthropic plans to share best practices and tooling to facilitate Skills development and management at scale.

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

Quiet GPUs for Local AI: Acoustic and Thermal Roundup

A roundup of the quietest GPUs for local AI in 2026, focusing on acoustic and thermal performance, with practical recommendations for builders.

10 Best Gaming Laptops for High-Refresh Play in 2026

Discover the 10 best gaming laptops in 2026, balancing GPU power, display quality, and portability for high-frame-rate gaming.

Disk Is the Contract: Inside Threlmark’s Local-First Architecture

Threlmark’s innovative approach uses local disk files as the single source of truth, enabling portable, interoperable, and restartable project management without a database.

7 Best Tablet Stands and Docks for Prime Day Deals in 2026

Discover the best tablet stands and docks on Prime Day 2026, including options for desk, bed, and portable use, with detailed comparisons and buying tips.