📊 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 Skills for AI agents are best understood as folders containing instructions, scripts, and reference materials, not just prompts. This approach enhances consistency, onboarding, and institutional memory, marking a shift in how organizations develop and manage AI workflows.
Anthropic has announced a significant shift in how organizations should design AI agent capabilities, emphasizing that a Skill is a folder containing instructions, scripts, and reference materials, not just a prompt. This insight, derived from Anthropic’s internal experience running hundreds of Skills, aims to make AI outputs more consistent, improve onboarding, and build durable institutional knowledge, marking a notable advancement in enterprise AI deployment.
In a detailed write-up from a Claude Code engineer, Anthropic explained that Skills are structured folders that include instructions, reference documents, scripts, templates, data, and configuration files. This redefinition moves away from viewing Skills as simple prompts or markdown notes, instead framing them as comprehensive containers for organizational knowledge and operational procedures.
Anthropic’s internal experiments showed that this approach enhances output consistency, simplifies onboarding for new team members, and allows Skills to evolve and improve over time through iteration. The company identified nine categories of Skills, ranging from library referencing and product verification to infrastructure operations, with verification Skills deemed most valuable for quality control.
Building effective Skills involves avoiding redundancy, focusing on non-obvious content, and including ‘Gotchas’—trap points learned from experience—to prevent common errors. The process emphasizes that Skills should be designed to trigger based on detailed descriptions, including internal slang, ensuring they activate precisely when needed.
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.
How Skills Reshape Organizational AI Practices
This approach transforms AI deployment from ad-hoc prompting into structured, reusable organizational assets. By encapsulating tribal knowledge, guardrails, and scripts within Skills, companies can achieve more reliable outputs, streamline onboarding, and create a continuously improving library of operational procedures. This shift could lead to more scalable and maintainable AI systems across industries, reducing reliance on individual expertise and enabling better governance of AI workflows.
Blue Summit Supplies 50 Project File Folders, Reinforced Straight Cut Tab, 2 Inch Expansion Pocket, Preprinted Project Management Folder Design, Letter Size, Manila, 50 Pack
Expandable Project File Jackets with Preprinted Project Tracking Layout – Dedicated sections for project details, task tracking, follow-up…
As an affiliate, we earn on qualifying purchases.
As an affiliate, we earn on qualifying purchases.
From Prompt Engineering to Asset Building in AI
Traditionally, organizations have relied on prompt engineering—crafting specific instructions for each task—resulting in brittle, inconsistent outputs and high onboarding costs. Anthropic’s recent findings suggest a paradigm shift: treating Skills as comprehensive folders that encode organizational knowledge and procedures. This aligns with broader trends toward modular, maintainable AI systems and reflects lessons learned from internal experimentation with hundreds of Skills across different categories, such as code scaffolding, verification, and infrastructure management.
Prior to this, the industry lacked a formalized way to embed tribal knowledge into AI workflows systematically. Anthropic’s approach offers a blueprint for turning ad-hoc prompts into durable assets that evolve and improve over time, fostering organizational memory and operational resilience.
“A Skill is a folder — one that can contain instructions, reference documents, runnable scripts, templates, data, configuration, and even hooks that fire only while the Skill is active.”
— Thorsten Meyer, AI engineer at Anthropic
Drawing Cute Animals in Colored Pencil (Volume 1)
As an affiliate, we earn on qualifying purchases.
As an affiliate, we earn on qualifying purchases.
Unclear Aspects of Skills Implementation and Evolution
It is not yet clear how widely adopted this folder-based Skills approach will become outside Anthropic, or how organizations will standardize and govern the development of Skills at scale. Details on how Skills are maintained, versioned, or integrated into existing workflows remain to be seen, as well as how this approach compares in cost and complexity to traditional prompt engineering over the long term.
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 Organizations and AI Developers
Organizations interested in adopting this approach should begin cataloging their operational procedures, guardrails, and tribal knowledge into structured folders, focusing on key categories like verification and automation. Further research and case studies are expected to emerge as more companies experiment with Skills, with potential developments including standardized frameworks for Skills management, tooling support, and integration into enterprise AI platforms.
AI onboarding templates
As an affiliate, we earn on qualifying purchases.
As an affiliate, we earn on qualifying purchases.
Key Questions
What exactly is a Skill in Anthropic’s framework?
A Skill is a structured folder containing instructions, scripts, reference documents, templates, data, and configuration files that define how an AI agent performs a specific task or process.
How does this approach improve AI reliability?
By encapsulating tribal knowledge and operational guardrails within Skills, organizations can ensure more consistent outputs, reduce onboarding time, and create a durable knowledge base that evolves with the organization’s needs.
Can Skills be updated or improved over time?
Yes, Skills are designed to be iterative assets that can be refined and expanded as the organization learns and encounters new edge cases, making them a living part of the operational infrastructure.
Will this method replace prompt engineering entirely?
It is likely to complement prompt engineering by providing a more structured, maintainable way to embed organizational knowledge, but the extent of replacement remains to be seen as adoption grows.
What are the main challenges in adopting Skills as folders?
Challenges include establishing standards for organizing and maintaining Skills, integrating them into existing workflows, and managing version control and updates at scale.
Source: ThorstenMeyerAI.com
