A Skill Is a Folder, Not a Prompt: What Anthropic Learned Running Hundreds of Them
AIThis post was created with the assistance of artificial intelligence (AI).

📊 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 building AI skills as folders containing instructions, scripts, and assets leads to more durable, reusable, and effective organizational capabilities. This approach shifts the focus from prompts to structured containers, improving consistency and onboarding.

Anthropic has announced that its AI Skills are structured as folders, not prompts, a shift that enhances reusability, consistency, and institutional knowledge. This approach, derived from running hundreds of Skills internally, offers a new model for organizations deploying AI agents, making capabilities more durable and scalable.

In a recent publication, Anthropic’s Claude Code engineer outlined that a Skill is fundamentally a folder containing instructions, reference documents, scripts, templates, and configuration data, rather than a simple prompt stored in a text file. This redefinition enables AI agents to discover, read, and execute complex routines, embedding organizational knowledge directly into operational assets.

This method contrasts sharply with traditional prompt engineering, which treats prompts as ephemeral instructions. Instead, Skills serve as containers for how an organization accomplishes specific tasks, ensuring output consistency regardless of who runs the agent. They also significantly reduce onboarding time by codifying tribal knowledge and guardrails, making it accessible and automatable.

At a glance
reportWhen: published recently, with ongoing implem…
The developmentAnthropic published a detailed report on their approach to developing AI Skills as folders, sharing lessons from running hundreds of them internally.
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 Capabilities into Organizational Assets

This development matters because it shifts the paradigm from ad-hoc prompt tuning to building durable, reusable assets that encode operational knowledge. Organizations can now develop comprehensive Skills libraries that improve consistency, reduce errors, and facilitate onboarding. The approach also promotes continuous improvement, as Skills can be refined iteratively based on edge cases and real-world use.

For businesses, this means AI deployment becomes more reliable and scalable, with capabilities that evolve over time as Skills are improved. It also encourages viewing AI tools as integral parts of workflows, not just temporary prompts, unlocking new levels of automation and operational efficiency.

Amazon

AI development folder structure tools

As an affiliate, we earn on qualifying purchases.

As an affiliate, we earn on qualifying purchases.

From Prompt Engineering to Structured Asset Development

Traditionally, organizations have relied on prompt engineering—crafting specific instructions for AI models on a case-by-case basis. This approach is often brittle, requiring frequent re-tuning, and does not embed organizational knowledge or guardrails effectively.

Anthropic’s new approach, detailed in their recent publication, emphasizes creating Skills as structured folders, a concept inspired by internal practices where hundreds of such units are used to standardize workflows across engineering teams. This shift reflects a broader movement toward treating AI capabilities as assets that can be versioned, shared, and improved systematically.

“Viewing Skills as folders containing instructions and scripts fundamentally changes how organizations build and maintain AI capabilities.”

— Thorsten Meyer, AI expert

MixPad Free Multitrack Recording Studio and Music Mixing Software [Download]

MixPad Free Multitrack Recording Studio and Music Mixing Software [Download]

  • Multitrack Recording and Mixing: Create mixes with audio, music, and voice tracks
  • Track Customization: Apply effects and editing tools to tracks
  • Music Creation Tools: Includes Beat Maker and MIDI Creator

As an affiliate, we earn on qualifying purchases.

As an affiliate, we earn on qualifying purchases.

Unclear Aspects of Scaling and Implementation

It is not yet clear how widely adopted this approach will be outside Anthropic or how easily other organizations can replicate the process. Details about the tooling, integration, and maintenance of Skills libraries at scale remain under development. The long-term impact on AI safety, control, and adaptability also requires further observation.

Asset Protection: Pure Trust Organizations

Asset Protection: Pure Trust Organizations

As an affiliate, we earn on qualifying purchases.

As an affiliate, we earn on qualifying purchases.

Next Steps in Developing and Adopting Skills Frameworks

Organizations interested in this approach should evaluate their internal workflows and tribal knowledge to identify potential Skills. Further, there will likely be new tools and standards emerging to facilitate Skills creation, versioning, and sharing. Anthropic may also publish more detailed best practices and case studies as the approach matures.

Monitoring how other AI developers adopt this model and its impact on operational reliability will be key in the coming months.

Building Smarter Teams with Notion AI: Create AI-Powered Knowledge Bases, Project Systems, SOPs, and Collaborative Workspaces

Building Smarter Teams with Notion AI: Create AI-Powered Knowledge Bases, Project Systems, SOPs, and Collaborative Workspaces

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 structured, comprehensive, and reusable assets that encode detailed instructions, reference material, and scripts, leading to more consistent and reliable outputs.

Can this approach be applied outside of Anthropic?

Potentially, yes. Organizations with complex workflows and tribal knowledge could benefit from structuring their AI capabilities as Skills, but implementation details and tooling are still evolving.

What are the main advantages over traditional prompt engineering?

Skills as folders enable durability, version control, easier onboarding, and continuous improvement, reducing the brittleness and ephemeral nature of prompt-based instructions.

Are there any risks or downsides to this approach?

The complexity of managing Skills libraries and ensuring proper updates and versioning could pose operational challenges. Further research is needed on scalability and safety implications.

Source: ThorstenMeyerAI.com

You May Also Like

WSL 2 is getting faster Windows file system access

Microsoft has introduced a new DMA pool allocation in WSL 2, enhancing cross-OS file access performance, especially for file-heavy workflows.

Is Windows Search Better Than Ever? Microsoft’s Latest Fixes Make A Difference

Microsoft is testing updates to Windows Search that prioritize local files and apps, aiming for faster, cleaner results and optional web search removal.

Anthropic announces 200K context fine-tuning

Anthropic announces new fine-tuning capability enabling AI models to process 200,000 tokens, enhancing context handling for large language models.

What it feels like to work with Mythos

A detailed account of working with Mythos’ first public AI model, Claude 5 Fable, highlighting its capabilities, challenges, and implications for AI-human collaboration.