📊 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 should be conceived as folders containing instructions, scripts, and assets, not just prompts. This approach enhances consistency, onboarding, and continuous improvement across organizations using AI agents.
Anthropic has disclosed that its internal approach to building AI Skills involves creating folders containing instructions, scripts, and reference materials, rather than relying solely on prompts. This shift aims to improve consistency, onboarding, and long-term development of AI capabilities, marking a significant change in how organizations can operationalize AI models.
In a detailed internal write-up, Anthropic explains that a Skill is fundamentally a folder—a container that can include instructions, reference documents, scripts, templates, configuration data, and hooks. Unlike traditional prompts, which are single instructions or questions, these folders enable AI agents to discover, read, and execute complex workflows, making them more reliable and maintainable.
Anthropic’s approach emphasizes that Skills are not just static prompts but assets that encapsulate how tasks are performed within an organization. This method allows for better output consistency across different users and roles, simplifies onboarding by codifying tribal knowledge, and supports iterative improvement as Skills evolve with new edge cases. The company highlights that its most valuable Skills focus on verification, ensuring output quality by catching mistakes before they reach end-users.
Furthermore, Anthropic identified nine categories of Skills, ranging from library references and product verification to infrastructure operations. The company advocates for investing significant engineer time into refining these Skills, viewing them as assets that appreciate in value over time, rather than costs. This paradigm shift aims to embed institutional knowledge directly into AI workflows.
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 Organizational Assets
This development matters because it redefines how companies can build, maintain, and scale AI systems. By treating Skills as structured folders, organizations can achieve greater reliability in AI output, reduce onboarding time for new team members, and create a continuously improving library of operational knowledge. This approach could lead to more predictable AI behavior and faster deployment of complex workflows, making AI a more integral part of enterprise processes.
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.
From Prompt Engineering to Structured Asset Management
Prior to this, most AI teams relied heavily on prompt engineering—crafting specific instructions for each task. While effective in the short term, this method often results in inconsistent outputs and poor scalability. Anthropic’s internal experiments with hundreds of Skills revealed that organizing knowledge into folders with scripts and reference materials leads to more durable and reusable capabilities. The concept aligns with broader trends toward modular, maintainable AI systems, but its explicit framing as folders is a novel insight.
Anthropic’s insights build on existing practices but push toward a more systematic, asset-based approach that captures tribal knowledge, guardrails, and operational procedures in a single container. This method is designed to support enterprise-scale AI deployment, where reliability and continuous improvement are paramount.
“A Skill is not just a prompt; it’s a folder that contains everything needed for the agent to perform a task reliably.”
— Thorsten Meyer, AI Developer at Anthropic
AI instruction and script folders
As an affiliate, we earn on qualifying purchases.
As an affiliate, we earn on qualifying purchases.
Unanswered Questions About Implementation and Scalability
It remains unclear how widely organizations will adopt this folder-based approach outside of Anthropic, and what challenges may arise in managing large Skills libraries. Details on how Skills are integrated with existing workflows, version control, and security protocols are still emerging. Additionally, the long-term impact on AI performance and maintenance costs has not been fully evaluated.
AI in Asset Management: Tools, Applications, and Frontiers
As an affiliate, we earn on qualifying purchases.
As an affiliate, we earn on qualifying purchases.
Next Steps for Organizations and AI Developers
Organizations interested in this approach should consider auditing their current AI workflows to identify knowledge that can be encapsulated in Skills. Further research and pilot programs will likely explore best practices for structuring Skills, automating updates, and integrating them into operational pipelines. Anthropic is expected to share more detailed case studies and tooling support in the coming months to facilitate adoption.
AI training and onboarding kits
As an affiliate, we earn on qualifying purchases.
As an affiliate, we earn on qualifying purchases.
Key Questions
How does a Skill as a folder differ from traditional prompt engineering?
A Skill as a folder contains multiple components—instructions, scripts, reference documents—making it a reusable, durable asset, unlike a prompt which is a single, often ephemeral instruction.
What are the benefits of organizing Skills as folders?
Benefits include improved consistency, easier onboarding, continuous improvement, and better management of tribal knowledge within AI workflows.
Will this approach work for all types of AI tasks?
While promising for operational and complex workflows, adoption may vary depending on task complexity and organizational capacity to manage structured assets.
What challenges might organizations face in implementing Skills as folders?
Potential challenges include managing version control, ensuring security, and integrating with existing systems and workflows.
Is this approach specific to Anthropic or applicable broadly?
While Anthropic developed and tested this internally, the principles are broadly applicable and could influence future best practices in AI deployment.
Source: ThorstenMeyerAI.com
