📊 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 are best understood as folders containing instructions, scripts, and assets, not just prompts. This approach enhances consistency, onboarding, and continuous improvement in AI workflows, signaling a shift in how organizations build and manage AI capabilities.
Anthropic has announced a significant shift in how organizations should think about AI ‘Skills,’ emphasizing that a Skill is not just a prompt, but a folder containing instructions, scripts, and assets. This approach, derived from their internal experiments with hundreds of Skills, aims to make AI capabilities more durable, consistent, and easier to maintain, representing a fundamental change in prompt engineering and organizational knowledge management.
According to a detailed write-up from a Claude Code engineer, Anthropic’s approach involves packaging knowledge into folders rather than simple prompts. Each Skill folder can include instructions, reference documents, scripts, templates, data, configuration, and hooks that activate during operation. This structure allows AI agents to discover, read, and execute complex workflows, making the process more robust and reusable.
Anthropic’s internal experiments revealed that organizing Skills as folders enhances consistency across outputs, simplifies onboarding by capturing tribal knowledge, and allows continuous improvement through iterative refinement. They identified nine core categories of Skills, ranging from library references to infrastructure operations, with verification Skills deemed most valuable for quality control.
The technical insight emphasizes that effective Skills should avoid restating obvious facts and instead focus on non-obvious, specific content. The description of each Skill acts as a trigger, matching user requests with the appropriate folder, making the system more reliable and context-aware. This approach transforms prompt engineering into a systematic, asset-based process that organizations can version, share, and improve over time.
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 signals a shift from ad-hoc prompt tuning to building structured, reusable organizational assets for AI. By treating Skills as folders, companies can achieve more consistent outputs, streamline knowledge transfer, and foster iterative refinement. This approach could significantly improve the scalability and reliability of AI deployment across industries, moving beyond simple prompt tweaking to a more disciplined, asset-based methodology.
Pydantic AI for Automation Workflows: Build Typed, Reliable, and Production-Ready AI Automations in Python
As an affiliate, we earn on qualifying purchases.
As an affiliate, we earn on qualifying purchases.
From Prompt Engineering to Asset Management
Prior to this, most organizations relied on prompt engineering—crafting specific instructions for each task—an approach that is fragile and hard to scale. Anthropic’s internal experiments with hundreds of Skills revealed that packaging instructions, scripts, and knowledge into folders creates a more durable and maintainable system. This aligns with broader trends in AI towards modular, reusable components, and reflects lessons learned from deploying large language models in complex workflows.
The concept of Skills as folders builds on existing practices but formalizes them into a structured, version-controlled system. Anthropic’s categorization into nine Skill types offers a framework for organizations to identify gaps and build comprehensive capabilities, especially in areas like verification and automation that directly impact output quality.
“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
General Tools 843/1 Pencil Compass and Scriber, 8 Inch Diameter
COMPASS AND SCRIBE: Designed for marking contours and drawing circles or arcs.
As an affiliate, we earn on qualifying purchases.
As an affiliate, we earn on qualifying purchases.
Uncertain Impact and Adoption Challenges
It remains unclear how widely this folder-based approach will be adopted outside Anthropic and how it will perform across diverse organizational contexts. The practical challenges of implementing such structured Skills at scale, including version control, integration with existing workflows, and user training, are still being evaluated. Additionally, the long-term benefits versus traditional prompt engineering are yet to be empirically validated in different industries.
Sooez 24 Packs Plastic Envelopes Plastic File Folders, Clear Document Organizer Folder US Letter A4 Size Folders for Documents with Label Pocket for School Office Work Home Organization, Fresh Colors
Colorful Transparent Folders: Refresh your storage with 5 Pastels Colors：pink, yellow, green, blue, purple, transparent. Each color with…
As an affiliate, we earn on qualifying purchases.
As an affiliate, we earn on qualifying purchases.
Next Steps for Broader Implementation and Validation
Organizations interested in this approach should begin by cataloging their existing knowledge assets into structured folders, focusing on critical categories like verification and automation. Observing how these Skills perform in real workflows will inform best practices and potential tooling enhancements. Further, Anthropic is likely to publish more detailed case studies and tools to facilitate adoption, while industry peers may adapt these concepts into their own AI management frameworks.
AI Prompt Engineering: Foundations of Communication with LLMs – Building Generative AI and Agentic AI Prompt Systems Across Development, Testing, and Deployment (AI Engineering)
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 improve AI reliability?
By containing comprehensive instructions, scripts, and knowledge, a folder-based Skill ensures that AI agents follow consistent, well-defined processes, reducing errors and variability in outputs.
Can this approach be applied to existing prompt engineering practices?
Yes, organizations can start by organizing their prompt instructions and related assets into folders, gradually replacing ad-hoc prompts with structured Skills for better maintainability and scalability.
What are the main categories of Skills identified by Anthropic?
They include library references, product verification, data analysis, business process automation, code scaffolding, quality review, deployment, runbooks, and infrastructure operations.
What challenges might organizations face in adopting this model?
Potential challenges include establishing effective version control, integrating Skills into existing workflows, training staff, and scaling the approach across complex organizations.
Source: ThorstenMeyerAI.com
