📊 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 effective AI skills are better conceptualized as folders containing instructions and tools, not just prompts. This approach improves consistency, onboarding, and institutional knowledge sharing, marking a shift in how organizations deploy AI agents.
Anthropic has announced a significant shift in how organizations should design and deploy AI skills, emphasizing that Skills are folders, not prompts. This conceptual change, based on Anthropic’s internal experiments with hundreds of Skills, aims to make AI agent behavior more consistent, reusable, and aligned with organizational workflows. The development has implications for AI engineering, operational procedures, and enterprise knowledge management.
According to an internal write-up from a Claude Code engineer, Anthropic’s research shows that treating Skills as folders—containing instructions, reference documents, scripts, templates, and hooks—enables agents to discover, read, and execute complex workflows. This contrasts with the common approach of saving prompts as simple text snippets. The folder-based model allows for more durable, sharable, and versioned organizational assets, embedding tribal knowledge directly into AI systems.
Anthropic identified nine core categories of Skills, ranging from library references and product verification to infrastructure operations. The most impactful, according to Anthropic, is verification Skills, which check the quality of generated output, thus reducing errors and improving reliability. The company advocates investing engineering effort into refining these Skills, emphasizing their role in moving from ad-hoc prompting to institutionalized capabilities.
Technical lessons include avoiding restating obvious information, focusing on non-obvious, specific content, and creating trigger descriptions that match user requests precisely. Bundling real code, helper functions, and guardrails within the folder ensures the Skills are practical, robust, and adaptable to edge cases.
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 Skills into Organizational Assets
This approach shifts the perception of AI Skills from simple prompts to comprehensive, reusable containers that encode organizational knowledge and procedures. By doing so, it enhances output consistency, accelerates onboarding, and creates a living library of operational best practices. For businesses, this means AI becomes a more reliable partner, capable of executing complex workflows with minimal manual intervention. The strategy also encourages a long-term view, where Skills improve iteratively, becoming valuable assets that appreciate in organizational worth.
AI development folder structure tools
As an affiliate, we earn on qualifying purchases.
As an affiliate, we earn on qualifying purchases.
From Prompt Engineering to Organizational Knowledge
Prior to this development, AI teams primarily focused on crafting prompts—short, often ad-hoc instructions—to guide model behavior. While effective in the short term, this method proved fragile and difficult to scale across teams and processes. Anthropic’s internal experiments with hundreds of Skills revealed that encapsulating instructions, data, and scripts within folders leads to more durable and scalable AI deployment. This insight aligns with broader trends in enterprise AI, where embedding procedural knowledge directly into systems is increasingly valued.
Anthropic’s nine-category Skills map offers a framework for organizations to identify gaps in their automation and knowledge management efforts, from basic library references to complex operational workflows. The emphasis on verification and guardrails reflects a focus on reducing errors and ensuring safety in AI outputs.
“Treating Skills as folders containing instructions, scripts, and data fundamentally changes how we design and deploy AI agents. It moves us from ephemeral prompts to durable organizational assets.”
— Thorsten Meyer, AI researcher at Anthropic
AI Workflow Systems: AI Prompts for Freelance Consultants: Practical AI workflow prompts to automate client work, boost productivity, and scale consulting … Frameworks for the Modern World Book 1)
As an affiliate, we earn on qualifying purchases.
As an affiliate, we earn on qualifying purchases.
Unclear Aspects of Skill Implementation and Scalability
It remains uncertain how widely applicable this folder-based Skills model is across different industries and organizational sizes. The internal success at Anthropic may not directly translate to other contexts without adaptation. Additionally, the specific technical tooling and workflows required for effective implementation are still being developed and standardized. The long-term impact on AI safety, maintenance, and scalability also warrants further observation.
AI Engineering: Building Applications with Foundation Models
As an affiliate, we earn on qualifying purchases.
As an affiliate, we earn on qualifying purchases.
Next Steps for Adoption and Standardization
Organizations interested in this approach should begin cataloging their internal procedures and tribal knowledge into folder-based Skills, focusing initially on verification and operational workflows. Industry-wide, developers and vendors are likely to develop tools and frameworks to facilitate this model. Monitoring how Anthropic and others refine and scale this approach over the coming months will be key to understanding its broader impact on enterprise AI deployment and management.
AI Real Estate Playbook: How to Reclaim Your Time, Multiply Your Income, and Clone Yourself
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 reliability?
By encapsulating instructions, scripts, and reference data within a folder, the AI agent can access comprehensive, versioned knowledge, reducing errors caused by ambiguous prompts and improving consistency across tasks.
Can this approach be applied outside of Anthropic?
Yes, the folder-based model is adaptable but may require technical adjustments for different organizations. Its success depends on integrating these Skills into existing workflows and tooling.
What are the main categories of Skills identified?
They include library references, product verification, data analysis, automation, code scaffolding, review, deployment, runbooks, and infrastructure operations.
Does this mean prompts are obsolete?
Not necessarily. Prompts remain useful for quick, ad-hoc tasks, but the folder-based Skills provide a more durable, scalable foundation for complex, repeatable workflows.
What are the challenges of implementing Skills as folders?
Challenges include developing tooling for managing, updating, and discovering Skills, as well as ensuring consistency and security across organizational assets.
Source: ThorstenMeyerAI.com
