📊 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 shifted from viewing AI ‘Skills’ as prompts to treating them as folders containing instructions, scripts, and documents. This approach enhances consistency, onboarding, and knowledge retention in AI-driven workflows. The company ran hundreds of experiments to develop this methodology, emphasizing its business relevance.

Anthropic has announced a new approach to building AI capabilities, defining Skills not as simple prompts but as folders containing instructions, scripts, and reference materials. This reframing aims to turn ad-hoc prompt engineering into durable, reusable organizational assets, with significant implications for enterprise AI deployment.

In a detailed write-up from a Claude Code engineer, Anthropic explained that a Skill is a container — a folder that can include instructions, reference documents, runnable scripts, and configuration data. This structure allows AI agents to discover, read, and execute inside the folder, making the output more consistent and the onboarding process more efficient.

Anthropic’s internal experiments involved running hundreds of Skills across their engineering teams, leading to the identification of nine core categories, including data fetching, code scaffolding, and verification. The company emphasizes that the most valuable Skills are those that verify work, as they significantly improve output quality and safety.

This approach shifts the focus from prompt tuning to building comprehensive, reusable organizational assets that encapsulate tribal knowledge, guardrails, and operational procedures, which can be versioned and shared across teams.

At a glance
reportWhen: announced March 2024
The developmentAnthropic published findings showing that organizing AI capabilities into reusable folder-like Skills improves operational consistency and institutional knowledge.
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 offers a new way for companies to embed institutional knowledge into AI systems, making outputs more reliable and onboarding faster. By treating Skills as folders with scripts and reference data, organizations can reduce variability, improve quality control, and create a scalable library of operational procedures. This approach could redefine how enterprises deploy and maintain AI agents, emphasizing durability and shared knowledge over ad-hoc prompt engineering.
Amazon

AI development folder organization tools

As an affiliate, we earn on qualifying purchases.

As an affiliate, we earn on qualifying purchases.

From Prompt Engineering to Organizational Infrastructure

Traditionally, AI capabilities have relied heavily on prompt engineering—crafting specific instructions for each task. Anthropic’s new methodology, inspired by internal experiments, shifts this paradigm by creating reusable, folder-based Skills. This approach emerged from their efforts to improve consistency and knowledge retention, moving beyond simple prompts to structured assets that encapsulate tribal knowledge, guardrails, and scripts. The concept aligns with broader industry trends toward operationalizing AI within enterprise workflows, but Anthropic’s focus on Skills as folders is a distinct innovation.

“Treating Skills as folders containing instructions and scripts fundamentally changes how organizations can embed institutional knowledge into AI systems.”

— Thorsten Meyer, AI researcher

AI Prompts for Real Estate Agents: Copy-and-Paste AI Prompts to Automate Listings, Social Media, Email Follow-Ups, and Client Negotiations

AI Prompts for Real Estate Agents: Copy-and-Paste AI Prompts to Automate Listings, Social Media, Email Follow-Ups, and Client Negotiations

As an affiliate, we earn on qualifying purchases.

As an affiliate, we earn on qualifying purchases.

Unclear Aspects of the Folder-Based Skills Approach

It is not yet clear how widely this methodology will be adopted outside Anthropic or how it will perform in diverse enterprise environments. Details about the long-term maintenance, version control, and integration with existing workflows are still emerging. Additionally, the scalability of this approach across different AI models and use cases remains to be tested in broader industry settings.
AI Engineering: Building Applications with Foundation Models

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 Adoption and Validation

Anthropic plans to share more detailed documentation and case studies demonstrating how organizations can implement folder-based Skills. Industry observers expect other AI developers to experiment with similar structures, potentially leading to broader adoption. Further research will focus on measuring the impact on output quality, operational efficiency, and knowledge retention over time.
AI Bookkeeping Automation Prompt System: Copy-Paste Prompts, Templates, and AI Workflows to Save Time on Categorization, Reconciliation, and Reporting (AI Systems for Accountants Book 1)

AI Bookkeeping Automation Prompt System: Copy-Paste Prompts, Templates, and AI Workflows to Save Time on Categorization, Reconciliation, and Reporting (AI Systems for Accountants Book 1)

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 folder that contains instructions, scripts, and reference data, whereas a prompt is a single instruction or question sent to an AI model. Skills are reusable assets that encapsulate organizational knowledge and procedures.

Why does treating Skills as folders matter for businesses?

It allows organizations to standardize AI outputs, streamline onboarding, and build a growing library of institutional knowledge that improves over time, making AI deployment more reliable and scalable.

What categories of Skills did Anthropic identify?

Anthropic categorized Skills into nine types, including data fetching, code scaffolding, verification, and runbooks, covering a broad range of operational and development functions.

Will this approach work with all AI models?

It is still uncertain how well folder-based Skills will scale across different models and enterprise setups. Further testing and industry adoption are needed to validate its versatility.

What are the main benefits of this new Skills methodology?

The key benefits include increased output consistency, easier onboarding, and the ability to continuously improve and version control organizational procedures embedded in AI workflows.

Source: ThorstenMeyerAI.com

You May Also Like

AI‑Generated Synthetic Voices: Ethical Safeguards

Only through rigorous ethical safeguards can we ensure AI-generated synthetic voices are used responsibly—discover how to protect trust and prevent misuse.

Smart Dust: Microscopic Sensors Everywhere

Keenly tiny and incredibly versatile, smart dust sensors are revolutionizing data collection—discover how these microscopic devices could change everything.

The Twelve Real Complaints About AI Tools in 2026 — A Reddit, Twitter, and GitHub Synthesis

A detailed report on the top twelve user complaints about AI tools in 2026, based on Reddit, Twitter, and GitHub discussions, highlighting real-world friction points.

Permit renewal calendar for mobile food vendors

A new permit renewal calendar for mobile food vendors is being tested to streamline permit management across jurisdictions, aiding food truck owners.