📊 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 ‘Skills’ in AI agents are best conceptualized as folders containing instructions, scripts, and knowledge, not just prompts. This approach improves consistency, onboarding, and scalability of AI systems.
Anthropic has announced a significant shift in how AI agents are developed and maintained, emphasizing that Skills are not merely saved prompts but folders containing instructions, scripts, and knowledge. This approach, tested across hundreds of internal Skills, aims to standardize and improve the durability of AI-driven workflows, making them more reliable and easier to scale.
The core insight from Anthropic is that a Skill should be viewed as a container—a folder that includes not only prompts but also reference documents, executable scripts, templates, configuration files, and hooks. This redefinition moves away from the idea that Skills are just text prompts, emphasizing their role as comprehensive organizational assets.
Anthropic’s internal implementation involves cataloging Skills into nine categories, ranging from library references and data analysis to operational runbooks and automation. The most impactful category, according to the company, is verification Skills, which ensure the correctness of AI output by checking for mistakes and enforcing standards. This focus on verification has led to notable improvements in output quality and consistency.
Experts involved in the project note that this approach makes AI agents’ behavior more predictable and easier to onboard new team members, as the knowledge is embedded directly into the Skills folders. The process also allows continuous refinement, with Skills improving over time as edge cases are documented and addressed.
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.
Transforming AI Development with Modular Skills
This development matters because it shifts the paradigm from ad-hoc prompting to building durable, reusable organizational assets. By treating Skills as folders that encapsulate knowledge and tools, companies can achieve more consistent AI outputs, streamline onboarding, and create a scalable library of best practices. For organizations heavily reliant on AI automation, this approach could significantly reduce errors and operational risks, making AI deployment more reliable and manageable.
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.
From Prompt Engineering to Organizational Assets
Prior to this revelation, most AI teams relied on prompt engineering—crafting specific instructions for each task, often retyping or copying prompts. Anthropic’s internal experiments with hundreds of Skills have demonstrated that organizing knowledge into folders enhances robustness and reusability. This insight aligns with broader industry trends towards modular AI components but emphasizes the importance of comprehensive organizational design rather than isolated prompt tweaks.
The concept was developed through internal testing and documentation, with Anthropic’s engineers documenting their processes and categorizing Skills into nine distinct types. This methodology aims to replace brittle, one-off prompts with durable, versioned assets that reflect actual organizational workflows.
“A Skill is not just a prompt; it’s a folder containing instructions, scripts, and knowledge that can be discovered and executed by the agent.”
— Thorsten Meyer, AI engineer at Anthropic
Agentic Spec-Driven Development: A Practical Method for Using AI to Build Complete Specifications for Software, Products, and Knowledge Work
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 it will integrate with existing AI development pipelines. Details about the specific tooling, standards, or best practices for creating and managing Skills as folders remain under development, and industry-wide adoption may face challenges related to tooling and organizational change.
AI-Native Software Delivery: Proven Practices to Produce High-Quality Software Faster
As an affiliate, we earn on qualifying purchases.
As an affiliate, we earn on qualifying purchases.
Next Steps for Industry Adoption and Tooling Development
Anthropic plans to further refine its Skills framework and share best practices with the broader AI community. Future developments may include standardized tools for creating, versioning, and managing Skills as folders, as well as integration with popular AI development platforms. Industry observers expect other organizations to experiment with similar approaches, potentially leading to more modular, maintainable AI systems.
The Human-Agent Orchestrator: Leading and Scaling AI-Driven Organizations
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 encapsulating instructions, scripts, and knowledge in a structured container, Skills become more consistent, easier to update, and less prone to errors, leading to more reliable AI outputs.
What are the main categories of Skills identified by Anthropic?
Anthropic identified nine categories, including library references, data analysis, verification, automation, code scaffolding, review, deployment, runbooks, and infrastructure operations.
Will this approach work for all types of AI tasks?
While promising for automation and operational workflows, the effectiveness of folder-based Skills may vary depending on the complexity and domain of the AI application. Further testing is needed across different use cases.
What challenges might organizations face adopting this model?
Challenges include developing tooling for managing folder-based Skills, training teams to design effective containers, and integrating this approach into existing workflows and systems.
Source: ThorstenMeyerAI.com
