A Skill Is a Folder, Not a Prompt: What Anthropic Learned Running Hundreds of Them

📊 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 Skills are best understood as folders containing instructions, scripts, and reference materials, not just prompts. This approach improves consistency, onboarding, and institutional knowledge in AI systems, marking a significant shift in how organizations develop and manage AI capabilities.

Anthropic has revealed that its approach to building AI agent capabilities involves packaging Skills as folders containing instructions, scripts, and reference materials, rather than simple prompts. This shift aims to create more durable, consistent, and scalable organizational processes for AI deployment, according to a detailed internal write-up from a Claude Code engineer.

The core insight from Anthropic is that a Skill is a folder, not a prompt. This folder can include instructions, reference documents, scripts, templates, data, and configuration files, which the agent can discover, read, and execute. This conceptual change significantly impacts how organizations design AI workflows, moving away from ad-hoc prompting towards reusable, versioned assets that embody institutional knowledge.

Anthropic’s internal analysis identified nine categories of Skills, ranging from library references and code scaffolding to business process automation and infrastructure operations. The most valuable category, according to Anthropic, is verification Skills, which ensure the quality and correctness of AI output, thereby reducing errors and increasing trust in AI systems. The company advocates investing engineering effort into refining these Skills, viewing them as assets that improve over time as they are iteratively enhanced with new edge cases and insights.

This approach emphasizes that Skills are not just technical tools but organizational assets that encode how work is actually done, including guardrails, tribal knowledge, and operational procedures. By packaging this knowledge into Skills, organizations can improve output consistency, accelerate onboarding, and build a scalable library of institutional memory, ultimately making AI a more reliable and integral part of business operations.

At a glance
reportWhen: published recently, ongoing implementat…
The developmentAnthropic published insights from running hundreds of Skills internally, emphasizing that Skills are folders with comprehensive assets, not simple prompts, leading to more durable and scalable AI workflows.
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 Workflow Management with Folder-Based Skills

This development matters because it shifts the paradigm from viewing AI prompts as ephemeral instructions to recognizing Skills as durable, reusable assets that encapsulate organizational knowledge. Such an approach enhances consistency in AI outputs, reduces onboarding time for new team members, and creates a scalable knowledge base that improves over time. For businesses, this means more reliable AI systems that can be maintained and improved systematically, potentially reducing costs and increasing trust in AI-driven processes.

Workflow Automation with Microsoft Power Automate: Design and scale AI-powered cloud and desktop workflows using low-code automation

Workflow Automation with Microsoft Power Automate: Design and scale AI-powered cloud and desktop workflows using low-code automation

As an affiliate, we earn on qualifying purchases.

As an affiliate, we earn on qualifying purchases.

From Ad-Hoc Prompts to Institutional Assets

Most teams currently rely on ad-hoc prompting, retyping instructions daily or creating one-off prompts that lack longevity. Anthropic’s internal experience with hundreds of Skills led to the realization that packaging these as folders transforms their utility. The concept aligns with broader trends in software engineering, where modular, versioned assets replace informal notes or static scripts, enabling better maintenance and scalability. The focus on verification Skills highlights a proven area where quality improvements can be most impactful, reflecting a mature understanding of AI deployment challenges.

This approach builds on prior AI development efforts but emphasizes the importance of institutional memory and process automation, aligning AI capabilities more closely with organizational workflows and operational rigor.

“By reframing Skills as folders containing all necessary assets, Anthropic has created a more durable and scalable way to embed institutional knowledge into AI systems.”

— Thorsten Meyer, AI researcher

Amazon

AI instruction and script management tools

As an affiliate, we earn on qualifying purchases.

As an affiliate, we earn on qualifying purchases.

What Aspects of Folder-Based Skills Are Still Unclear

It is not yet clear how widely this approach will be adopted outside Anthropic or how it will perform at scale in different organizational contexts. Details about the implementation challenges, integration with existing systems, and how to best manage versioning and updates remain under discussion. Additionally, the long-term effectiveness of Skills as organizational assets, especially in dynamic environments, is still being evaluated.

Amazon

AI knowledge base organization software

As an affiliate, we earn on qualifying purchases.

As an affiliate, we earn on qualifying purchases.

Next Steps in Developing and Deploying Skills

Organizations are likely to experiment with creating their own Skills libraries based on Anthropic’s framework, focusing initially on verification and automation categories. Future developments may include tools for easier creation, management, and updating of Skills, as well as broader industry adoption and standardization. Anthropic itself may refine its methodology and share best practices as more teams implement this approach.

Amazon

AI verification and quality control tools

As an affiliate, we earn on qualifying purchases.

As an affiliate, we earn on qualifying purchases.

Key Questions

How does viewing Skills as folders improve AI reliability?

By containing all necessary instructions, scripts, and knowledge in a structured, versioned folder, Skills ensure consistent outputs and reduce errors caused by ad-hoc prompting or missing context.

Can this approach be applied to existing AI systems?

Yes, organizations can retrofit current workflows by packaging their procedural knowledge into Skills folders, though integration complexity may vary depending on their infrastructure.

What are the main benefits of Skills over prompts?

Skills offer durability, reusability, and institutional memory, enabling organizations to scale AI capabilities more reliably and efficiently than with simple prompts.

Will this method reduce the need for retraining or reprogramming?

Partially, because Skills encapsulate operational knowledge and guardrails that can be reused and refined over time, reducing the need for constant re-prompting or rewriting instructions.

Source: ThorstenMeyerAI.com

This content is for general information only and is not financial, tax or legal advice. Consult a qualified professional for decisions about your money.
You May Also Like

Technology Operations Signal Monitor: The Future Of Flipper Zero Development

A new technology operations signal monitor is being tested to track developments like Flipper Zero’s future, aiding small software teams in decision-making.

Spatial Focus Room: Make Distraction Impossible

A new deep-work app for Apple Vision Pro, Spatial Focus Room, aims to eliminate distractions by creating immersive environments for focused work.

iFLYTEK Officially Launches Open Platform In Central Asia, Positioning Uzbekistan As A New Regional AI Hub

iFLYTEK has officially launched its open AI platform in Uzbekistan, marking its entry into Central Asia and positioning the country as a regional AI hub.

The Power Bottleneck: AI Data Centers and the Grid Cliff Approaching 2027-2028

Power constraints threaten AI data center expansion by 2028, with grid expansion lagging behind hyperscaler Capex plans, risking deployment delays and increased costs.