📊 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 shared insights from running hundreds of AI Skills internally, emphasizing that Skills are more like folders containing instructions and tools than simple prompts. This approach improves consistency, onboarding, and scalability for AI-driven workflows.
Anthropic has revealed that its internal approach to building AI Skills involves creating comprehensive folders—containing instructions, scripts, and assets—rather than relying on simple prompts. This shift aims to make AI outputs more consistent, scalable, and maintainable, marking a significant evolution in how organizations develop AI capabilities. The company’s detailed write-up, authored by a Claude Code engineer, emphasizes that Skills are durable assets that encapsulate organizational knowledge, rather than transient prompt instructions. This development has implications for both technical implementation and business operations.
According to Anthropic, a Skill is best understood as a folder—containing instructions, reference documents, scripts, templates, data, configuration, and hooks—that the AI agent can discover and execute. This contrasts sharply with the common misconception that Skills are merely saved prompts or markdown notes. For technical teams, this redefinition emphasizes a structured, asset-based approach to AI development, enabling more reliable and repeatable outputs.
Anthropic’s internal experience shows that organizing Skills into categories—such as verification, data analysis, automation, and infrastructure—helps identify gaps and improve workflows. Notably, the most valuable Skills are those that verify outputs, catching mistakes before they reach users. The company advocates investing significant effort into perfecting these verification Skills, viewing them as high-value, long-term assets that improve over time.
From a business perspective, the approach streamlines onboarding and institutional memory. Instead of relying on individual tribal knowledge or scattered wiki pages, organizations can develop comprehensive Skills that encapsulate best practices, guardrails, and operational procedures. This makes AI-driven processes more consistent across teams and reduces reliance on ad-hoc instructions.
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 Development
This approach transforms how companies develop, maintain, and scale AI capabilities. By treating Skills as organized assets—folders with instructions and scripts—organizations can achieve greater consistency, reduce onboarding time, and continuously improve their AI workflows. It shifts the focus from one-off prompts to durable, sharable organizational assets, enabling AI to become a more reliable operational tool rather than a black box.
AI for Bookkeeping Automation and Workflows: Automate Data Entry, Receipts, Categorization, Reconciliation, and Month-End Reporting Using AI and No-Code Tools, Save Hours Every Week for Bookkeepers
As an affiliate, we earn on qualifying purchases.
As an affiliate, we earn on qualifying purchases.
From Prompt Engineering to Asset Management
Traditional AI prompt engineering has often involved crafting specific instructions for each task, which are then reused with minor variations. However, this method is fragile, inconsistent, and difficult to scale. Anthropic’s internal experiments with hundreds of Skills have demonstrated that packaging knowledge into structured folders significantly improves performance and reliability. This insight aligns with broader industry trends toward making AI systems more maintainable and transparent.
Previously, organizations relied on ad-hoc prompts, wiki pages, or tribal knowledge to guide AI behavior. Anthropic’s experience shows that formalizing this knowledge into Skills—comprehensive containers—enables better version control, sharing, and continuous improvement. The concept of Skills as organizational assets is a departure from the ephemeral nature of prompt-based workflows.
“A Skill is a folder—containing instructions, scripts, and assets—that the agent can discover and execute. It’s not just a prompt saved in markdown.”
— Thorsten Meyer, AI researcher at Anthropic
AI development asset management software
As an affiliate, we earn on qualifying purchases.
As an affiliate, we earn on qualifying purchases.
What Aspects of Skills Development Are Still Unclear?
It remains uncertain how widely this approach will be adopted outside Anthropic, and whether other organizations will find it scalable for their specific workflows. Details about the tooling, integration, and management of Skills at scale are still emerging, and it is not yet clear how this model performs in diverse operational environments or with different AI architectures.
AI verification scripts templates
As an affiliate, we earn on qualifying purchases.
As an affiliate, we earn on qualifying purchases.
Next Steps for Implementing Skills in AI Operations
Organizations interested in this approach should evaluate how to structure their own Skills as folders containing instructions, scripts, and assets. Further development of tooling for managing, versioning, and sharing Skills is expected, along with case studies demonstrating the impact of this method on operational reliability and scalability. Industry-wide adoption may accelerate as more companies recognize the long-term value of durable organizational assets for AI.
AI organizational knowledge folders
As an affiliate, we earn on qualifying purchases.
As an affiliate, we earn on qualifying purchases.
Key Questions
How is a Skill different from a prompt?
A Skill is a structured folder containing instructions, scripts, and assets that the AI agent can discover and execute, whereas a prompt is a simple instruction or question sent to the AI. Skills are designed to be reusable, versioned, and maintainable assets, not just ephemeral instructions.
What benefits does organizing Skills as folders provide?
Organizing Skills as folders improves consistency, simplifies onboarding, enables continuous improvement, and creates durable organizational assets that can be shared and version-controlled across teams.
Will this approach work for all types of AI workflows?
While promising, the effectiveness of this approach depends on the specific use case and organizational maturity. Further testing and tooling are needed to determine scalability across diverse operational environments.
How much effort is required to develop high-quality Skills?
Anthropic suggests dedicating significant time—potentially a week or more—to perfect a Skill category, especially verification Skills, as these have the highest impact on output quality and reliability.
Source: ThorstenMeyerAI.com