📊 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 framing them as folders containing instructions, scripts, and assets. This approach enhances consistency, onboarding, and organizational knowledge retention, according to their internal findings.
Anthropic has redefined what constitutes an AI Skill, emphasizing that a Skill is a folder—containing instructions, scripts, and reference materials—rather than a prompt. This approach aims to make AI agent behaviors more durable, consistent, and easier to scale across organizations, according to a detailed internal report from Anthropic’s Claude Code team.
In a recent publication, Anthropic shared its experience from running hundreds of Skills within its engineering team, demonstrating that organizing these as folders rather than prompts significantly improves operational consistency and knowledge retention. Unlike prompts, which are often seen as static instructions, Skills as folders can include a variety of assets such as scripts, templates, data, and hooks, allowing agents to discover and execute complex workflows dynamically.
The shift from prompt-based to folder-based Skills is described as a fundamental change in design philosophy, enabling organizations to embed tribal knowledge, guardrails, and tools directly into their AI workflows. This method allows for versioned, sharable, and more durable asset management, effectively turning Skills into institutional assets that improve with use. Anthropic reports that investing engineering effort into refining a single Skill category can lead to significant gains in reliability and automation, with verification Skills identified as particularly impactful.
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.
“A Skill is just a clever markdown prompt you save in a file.”
A folder the agent can discover, read & run — instructions, scripts, references, templates, config & on-demand hooks.
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.
Implications of Folder-Based Skills for AI Operations
This development matters because it addresses key challenges in deploying AI at scale: ensuring consistent output, simplifying onboarding, and preserving organizational knowledge. By framing Skills as folders, companies can create more reliable and maintainable AI workflows, reducing the reliance on ad-hoc prompts and manual instruction updates. This approach also allows organizations to build a library of reusable, versioned assets that evolve over time, enhancing operational robustness and reducing errors.
For businesses, adopting folder-based Skills could lead to more predictable AI behavior, faster onboarding of new team members, and a scalable way to codify tribal knowledge. As AI deployment becomes more widespread, such structured asset management could become a standard practice, improving both efficiency and trust in AI systems.
AI workflow organization tools
As an affiliate, we earn on qualifying purchases.
As an affiliate, we earn on qualifying purchases.
Internal Experiments and the Nine Skill Categories Framework
Anthropic’s internal efforts involved cataloging Skills into nine categories, which serve as a gap-analysis tool for organizations. These include reference management, product verification, data analysis, automation, code scaffolding, review, deployment, runbooks, and infrastructure operations. The company’s findings emphasize that verification Skills—those that check and validate outputs—are among the most valuable, as they directly improve output quality.
Prior to this, most teams relied on prompt engineering, often reusing instructions with minor tweaks. Anthropic’s approach advocates for building durable, asset-based Skills that can be improved iteratively, turning ad-hoc prompts into institutional capabilities. This represents a shift from a reactive to a proactive, scalable model of AI management.
“Viewing Skills as folders containing instructions and assets transforms how organizations can build and maintain AI workflows.”
— Thorsten Meyer, AI researcher
AI asset management software
As an affiliate, we earn on qualifying purchases.
As an affiliate, we earn on qualifying purchases.
Unanswered Questions About Folder-Based Skills Implementation
It is not yet clear how broadly this approach has been adopted outside Anthropic or how it performs across different organizational contexts. Details on the specific technical implementations, such as integration with existing tools or workflows, remain limited. Additionally, the long-term impact of this method on AI safety and robustness is still under evaluation.
AI scripting and instruction 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 consider auditing their current AI workflows to identify opportunities for creating folder-based Skills. Further research and case studies are expected to emerge, validating the effectiveness of this method at scale. Anthropic and other AI developers may release more detailed technical guidelines and tools to facilitate adoption.
version control for AI assets
As an affiliate, we earn on qualifying purchases.
As an affiliate, we earn on qualifying purchases.
Key Questions
How does a Skill as a folder differ from a prompt?
A Skill as a folder contains instructions, scripts, data, and configuration assets, making it a reusable, versioned container for complex workflows, unlike a simple prompt which is just a text instruction.
What are the main benefits of this approach?
It improves output consistency, simplifies onboarding, and preserves institutional knowledge, enabling scalable and reliable AI deployment.
Is this approach applicable to all organizations?
While promising, its effectiveness depends on organizational size, complexity, and technical capacity. Broader validation is ongoing.
Will this change how AI models are trained or just how they are used?
This primarily affects how AI workflows are structured and maintained, not the core training process, but it influences deployment and operational practices.
Source: ThorstenMeyerAI.com
