📊 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 designing AI skills as comprehensive folders—containing instructions, scripts, and assets—improves consistency, onboarding, and scalability. This approach shifts away from simple prompts to durable organizational assets.

Anthropic has revealed that its internal approach to building AI capabilities centers on designing Skills as folders—comprehensive containers that include instructions, scripts, and assets—rather than simple prompts. This shift aims to create more durable, reusable, and consistent AI behaviors, marking a significant departure from traditional prompt engineering.

The company’s detailed write-up, authored by a Claude Code engineer, explains that a Skill is not just a saved prompt but a folder containing a structured set of resources. These include instructions, reference documents, executable scripts, templates, data, configuration, and hooks that activate during specific tasks. This design allows AI agents to discover, read, and execute inside these folders, enabling more reliable and maintainable automation.

Anthropic emphasizes that this approach transforms ad-hoc prompting into a durable institutional capability. Skills can be versioned, shared, and improved over time, effectively becoming organizational assets that encapsulate tribal knowledge and guardrails. The company reports that dedicating time—up to an engineer-week—to perfect a Skill yields a high return on investment, as Skills tend to improve with each iteration, especially as they cover edge cases.

Furthermore, Anthropic identified nine core categories of Skills—ranging from library referencing and product verification to infrastructure operations—each serving different organizational needs. The most valuable category, according to the company, is verification, which ensures output quality and mistake catching. This approach underscores a shift from prompt-based to asset-based AI development, aiming for consistency, scalability, and quality control.

At a glance
reportWhen: announced March 2024
The developmentAnthropic shared its findings from running hundreds of internal Skills, emphasizing that Skills are folders, not prompts, which enhances organizational AI capabilities.
A Skill Is a Folder, Not a Prompt — Insights
AI Dispatch · Insights · 1 July 2026

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.

✕ The misconception

“A Skill is just a clever markdown prompt you save in a file.”

✓ What it actually is

A folder the agent can discover, read & run — instructions, scripts, references, templates, config & on-demand hooks.

Anatomy of a Skill — the file system is context engineering
my-skill/the unit you share & version
├─ SKILL.mdroot instructions + a description written for the model (its trigger)
├─ references/deep detail pulled in only when needed — progressive disclosure
├─ scripts/real code, so the agent composes instead of rebuilding boilerplate
├─ assets/templates & files to copy into the output
├─ config.jsonsetup the agent asks for if it’s missing (e.g. which Slack channel)
└─ hooks + memoryon-demand guardrails + an append-only log so it remembers
Why it matters: the folder itself is the knowledge base. The agent reads the root, then reaches deeper only when the task demands it — the same way you’d hand a new hire a one-pager that points to the detailed docs.
The nine types — a gap-analysis map for your own library
1Library / API reference
2Product verification ★ top impact
3Data fetching & analysis
4Business-process automation
5Code scaffolding & templates
6Code quality & review
7CI/CD & deployment
8Runbooks
9Infrastructure operations
By Anthropic’s own measurement, verification Skills — the ones that check the work — moved output quality the most. If you build one category well, build that one.
The craft — what separates a good Skill from a useless one
Gotchas = highest-signal section Describe for the model, not humans (it’s the trigger) Don’t state the obvious Ship scripts, not just prose On-demand guardrail hooks (/careful, /freeze) Let it remember (log / SQLite) Don’t railroad — leave room to adapt
The take

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.

Source: “Lessons from building Claude Code: How we use skills,” Thariq Shihipar (Anthropic), Claude blog, 3 June 2026. Categories, examples & measured claims are Anthropic’s; framing is the author’s. Docs: code.claude.com/docs/en/skills.
thorstenmeyerai.com

Transforming AI Capabilities into Organizational Assets

This development matters because it redefines how companies can build, maintain, and scale AI systems. By treating Skills as folders that bundle instructions, code, and knowledge, organizations can achieve greater consistency in AI outputs, reduce onboarding time for new team members, and create a library of reusable, improving assets. This approach also offers a pathway to embed tribal knowledge directly into AI workflows, fostering more reliable automation and reducing reliance on fragile prompt engineering.

For businesses, this means moving beyond one-off prompt tuning toward a systematic, versioned, and shareable asset library. It could lead to more predictable AI behavior, easier maintenance, and accelerated deployment of complex AI-driven processes, ultimately making AI a more integrated and dependable part of organizational operations.

Claude AI for Beginners Bible: [5 in 1] The Ultimate Guide to Automate Your Work, Save Hours Every Week, and Use AI for Real-World Results

