📊 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 ‘Skills’ structured as folders containing instructions and assets. This method improves consistency, onboarding, and scalability for AI agents. The company shared insights from running hundreds of Skills internally, emphasizing their role as institutional assets.
Anthropic has announced a fundamental shift in how organizations should develop and deploy AI capabilities, emphasizing that Skills are not just prompts but structured folders containing instructions, scripts, and assets. This approach aims to make AI behavior more consistent, scalable, and easier to maintain, based on lessons learned from running hundreds of Skills internally.
According to a detailed write-up from an Anthropic Claude Code engineer, a Skill is best understood as a folder—one that can include instructions, reference documents, scripts, templates, data, and configuration—rather than a simple prompt. This redefinition changes how developers design and organize AI workflows, shifting from ad-hoc prompting to building reusable, versioned containers for institutional knowledge.
Anthropic’s internal experience revealed that Skills can be categorized into nine types, ranging from library references to operational runbooks. The most valuable Skills, according to the company, are those focused on verification—ensuring output quality and catching errors—since they significantly improve reliability. The company advocates investing engineer time into creating high-quality Skills, viewing them as assets that improve with use and iteration.
Technical lessons emphasize that effective Skills avoid stating what the model already knows, instead focusing on non-obvious, organization-specific details. The description of each Skill acts as a trigger for the agent, matching user requests with relevant Skills based on precise wording and internal slang, ensuring proper activation.
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.
How Skills Reshape Organizational AI Deployment
This approach marks a shift from ephemeral prompt engineering to durable, asset-based management of AI workflows. By treating Skills as structured folders, organizations can improve output consistency, reduce onboarding time, and build a scalable library of institutional knowledge. This method also enables continuous improvement, as Skills evolve through iterative refinement, making AI deployment more reliable and aligned with business processes.
AI workflow organization tools
As an affiliate, we earn on qualifying purchases.
As an affiliate, we earn on qualifying purchases.
From Prompting to Asset Management in AI Development
Until now, most organizations relied on prompt engineering—crafting specific instructions for each task. Anthropic’s internal experience with hundreds of Skills demonstrated that organizing knowledge into folders containing scripts and reference materials creates more durable and scalable AI systems. The concept of Skills as containers aligns with broader trends toward modular, reusable AI components, and reflects a maturation of enterprise AI practices.
This development is rooted in Anthropic’s efforts to improve output reliability and operational efficiency, moving beyond ad-hoc prompts towards structured, versioned assets that can be shared and refined across teams.
“A Skill is not just a prompt; it’s a folder—containing instructions, scripts, and assets that form the backbone of organizational AI capabilities.”
— Thorsten Meyer, AI researcher at Anthropic
AI development folder templates
As an affiliate, we earn on qualifying purchases.
As an affiliate, we earn on qualifying purchases.
Unclear Aspects of Skill Adoption and Scaling
It is not yet clear how broadly organizations will adopt this folder-based approach outside of Anthropic or how quickly Skills can be standardized across different industries. The practical challenges of creating, maintaining, and updating Skills at scale remain to be fully explored, including integration with existing workflows and tools.
AI instruction scripting software
As an affiliate, we earn on qualifying purchases.
As an affiliate, we earn on qualifying purchases.
Next Steps for AI Teams and Organizational Adoption
Organizations interested in this approach should evaluate their current knowledge management and automation strategies, considering how to structure Skills as folders. Future developments may include tooling improvements for creating, versioning, and sharing Skills across teams, as well as empirical studies on the impact of Skills on reliability and efficiency. Anthropic is likely to continue refining its internal Skills library and share best practices for broader adoption.
AI asset management software
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, templates, and configuration data that collectively define how an AI agent performs a specific task or process.
How does this approach improve AI deployment?
By organizing knowledge into reusable, versioned folders, Skills enhance consistency, reduce onboarding time, and allow continuous improvement through iterative refinement, making AI systems more reliable and maintainable.
Is this method applicable outside Anthropic?
While initially developed within Anthropic, the concept of treating Skills as structured assets has potential for broader adoption, especially in enterprise settings seeking scalable AI automation and knowledge management.
What are the challenges of implementing Skills as folders?
Challenges include creating standardized templates, maintaining version control, ensuring proper activation through descriptions, and integrating Skills into existing workflows and tools at scale.
Will this approach replace prompt engineering entirely?
Not necessarily; it shifts prompt engineering toward building and managing structured assets that can be reused and refined, complementing traditional prompt design rather than replacing it entirely.
Source: ThorstenMeyerAI.com
