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 its approach from prompts to structured ‘Skills’—folders with instructions and assets—enhancing AI consistency and organizational knowledge. This marks a significant change in how AI capabilities are built and maintained.

Anthropic has publicly detailed a new approach to building AI capabilities, defining Skills as folders containing instructions, scripts, and reference materials, rather than simple prompts. This shift aims to make AI output more consistent, improve onboarding, and create a durable institutional knowledge base, marking a significant evolution in AI development practices.

In a detailed write-up, Anthropic explained that its team now treats Skills as comprehensive containers—folders that include instructions, reference documents, executable scripts, templates, and configuration data—allowing AI agents to discover, read, and execute within these structured assets. This contrasts with the traditional view of a Skill as a static prompt, offering a more flexible and durable framework.

The company shared that their internal experience shows Skills improve organizational efficiency by standardizing outputs across team members, compressing onboarding processes, and accumulating value as they evolve through iterative refinement. Anthropic categorizes Skills into nine types, including data fetching, verification, code scaffolding, and operational runbooks, with verification identified as the highest-value category.

Technical insights emphasize that effective Skills avoid restating obvious information, focus on non-obvious, organization-specific knowledge, and include ‘Gotchas’—trap points that prevent errors or misunderstandings. Proper description and scripting are critical, ensuring the agent activates the correct Skills in response to user requests.

At a glance
reportWhen: announced March 2024
The developmentAnthropic published insights from running hundreds of Skills internally, demonstrating a new model for organizing AI capabilities as folders rather than 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 for AI Development and Business Operations

This development signals a move toward more durable, reusable, and organization-specific AI capabilities, reducing ad-hoc prompt crafting and enabling consistent, scalable deployment of AI tools. For businesses, it offers a way to codify tribal knowledge, improve onboarding, and create a library of evolving best practices, ultimately making AI a more reliable asset.

By shifting from prompts to folders, organizations can better manage AI behaviors, enforce guardrails, and continuously improve capabilities through iterative updates. This approach could influence industry standards in AI development, especially in enterprise settings where reliability and knowledge retention are critical.

Amazon

AI development organization tools

As an affiliate, we earn on qualifying purchases.

As an affiliate, we earn on qualifying purchases.

From Prompt Engineering to Structured Asset Management

Prior to this, most organizations relied on prompt engineering—crafting specific instructions to elicit desired AI responses—often leading to inconsistent outputs and repeated effort in prompt creation. Anthropic’s new approach builds on their internal experience of running hundreds of Skills, which revealed that organizing knowledge and tools into structured folders yields better results.

This shift aligns with broader trends toward modular AI components and reusable assets, but Anthropic’s emphasis on treating Skills as comprehensive containers is a notable innovation. The company’s internal categorization into nine Skill types reflects a mature understanding of operational needs, from code generation to infrastructure management.

While the concept of Skills as folders is new publicly, it echoes longstanding practices in software engineering—using folders and modules to organize complex systems—adapted here for AI capabilities.

“Treating Skills as folders containing instructions, scripts, and reference data transforms how AI capabilities are built, maintained, and scaled.”

— Thorsten Meyer, AI researcher at Anthropic

Amazon

AI scripting and reference folder

As an affiliate, we earn on qualifying purchases.

As an affiliate, we earn on qualifying purchases.

Unclear Aspects of Skill Implementation and Adoption

It is not yet clear how widely this approach will be adopted outside Anthropic or how easily organizations can transition from prompt-based methods to structured Skills. Details about tooling, integration with existing workflows, and the long-term maintenance of Skills are still emerging. Additionally, the scalability and effectiveness of this model across different industries and use cases remain to be validated through broader deployment.

Amazon

AI knowledge management software

As an affiliate, we earn on qualifying purchases.

As an affiliate, we earn on qualifying purchases.

Next Steps in Organizational AI Asset Development

Anthropic plans to continue refining its Skills framework and promote its adoption internally, with potential for broader industry influence. Future developments may include standardized tools for creating, managing, and updating Skills, as well as case studies demonstrating tangible efficiency gains. Monitoring how other organizations adopt similar models will be key to understanding its impact on enterprise AI practices.

Amazon

AI onboarding documentation tools

As an affiliate, we earn on qualifying purchases.

As an affiliate, we earn on qualifying purchases.

Key Questions

How does organizing Skills as folders improve AI consistency?

Folders contain comprehensive instructions, scripts, and reference data, enabling AI agents to access a stable, organized knowledge base that reduces variability in responses and behavior.

What are the main categories of Skills identified by Anthropic?

Anthropic classifies Skills into nine types, including data fetching, verification, code scaffolding, runbooks, and infrastructure operations, with verification considered the most valuable.

Can this approach be applied outside of Anthropic?

While promising, it remains to be seen how easily other organizations can adopt this model, given differences in workflows, tooling, and organizational structure. The concept, however, offers a blueprint for more durable AI capabilities.

What is the most important lesson from Anthropic’s experience?

Effective Skills should focus on organization-specific, non-obvious knowledge and avoid restating what the model already knows, ensuring the AI acts on meaningful, actionable information.

Source: ThorstenMeyerAI.com

You May Also Like

Blockchain Used to Secure Supply Chains, Fighting Counterfeits Globally

Navigating global supply chains with blockchain enhances security and combats counterfeits, but the full impact of this technology is just beginning to unfold.

7 Best Graphics Card Prime Day Deals for PC Upgrades in 2026

Discover the best graphics card deals for PC upgrades during Prime Day 2026, including top picks for performance, value, and compact builds.

Évian and the Fallout: What Europe Actually Wants From Amodei, Hassabis, and Altman

Europe pushes for reliable access, sovereignty, and safety measures from AI giants Amodei, Hassabis, and Alt at the G7 summit in Évian.

When a Content Network Starts Publishing to Itself

A content network’s automated system started favoring a few sites, leading to uneven content spread and potential SEO issues, with fixes now underway.