📊 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 packaging AI capabilities as folders—called Skills—rather than prompts leads to more consistent, maintainable, and scalable AI operations. This approach transforms ad-hoc prompting into durable organizational assets.

Anthropic has revealed that organizing AI capabilities as ‘Skills’—comprehensive folders with instructions, scripts, and reference materials—significantly improves consistency and knowledge sharing within its engineering teams. This approach shifts the paradigm from simple prompts to structured, reusable assets, enabling organizations to embed institutional knowledge directly into AI workflows.

In a detailed write-up, Anthropic’s Claude Code engineer explains that a Skill is not merely a saved prompt but a folder that can include instructions, reference documents, scripts, templates, data, and configuration. This structure allows AI agents to discover, read, and execute the contents, making their behavior more predictable and aligned with organizational standards.

Anthropic’s internal experience shows that Skills help make AI output more consistent, facilitate onboarding by capturing tribal knowledge, and enable compound improvements through iterative refinement. The company emphasizes that a Skills library is an appreciating asset rather than a cost, as it documents how work is done and improves over time.

Anthropic identified nine key categories of Skills, including data fetching, verification, automation, code scaffolding, review, deployment, runbooks, and infrastructure operations. The most impactful, according to the company, is verification, which ensures the quality and correctness of AI-generated outputs.

At a glance
reportWhen: published recently, based on internal A…
The developmentAnthropic published insights from running hundreds of Skills internally, showing that treating Skills as folders containing instructions and tools improves AI reliability and organizational knowledge retention.
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

Advantages of Structuring Skills as Folders for Business Operations

This approach transforms AI from a tool dependent on ad-hoc prompts into a systematic, reliable asset that enhances operational consistency, reduces onboarding time, and captures institutional knowledge. For organizations deploying AI at scale, this method offers a way to standardize behavior and improve quality control across teams.

By treating Skills as containers for detailed instructions and tools, companies can better control AI outputs, prevent mistakes, and continuously refine their processes. The emphasis on verification Skills highlights the importance of quality assurance in automated workflows, which can significantly impact productivity and risk management.

Amazon

AI development folder organization tools

As an affiliate, we earn on qualifying purchases.

As an affiliate, we earn on qualifying purchases.

Internal Practices and the Shift Toward Modular AI Capabilities

Historically, most teams using AI coding agents relied on repeatedly retyping the same instructions, leading to inconsistency and inefficiency. Anthropic’s internal experiments with hundreds of Skills demonstrated that organizing these capabilities into structured folders yields better results.

Anthropic’s insights build on broader industry trends toward modular AI components, but its focus on Skills as comprehensive, versioned assets marks a significant evolution. The company’s internal documentation and practices serve as a blueprint for organizations seeking to embed AI more deeply into operational workflows.

“Treating Skills as folders containing instructions, scripts, and reference materials fundamentally changes how AI capabilities are managed and deployed.”

— Thorsten Meyer, AI researcher at Anthropic

Linux Basics for Hackers: Getting Started with Networking, Scripting, and Security in Kali

Linux Basics for Hackers: Getting Started with Networking, Scripting, and Security in Kali

As an affiliate, we earn on qualifying purchases.

As an affiliate, we earn on qualifying purchases.

Unclear Aspects of Scaling Skills Across Organizations

While Anthropic’s internal experience demonstrates the benefits of Skills, it is not yet clear how easily this approach scales across different industries or with less technical teams. The precise process for creating, maintaining, and updating Skills at large scale remains to be validated outside Anthropic’s environment.

Additionally, the impact on AI performance and cost-efficiency over time warrants further study, especially in diverse operational contexts.

AI Workflow Automation for Bloggers: Build a Simple Content System to Research, Write, Optimize, and Repurpose Posts Faster with AI and No-Code Tools (AI Toolkit for Bloggers 2026 Book 8)

AI Workflow Automation for Bloggers: Build a Simple Content System to Research, Write, Optimize, and Repurpose Posts Faster with AI and No-Code Tools (AI Toolkit for Bloggers 2026 Book 8)

As an affiliate, we earn on qualifying purchases.

As an affiliate, we earn on qualifying purchases.

Next Steps for Adopting Folder-Based Skills in AI Workflows

Organizations interested in this approach should start by cataloging existing processes into Skills folders, focusing initially on verification and automation categories. Pilot programs can test how well this structure improves consistency and knowledge retention.

Further research and industry collaboration are needed to develop standards for Skills management, versioning, and updates, enabling broader adoption and refinement of this methodology.

Knowledge-Based Software Engineering: Proceedings of the Eighth Joint Conference on Knowledge-Based Software Engineering

Knowledge-Based Software Engineering: Proceedings of the Eighth Joint Conference on Knowledge-Based Software Engineering

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 materials, making it a reusable, structured asset. In contrast, a prompt is a simple text instruction used once or a few times.

What benefits does organizing Skills as folders provide?

It improves output consistency, facilitates onboarding by capturing tribal knowledge, and allows iterative improvement of organizational procedures embedded within the Skills.

Can this approach be applied outside of AI coding teams?

Yes, any organization that relies on AI for operational tasks can benefit from structuring capabilities as Skills, especially for complex workflows requiring reliability and institutional knowledge.

What are the main challenges in implementing Skills as folders?

Creating and maintaining comprehensive Skills requires technical effort, discipline, and ongoing updates to keep them aligned with evolving processes and tools.

Is this approach industry-specific or broadly applicable?

While initially tested within AI engineering teams, the principles behind Skills as structured folders are broadly applicable across sectors that leverage AI for operational or strategic purposes.

Source: ThorstenMeyerAI.com

You May Also Like

Mobilisiert, nicht ausgegeben: Was von Europas €200-Milliarden-KI-Offensive übrig bleibt

Die EU kündigt eine KI-Initiative mit €200 Milliarden an, doch nur ein Bruchteil ist garantiert. Die tatsächlichen Investitionen bleiben unklar, während Europas Rückstand wächst.

The Skills Marketplace Nobody Is Building Yet

A new open standard for AI skills exists, but a dedicated marketplace with monetization, security, and discovery layers has yet to be built, creating a significant gap.

Web3 and Decentralized Internet: Hype or The Next Big Revolution?

Great questions arise about whether Web3 truly will revolutionize the internet or just hype, prompting us to explore what really lies ahead.

One Model, a Whole Portfolio: What Ten Days on Fable Mean for a Business Building on Frontier AI

A ThorstenMeyerAI report says Claude Fable 5 coordinated a 10-day portfolio sprint before a government-ordered suspension.