📊 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 AI Skills should be viewed as folders containing instructions, scripts, and knowledge, not just prompts. This approach improves consistency, onboarding, and institutional memory. The insight emerged from running hundreds of Skills internally, emphasizing their value as reusable, evolving assets.
Anthropic has revealed that its AI Skills are best understood as folders containing instructions, scripts, and reference materials, rather than simple prompts. This shift in perspective, based on the company’s internal experience, aims to improve organizational consistency, onboarding, and knowledge retention in AI deployment. The insight underscores a move toward durable, reusable assets that encode how tasks are actually performed, not just how they are prompted.
According to a write-up from an Anthropic Claude Code engineer, a Skill is a container—essentially a folder—that includes instructions, reference documents, scripts, templates, data, configuration, and hooks. This structure allows AI agents to discover, read, and execute the contents, making Skills a robust asset for organizational tasks.
Anthropic’s internal experimentation with hundreds of Skills led to the realization that this approach enhances output consistency, simplifies onboarding, and allows Skills to improve over time through iteration. They cluster into nine categories, ranging from library references to infrastructure operations, with verification Skills identified as the most impactful for quality control.
The company emphasizes that a well-designed Skill captures non-obvious, organization-specific knowledge, and includes ‘gotchas’—traps and pitfalls that the agent must avoid. Proper description and scripting are critical, as the agent uses these descriptions as triggers to activate the Skills, making precise language essential.
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 Organizational AI Deployment
This approach transforms how companies can embed institutional knowledge into AI systems, making them more reliable, easier to onboard new staff, and capable of continuous improvement. By treating Skills as assets rather than prompts, organizations can standardize processes, reduce variability, and build a scalable knowledge base that evolves with their operations.
It signals a shift from ad-hoc prompt engineering to structured, maintainable systems that embed tribal knowledge directly into AI workflows, potentially setting new industry standards for enterprise AI deployment.
YvnShine 50 Pack Job Folder for Project Management, Heavy Duty Manila File Jacket 10×12 Inch, Preprinted Cost Tracking & Invoice Organization, Construction Project Management Files
- Project Management System: Organize work orders and project details
- Preprinted Tracking Tables: Includes cost calculation and milestone tracking
- Heavy Duty Construction Grade: Durable manila cardstock for job sites
As an affiliate, we earn on qualifying purchases.
As an affiliate, we earn on qualifying purchases.
Background on AI Skills and Organizational Knowledge
Most organizations using AI coding agents currently rely on manually crafted prompts, which are often retyped or rewritten for each task. Anthropic’s internal experience, shared publicly in a recent write-up, suggests that this method is inefficient and fragile. Instead, they advocate for creating Skills as folders that encapsulate all necessary instructions and assets, enabling consistent execution across tasks and personnel.
Prior to this, the industry primarily viewed prompts as ephemeral instructions, often leading to variability and onboarding challenges. Anthropic’s experimentation with hundreds of Skills revealed that organizing knowledge into reusable containers significantly enhances operational stability and learning.
“Viewing Skills as folders containing instructions and scripts fundamentally changes how organizations can deploy AI capabilities.”
— Thorsten Meyer, AI researcher
Remaining Questions About Skill Implementation
It is not yet clear how broadly this approach has been adopted outside Anthropic or how easily other organizations can transition to this model. Details on the specific technical requirements, integration challenges, and scalability remain to be seen as more companies experiment with this framework.
Next Steps for Organizations Adopting Skills Framework
Organizations interested in this approach should begin cataloging their internal procedures and tribal knowledge into structured folders, testing how AI agents discover and utilize these Skills. Further research and shared case studies will clarify best practices, scalability, and potential limitations of this model.
Industry conferences and AI tool vendors may soon incorporate features to support Skills as folders, facilitating broader adoption.
Key Questions
How is a Skill different from a prompt?
A Skill is a folder containing instructions, scripts, reference materials, and configurations, serving as a reusable organizational asset. A prompt is a simple instruction or question sent to an AI model, often retyped or rewritten for each task.
What benefits does packaging knowledge as folders provide?
It improves consistency across outputs, simplifies onboarding by embedding tribal knowledge, and allows iterative improvements over time, turning knowledge into an evolving asset.
Can this approach be applied outside AI coding agents?
Yes, the concept of encapsulating procedural knowledge into structured containers can be adapted to various organizational workflows and automation systems.
What technical challenges might organizations face?
Implementing this requires developing systems to discover, read, and execute folder contents reliably, as well as maintaining accurate descriptions for trigger activation. Integration with existing tools may also pose challenges.
Will this approach replace prompt engineering entirely?
It is likely to complement prompt engineering, providing a more durable, scalable way to embed organizational knowledge into AI systems, rather than replacing simple prompts in all contexts.
Source: ThorstenMeyerAI.com
