📊 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 shared insights from running hundreds of ‘Skills’ internally, emphasizing that Skills are folders containing instructions and assets, not just prompts. This approach improves consistency, onboarding, and institutional knowledge for AI agents.
Anthropic has announced a new approach to developing AI capabilities, emphasizing that Skills are structured as folders containing instructions, scripts, and reference assets, rather than simple prompts. This shift aims to create durable, reusable organizational assets that improve consistency and knowledge sharing across teams. The company has tested this method internally by running hundreds of Skills, which serve as standardized units of operational knowledge for AI agents.
In a detailed write-up from a Claude Code engineer, Anthropic explains that a Skill is fundamentally a container—akin to a folder—that can include instructions, reference documents, scripts, templates, and hooks. Unlike prompts, which are ephemeral and often retyped daily, Skills are designed to be versioned assets that encapsulate how tasks are performed within the organization. This approach transforms ad-hoc prompting into a durable, institutional capability, allowing teams to share and improve Skills over time.
Anthropic identified nine categories of Skills, ranging from library references and data analysis to business process automation and infrastructure operations. The most valuable, according to the company, is verification—checking the quality of generated output—since it directly impacts output reliability. The company advocates for investing significant effort into building high-quality Skills, viewing them as assets that grow sharper with use and iteration.
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 Capabilities into Reusable Organizational Assets
This approach signifies a fundamental shift in how organizations develop and maintain AI systems. By treating Skills as structured, versioned folders, companies can standardize procedures, reduce onboarding time, and cultivate institutional memory. The method also enables continuous improvement, as Skills evolve through iterations based on real-world edge cases, making AI deployment more reliable and scalable.
For businesses, this means moving beyond one-off prompts toward a systematic, asset-based approach that can be shared across teams and projects. It enhances consistency in AI output, reduces reliance on individual knowledge, and creates a foundation for more sophisticated automation and quality control processes. As a result, organizations can better leverage AI as a core operational tool rather than a ad-hoc experiment.
AI development folder structure tools
As an affiliate, we earn on qualifying purchases.
As an affiliate, we earn on qualifying purchases.
From Prompting to Structured Knowledge Management
Anthropic’s internal experiments with hundreds of Skills reveal that organizations often rely on repetitive prompt engineering, which is inefficient and fragile. The company’s new methodology stems from recognizing that prompts are ephemeral, whereas Skills—structured folders containing instructions, scripts, and assets—serve as durable, reusable building blocks. This insight aligns with broader industry trends toward modular, asset-based AI development.
Historically, AI teams have built capabilities through trial-and-error prompt tuning, which hampers scalability and consistency. Anthropic’s experience demonstrates that organizing institutional knowledge into Skills improves reliability and accelerates onboarding, as new team members can access comprehensive, versioned assets rather than scattered notes or unstructured prompts.
“A Skill is a folder that can contain instructions, reference documents, scripts, and hooks—it’s a container for how your organization actually does a thing, not just a prompt.”
— Thorsten Meyer, AI engineer at Anthropic
Generative AI Apps with LangChain and Python: A Project-Based Approach to Building Real-World LLM Apps
As an affiliate, we earn on qualifying purchases.
As an affiliate, we earn on qualifying purchases.
Unclear Aspects of Skill Implementation and Scalability
It is not yet clear how broadly this folder-based Skills approach can be adopted across different organizations or AI platforms. The specifics of integrating Skills into existing workflows, especially at scale, remain under development. Additionally, the process for maintaining, updating, and governing Skills over time is still being refined, and how this impacts long-term operational efficiency is uncertain.
Asset Management & AI: How AI integrates to optimize IT Asset Management
As an affiliate, we earn on qualifying purchases.
As an affiliate, we earn on qualifying purchases.
Next Steps for Broader Adoption and Standardization
Anthropic plans to further develop its Skills framework, potentially releasing tools and best practices for other organizations to adopt this model. Industry observers anticipate that more companies will experiment with structured asset-based approaches, and standardization efforts may emerge around Skills management. Monitoring how these practices influence AI reliability and operational automation will be key in the coming months.
AI-Assisted Creative Asset Version Control: Digital Content Management That Tracks Project Evolution
As an affiliate, we earn on qualifying purchases.
As an affiliate, we earn on qualifying purchases.
Key Questions
How is a Skill different from a prompt?
A Skill is a structured folder containing instructions, scripts, and assets, serving as a reusable, versioned unit of organizational knowledge. In contrast, a prompt is a simple text instruction that is often ephemeral and retyped.
What benefits does this approach offer?
It improves consistency of AI output, accelerates onboarding, captures institutional knowledge, and creates assets that improve with use. It also enables more reliable automation and quality control.
Can this model be applied outside of Anthropic?
While Anthropic developed this approach internally, the principles of structuring AI capabilities as reusable folders could be adapted by other organizations seeking more reliable and scalable AI deployment.
What challenges remain in implementing Skills broadly?
Integrating Skills into existing workflows, managing updates, and establishing governance are ongoing challenges. Scalability and cross-team collaboration are also areas needing development.
Will this approach reduce prompt engineering efforts?
Yes, by encapsulating knowledge into Skills, organizations can reduce repetitive prompt tuning and focus on improving the underlying assets, leading to more stable and maintainable systems.
Source: ThorstenMeyerAI.com
