📊 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.
Get business pricing on tech for your team
- Business-only prices and quantity discounts
- Tax-exempt purchasing
- Multiple users, one account, clear invoices
TL;DR
Anthropic has demonstrated that effective AI Skills are better represented as folders containing instructions, scripts, and assets rather than simple prompts. This approach enhances consistency, onboarding, and long-term improvement in AI workflows, marking a shift in how organizations build and manage AI capabilities.
Anthropic has announced a new approach to building AI Skills, defining them as folders containing instructions, scripts, and assets rather than just prompts. This shift aims to create more durable, consistent, and scalable AI workflows within organizations, moving away from ad-hoc prompting towards institutionalized capabilities.
According to a detailed write-up from a Claude Code engineer, Anthropic’s internal experiments show that packaging knowledge into structured folders—called Skills—enables AI agents to discover, read, and execute complex workflows. These Skills include not only instructions but also reference documents, scripts, templates, and configuration data, making them more like organizational assets than simple prompts.
This approach improves output consistency across team members, simplifies onboarding by encapsulating tribal knowledge, and allows Skills to evolve and improve over time through iterative refinement. Anthropic’s internal analysis identified nine categories of Skills, ranging from library references to operational runbooks, with verification Skills identified as the highest-value for quality assurance.
Anthropic emphasizes that building Skills is a deliberate process, where quality depends on including non-obvious, specific instructions and ‘gotchas’—trap points for the AI—based on real-world experience. The description of each Skill acts as a trigger for the agent, ensuring relevant Skills activate reliably during tasks.
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 development signals a fundamental shift in how organizations design, deploy, and maintain AI systems. Moving from prompt-based interactions to structured Skills as folders transforms AI from a tool with fleeting prompts into a durable, institutional asset. It enhances consistency, reduces onboarding time, and enables continuous improvement, making AI workflows more reliable and scalable. For businesses, this approach could lead to more predictable AI outputs, better compliance with operational procedures, and a clearer path for internal knowledge sharing and automation.
As an affiliate, we earn on qualifying purchases.
From Prompt Engineering to Asset Building in AI Workflows
Until now, most teams using AI coding agents relied on prompt engineering—repeatedly retyping instructions or prompts to guide AI behavior. Anthropic’s recent insights challenge this paradigm by framing Skills as folders that contain all necessary knowledge and tools for specific tasks. This approach reflects a broader trend towards institutionalizing AI capabilities, similar to software assets stored in repositories, rather than ad-hoc prompt snippets.
Anthropic’s internal experiments, conducted over hundreds of runs, reveal that Skills can be refined iteratively, accumulating improvements and capturing tribal knowledge. The approach aligns with best practices in software engineering—versioning, documentation, and modularity—applied to AI workflows.
While the concept of Skills as folders is new, it builds on existing ideas of automation and modular design, now extended into AI agent management at scale. The focus on verification, quality, and continuous refinement marks a significant evolution in enterprise AI deployment.
“By packaging tribal knowledge into Skills, we turn ad-hoc prompts into institutional assets that improve over time.”
— Anthropic engineer involved in the project
As an affiliate, we earn on qualifying purchases.
Unresolved Questions About Implementation and Scalability
It remains unclear how widely this Skills-as-folders approach has been adopted outside Anthropic, and whether other organizations can replicate its success at scale. Details about the tooling, integration with existing systems, and how Skills are maintained long-term are still emerging. Additionally, the impact on AI transparency and explainability warrants further exploration, as the internal complexity of Skills may introduce new challenges.
As an affiliate, we earn on qualifying purchases.
Next Steps for Adoption and Industry Validation
Organizations interested in this approach should evaluate how to structure their own Skills folders, focusing on capturing tribal knowledge and automating workflows. Future developments may include standardized frameworks for Skills management, tools for versioning and testing, and industry-wide case studies demonstrating real-world benefits. Further research will clarify how this method scales across different AI applications and industries.
As an affiliate, we earn on qualifying purchases.
Key Questions
How does defining Skills as folders improve AI workflows?
It allows for more durable, consistent, and scalable AI operations by encapsulating instructions, scripts, and knowledge in a structured, discoverable format that can be refined over time.
What are the main categories of Skills identified by Anthropic?
They include library references, product verification, data analysis, business-process automation, code scaffolding, code review, deployment, runbooks, and infrastructure operations.
Can this approach be adopted by other organizations?
While promising, it remains to be seen how easily other organizations can implement and scale this approach. It requires a shift in mindset from prompt engineering to asset building and may depend on existing technical infrastructure.
What challenges might arise from using Skills as folders?
Potential challenges include managing version control, ensuring proper documentation, maintaining security, and integrating with legacy systems. Transparency and explainability may also become more complex.
Will this change how AI models are trained or just how they are used?
This primarily impacts how AI is used and maintained in operational settings, emphasizing structured knowledge assets over prompt-based interactions. It complements ongoing training efforts by providing durable procedural knowledge.
Source: ThorstenMeyerAI.com
Fall Picks
fall essentials
As an affiliate, we earn on qualifying purchases.
