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 shifted its approach to AI skills, defining them as folders containing instructions, scripts, and data rather than simple prompts. This method improves consistency, onboarding, and knowledge retention, marking a significant change in AI deployment strategies.

Anthropic has redefined its concept of AI ‘Skills’ as folders containing instructions, scripts, and reference materials, not just prompts. This shift aims to create durable, reusable assets that improve AI consistency, onboarding, and organizational knowledge management. The approach is part of Anthropic’s internal engineering practices and has implications for how companies deploy AI tools effectively.

According to a detailed write-up from an Anthropic Claude Code engineer, a Skill is now understood as a folder that bundles instructions, reference documents, runnable scripts, templates, data, and configuration. This redefinition moves away from the idea of storing simple prompts as static text files. Instead, Skills serve as containers for how organizations actually perform tasks, capturing tribal knowledge, guardrails, and tools in a structured, discoverable format.

Anthropic’s internal experiments with hundreds of Skills have revealed that they cluster into nine categories, ranging from library references and data analysis to business-process automation and infrastructure operations. The most impactful category, according to the company, is verification Skills, which check the quality and correctness of AI outputs, significantly improving reliability.

Experts note that this approach makes AI outputs more consistent across users, simplifies onboarding by embedding organizational knowledge into reusable units, and allows Skills to improve over time through iterative refinement. Anthropic advocates spending engineering effort to develop high-quality Skills, viewing them as assets that appreciate in value as they evolve.

At a glance
reportWhen: published recently, based on the latest…
The developmentAnthropic published insights from running hundreds of AI ‘Skills’ as folder-based assets, emphasizing a new organizational approach to 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

Implications for AI Deployment and Organizational Knowledge

This development marks a shift toward structured, reusable assets in AI deployment, moving beyond ad-hoc prompting. By treating Skills as folders with comprehensive instructions and tools, organizations can achieve more consistent AI outputs, streamline onboarding, and preserve institutional knowledge. This approach could redefine best practices in enterprise AI use, emphasizing maintainability and continuous improvement.

Amazon

AI knowledge management folders

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 shift, most teams relied on manually crafted prompts that were retyped or adjusted for each session, leading to inconsistency and difficulty in scaling AI use. Anthropic’s internal research shows that organizing knowledge into Skills—akin to folders—enables a more durable and scalable approach. This aligns with broader trends toward modular AI components and knowledge management systems, but with a specific focus on operational workflows and institutional memory.

The idea of Skills as folders is a departure from traditional prompt engineering, emphasizing structured assets that can be versioned, shared, and refined over time. Anthropic’s experiments with hundreds of Skills demonstrate that this method enhances reliability and efficiency, especially in complex enterprise contexts.

“Treating Skills as folders containing instructions, scripts, and data fundamentally changes how organizations build and maintain AI capabilities.”

— Thorsten Meyer, AI researcher

Amazon

AI automation scripting tools

As an affiliate, we earn on qualifying purchases.

As an affiliate, we earn on qualifying purchases.

Unclear Aspects of the Folder-Based Skills Model

It is not yet clear how widely adopted this approach will become outside Anthropic or how it will integrate with existing enterprise AI workflows. Details about the specific tooling, versioning, and sharing mechanisms for Skills are still emerging, and the long-term impact on AI performance and organizational change remains to be seen.

Amazon

organizational reference document software

As an affiliate, we earn on qualifying purchases.

As an affiliate, we earn on qualifying purchases.

Next Steps for Broader Adoption and Development

Anthropic plans to refine its Skills framework and share best practices for implementation. Other organizations may begin experimenting with folder-based assets for AI, potentially leading to industry standards for managing AI capabilities at scale. Further research and case studies are expected to evaluate the effectiveness of this approach in diverse operational environments.

Amazon

AI verification tools

As an affiliate, we earn on qualifying purchases.

As an affiliate, we earn on qualifying purchases.

Key Questions

How does defining Skills as folders improve AI performance?

By bundling instructions, scripts, and reference materials, Skills enable more consistent and reliable AI outputs, reducing variability caused by ad-hoc prompting.

Can this approach be integrated with existing AI systems?

While details are still emerging, the folder-based model is designed to be compatible with current AI workflows, emphasizing modularity and version control.

What are the main benefits for organizations adopting this model?

Organizations can achieve better consistency, easier onboarding, and a living record of institutional knowledge that improves over time.

Is this approach specific to Anthropic or applicable industry-wide?

It is currently a concept developed and tested within Anthropic, but its principles could influence broader AI deployment practices across industries.

Source: ThorstenMeyerAI.com

You May Also Like

Best Thermal Paste and Pads for High-TDP GPUs

Discover top thermal interface materials for high-power GPUs, focusing on long-term performance, reliability, and ease of use for sustained workloads.

Show HN: Epiq – Distributed Git based issue tracker TUI

Epiq introduces a vim-inspired, Git-based issue tracker operating entirely within the terminal, emphasizing local-first, event-sourced collaboration without SaaS dependencies.

How to Reset Windows Without Losing Everything (What It Really Does)

To reset Windows without losing everything, choose the “Keep my files” option…

Japan’s Toto to invest $495m in chip materials, targeting 1-nm era

Japanese bathroom fixture maker Toto will invest $495 million over five years to expand into advanced semiconductor materials targeting 1-nanometer chip technology.