AIThis post was created with the assistance of artificial intelligence (AI).

📊 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.

Before you orderOffer from Amazon

Get the latest gadgets delivered free with Prime

  • Fast, free delivery on millions of items
  • Prime Video, Amazon Music and more included
  • Member-only deals all year
Start your free Prime trial Free trial for eligible customers · Cancel anytime
As an affiliate, we earn on qualifying purchases.

TL;DR

Anthropic has shifted from using prompts to defining ‘Skills’ as folders containing instructions, scripts, and knowledge assets. This approach enhances consistency, onboarding, and institutional memory for AI agents. The company ran hundreds of experiments to validate this method, emphasizing its business value.

Anthropic has announced a significant shift in how organizations should build and deploy AI capabilities, emphasizing that Skills are not simple prompts but folders containing instructions, scripts, and reference materials. This approach aims to turn ad-hoc prompting into durable, institutional assets that improve consistency, onboarding, and operational robustness.

According to a detailed write-up from a Claude Code engineer, Anthropic’s Skills are structured as comprehensive folders, not just text prompts. These folders can include instructions, reference documents, runnable scripts, templates, data, and hooks that activate during specific tasks. This design enables AI agents to discover, read, and execute inside these folders, making their behavior more predictable and manageable.

Anthropic’s internal experiments involved running hundreds of Skills across its engineering teams, with the goal of creating reusable, versioned assets that encapsulate tribal knowledge, guardrails, and operational procedures. The company identified nine core categories of Skills, ranging from library references to infrastructure operations, with verification Skills deemed most valuable for ensuring output quality. The approach emphasizes that building high-quality Skills justifies significant engineering effort, as they become assets that improve over time.

At a glance
reportWhen: published March 2024
The developmentAnthropic published insights from running hundreds of Skills internally, demonstrating a new approach to organizing AI agent capabilities as reusable folders, not just prompts.
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 shifts the paradigm from reactive, prompt-based AI interactions to proactive, structured organizational assets. By packaging knowledge into Skills, companies can achieve more consistent outputs, reduce onboarding time, and develop a scalable library of operational procedures. This approach also enhances the durability and reliability of AI systems, making them more aligned with enterprise needs and compliance requirements.

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 Asset Building

Traditionally, AI teams have relied on prompt engineering—crafting specific instructions for each task. However, this method is ad-hoc and fragile, often requiring repeated effort and lacking institutional memory. Anthropic’s move to define Skills as folders builds on ongoing industry efforts to standardize and scale AI deployment. The concept is rooted in internal experiments and reflects broader trends toward reusable AI components that serve as organizational assets rather than transient prompts.

“Anthropic’s Skills are fundamentally folders—containers for instructions, scripts, and knowledge—shifting the focus from prompts to durable organizational assets.”

— Thorsten Meyer, AI researcher

Amazon

AI scripting and instruction management software

As an affiliate, we earn on qualifying purchases.

As an affiliate, we earn on qualifying purchases.

Unclear Aspects of Skill Implementation and Scalability

While Anthropic’s internal results are promising, it is still unclear how broadly applicable this approach is across different industries and AI systems. The process of creating, maintaining, and updating Skills at scale remains to be tested outside Anthropic’s environment. Additionally, the precise technical mechanisms for discovering and executing scripts within folders are still evolving, and the long-term benefits versus traditional prompt engineering are not yet fully quantified.

Amazon

AI knowledge asset management system

As an affiliate, we earn on qualifying purchases.

As an affiliate, we earn on qualifying purchases.

Next Steps for Adoption and Industry Validation

Anthropic plans to share more detailed methodologies and case studies to help other organizations adopt this folder-based Skills approach. Industry observers expect to see pilot programs in various sectors testing the scalability and effectiveness of Skills as organizational assets. Further research will likely explore how Skills can be integrated into existing AI workflows and how they perform in dynamic, real-world environments.

Amazon

AI agent instruction templates

As an affiliate, we earn on qualifying purchases.

As an affiliate, we earn on qualifying purchases.

Key Questions

What exactly is a Skill in Anthropic’s framework?

A Skill is a folder containing instructions, reference documents, scripts, and configuration that an AI agent can discover, read, and execute, rather than just a prompt or set of prompts.

How does this improve AI performance?

It makes output more consistent, reduces onboarding time, and allows organizations to capture and reuse tribal knowledge, leading to more reliable and scalable AI systems.

Is this approach applicable outside Anthropic?

While promising, it remains to be seen how well this method scales across industries. Adoption will depend on technical feasibility, maintenance effort, and demonstrated benefits in diverse environments.

What are the main technical challenges?

Developing robust mechanisms for discovering, activating, and updating Skills folders, as well as integrating them into existing workflows, are key technical hurdles.

Will this replace prompt engineering?

Not necessarily; it offers an alternative that emphasizes durable, reusable assets, but prompt engineering may still be useful for quick, one-off tasks.

Source: ThorstenMeyerAI.com

HALLOWEEN

Halloween Picks

As an affiliate, we earn on qualifying purchases.

You May Also Like

Simple Aftermarket Solutions For Driver Drowsiness Safety

New phone-based app offers a low-cost solution for detecting driver drowsiness in older vehicles lacking built-in safety tech.

VigilSAR: The Object That Isn’t Transmitting

VigilSAR detects radar-visible vessels without transponders, enhancing maritime awareness in all weather conditions. Development is based on Sentinel-1 data.

The Future Of Software Rendering In Tech Ops: Minimal C++ Solutions

Small software teams explore lightweight C++ solutions for software rendering, aiming for faster decision-making on platform changes.

Weathergotchi – An E-Paper Climate Logger

Weathergotchi is an innovative e-paper device designed to log climate data visually. It aims to provide accessible, eco-friendly weather monitoring.