Claude AI for Beginners Bible: [5 in 1] The Ultimate Guide to Automate Your Work, Save Hours Every Week, and Use AI for Real-World Results

As an affiliate, we earn on qualifying purchases.

As an affiliate, we earn on qualifying purchases.

From Prompt Engineering to Asset-Based AI Development

Traditionally, AI developers have relied on prompt engineering—crafting specific instructions or questions—to guide model outputs. However, this method often results in fragile, inconsistent behavior that varies with prompt phrasing and context. Recent industry efforts have aimed to improve this by fine-tuning models or creating prompt templates, but these remain ad-hoc solutions.

Anthropic’s recent publication marks a shift by proposing that Skills should be structured as folders containing all relevant knowledge and code, making them reusable assets. This approach aligns with broader trends in software engineering, where modular, versioned assets replace ephemeral instructions. The concept builds on prior work in automation and knowledge management, but it is novel in its application to AI agent development at scale.

By running hundreds of these Skills internally, Anthropic has gained insights into how organizations can standardize AI workflows, improve output quality, and facilitate knowledge transfer—key concerns for enterprise AI deployment.

“Designing Skills as folders containing instructions, scripts, and assets fundamentally changes how organizations build and scale AI capabilities.”

— Thorsten Meyer, AI researcher

Building AI-Powered Products: The Essential Guide to AI and GenAI Product Management

Building AI-Powered Products: The Essential Guide to AI and GenAI Product Management

As an affiliate, we earn on qualifying purchases.

As an affiliate, we earn on qualifying purchases.

Unclear Impact on Broader Industry Adoption

While Anthropic’s internal results are promising, it is not yet clear how widely this approach will be adopted across other organizations or whether it will scale effectively in different contexts. Specific challenges related to integrating Skills into existing workflows and tooling remain to be seen, and the long-term benefits are still being evaluated.

Amazon

AI scripting and asset management tools

As an affiliate, we earn on qualifying purchases.

As an affiliate, we earn on qualifying purchases.

Next Steps for Implementation and Industry Validation

Anthropic plans to continue refining its Skills framework and may publish more detailed case studies demonstrating its effectiveness. Other organizations are expected to experiment with similar asset-based approaches, testing how Skills can be integrated into their automation and AI deployment pipelines. Industry-wide adoption will depend on how well this method scales and how easily teams can transition from prompt engineering to folder-based assets.

Plaud Note AI Voice Recorder, Note Taker w/Case, App Control, Transcribe & Summarize with AI, Support 112 Languages, for Meetings, Calls, Lectures, Professionals, Teams, Black, Non-Pro Version

Plaud Note AI Voice Recorder, Note Taker w/Case, App Control, Transcribe & Summarize with AI, Support 112 Languages, for Meetings, Calls, Lectures, Professionals, Teams, Black, Non-Pro Version

Plaud Intelligence: Capture conversations in 112 languages and generate accurate transcripts with the Plaud App and Web. Plaud…

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 consistency?

By bundling instructions, scripts, and knowledge in a structured folder, Skills ensure that AI agents follow the same procedures each time, reducing variability caused by prompt phrasing or context.

What are the main categories of Skills identified by Anthropic?

The nine categories include library referencing, product verification, data analysis, business automation, code scaffolding, code review, CI/CD, runbooks, and infrastructure operations.

Can this approach replace prompt engineering entirely?

While it offers a more durable and scalable alternative, prompt engineering may still be useful for quick, one-off tasks. Skills as folders aim to embed institutional knowledge for long-term use.

What challenges might organizations face in adopting folder-based Skills?

Potential challenges include integrating Skills into existing workflows, managing version control, and training teams to develop and maintain these structured assets effectively.

Source: ThorstenMeyerAI.com

You May Also Like

Aleph Alpha. The retrospective case.

A detailed analysis of Aleph Alpha’s strategic pivot, acquisition, and what it reveals about Europe’s AI development challenges.

October 2026: What an Anthropic IPO Actually Unlocks

Anthropic’s planned IPO in October 2026 at an $850-900B valuation will influence industry dynamics, opening new strategic and market opportunities.

Security Surveillance Drones: Patrolling Properties From Above

Just imagine how security drones can revolutionize property patrols; discover the benefits and considerations of aerial surveillance today.

Forward-Deployed: The Integration Wall, and the Role That Now Pays $700K to Climb It

In 2026, the highest-paid IC role in tech is the Forward-Deployed Engineer, earning up to $700K, driven by enterprise AI integration demands.