📊 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 the understanding of AI Skills from prompts to folders containing instructions, scripts, and references. This approach enhances consistency, onboarding, and institutional knowledge. The company ran hundreds of these Skills internally, demonstrating their value as organizational assets.
Anthropic has redefined what constitutes an AI Skill, emphasizing that it is a folder rather than a prompt. This new understanding stems from the company’s experience running hundreds of Skills internally, which has implications for how organizations develop, share, and maintain AI capabilities. The approach aims to create durable, reusable assets that improve consistency, onboarding, and institutional memory within AI teams.
According to a write-up from an Anthropic Claude Code engineer, a Skill is not simply a saved prompt but a folder containing instructions, reference documents, scripts, templates, data, and configuration. The agent can discover and execute the contents of this folder, making Skills more like containers of organizational knowledge than static prompts.
Anthropic’s internal experience shows that Skills help standardize output, reduce onboarding time, and improve over time as they are refined through repeated use. The company identified nine categories of Skills, ranging from library references and product verification to infrastructure operations, with verification being the most impactful.
Building effective Skills involves avoiding redundancy, focusing on non-obvious, specific instructions, and including ‘Gotchas’—traps or pitfalls that the agent must avoid. The description of each Skill acts as a trigger, matching user requests with the appropriate Skill based on language and internal slang, ensuring the agent activates the right container for the task.
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 for AI Development and Organizational Knowledge
This approach transforms how companies build and maintain AI capabilities, turning Skills into valuable, evolving assets that encode organizational procedures, tribal knowledge, and best practices. It shifts the focus from ad-hoc prompt engineering to durable, reusable containers, potentially improving consistency, reducing onboarding costs, and enabling continuous refinement. For organizations investing heavily in AI automation, this method could lead to more reliable and scalable systems, but it also requires a cultural shift toward managing Skills as organizational assets.AI development folder templates
As an affiliate, we earn on qualifying purchases.
As an affiliate, we earn on qualifying purchases.
From Prompt Engineering to Containerized Skills in AI Workflows
Until now, most teams using AI coding agents relied on repeated prompt engineering—crafting and reusing prompts for different tasks. Anthropic’s internal experience suggests that this approach is limited in scalability and durability. The company’s recent documentation emphasizes that Skills, as folders containing instructions and scripts, are a more effective way to embed organizational knowledge into AI systems.
Anthropic’s insights come after running hundreds of Skills internally, allowing the company to identify nine core categories and refine their design principles. This move aligns with broader trends toward institutionalizing AI capabilities and making them part of standard operating procedures rather than ad-hoc prompts.
“A Skill is a folder, not just a prompt. It’s a container for instructions, scripts, and knowledge that the agent can discover and execute.”
— Thorsten Meyer, AI researcher at Anthropic
AI instruction and script management tools
As an affiliate, we earn on qualifying purchases.
As an affiliate, we earn on qualifying purchases.
Unclear Aspects of Skill Implementation and Scaling
While Anthropic’s internal experience demonstrates the benefits of folder-based Skills, it is not yet clear how easily this approach can be adopted by other organizations or scaled across different AI systems. Details about the specific processes for creating, managing, and updating Skills at scale remain limited, and the long-term effectiveness of this method is still being evaluated.
AI knowledge base organization software
As an affiliate, we earn on qualifying purchases.
As an affiliate, we earn on qualifying purchases.
Next Steps for Broader Adoption and Refinement
Organizations interested in this approach should begin cataloging their internal procedures into Skills, focusing on non-obvious instructions and ‘Gotchas.’ Future developments may include tooling for easier creation, versioning, and sharing of Skills across teams. Anthropic is likely to continue refining its internal process and share lessons learned to facilitate wider adoption.
AI agent configuration folders
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 folder containing instructions, scripts, and knowledge, acting as a reusable container for organizational procedures, rather than a one-time prompt or instruction text.
What benefits does this approach offer?
Skills improve output consistency, reduce onboarding time, and enable continuous refinement, making AI systems more reliable and aligned with organizational processes.
Can this method be applied outside of AI coding agents?
Yes, the concept of containerized, reusable organizational assets can potentially be adapted to other AI applications and operational workflows.
What challenges might organizations face in adopting this approach?
Challenges include developing effective Skills, managing version control, and integrating this method into existing workflows without excessive overhead.
Will Skills replace prompt engineering entirely?
Skills aim to supplement prompt engineering by creating more durable, maintainable assets, but prompt design may still play a role in specific contexts.
Source: ThorstenMeyerAI.com
