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.

TL;DR

Anthropic has shifted from simple prompts to packaging knowledge into reusable ‘Skills’ structured as folders. This approach improves consistency, onboarding, and asset development in AI workflows, marking a significant departure from traditional prompt engineering.

Anthropic has announced that its AI Skills are best understood as folders containing instructions, scripts, and assets, rather than simple prompts. This shift aims to improve consistency, onboarding, and institutional memory within AI teams, marking a significant evolution in how organizations deploy AI capabilities. The insight comes from a detailed write-up by a Claude Code engineer, reflecting Anthropic’s internal practices and lessons learned from running hundreds of Skills across its engineering organization.

According to Anthropic, a Skill is a folder that can hold instructions, reference documents, scripts, templates, data, configuration, and hooks. This structure allows AI agents to discover and execute complex workflows as a cohesive unit, rather than relying on ad-hoc prompts. The approach shifts the focus from prompts as fleeting instructions to Skills as durable, versioned assets that encode organizational knowledge.

Anthropic emphasizes that Skills improve operational consistency — ensuring the same task produces similar results regardless of who runs it — and facilitate onboarding by capturing tribal knowledge in a reusable format. The company also notes that Skills can evolve and compound over time, becoming more refined through continuous use and iteration. The internal taxonomy identifies nine categories of Skills, from library references to infrastructure operations, with verification Skills deemed most valuable for quality control.

Technical lessons highlight that effective Skills avoid restating obvious information, instead focusing on non-obvious, specific guidance. The description of each Skill functions as a trigger for the agent, requiring precise wording to activate the correct workflow. Bundling real code and helper functions within Skills enhances their utility, making them more than just static instructions.

At a glance
reportWhen: published recently, based on internal A…
The developmentAnthropic published insights from its internal experience running hundreds of Skills, demonstrating a new organizational approach to AI capabilities based on folder-structured Skills rather than 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

Implications for Organizational AI Deployment

This development signals a shift toward more structured, maintainable, and scalable AI workflows within organizations. By treating Skills as containers of institutional knowledge, companies can achieve greater consistency, reduce onboarding time, and develop a library of reusable, improving assets. This approach also enables teams to move beyond simple prompt engineering toward building durable operational capabilities, potentially transforming AI’s role in enterprise workflows.

AI for Project Managers: A Desk Reference & Field Guide: Use Artificial Intelligence to Streamline Workflows, Automate Tasks, and Make Smarter Decisions with Practical Tools and Ethical Insights

AI for Project Managers: A Desk Reference & Field Guide: Use Artificial Intelligence to Streamline Workflows, Automate Tasks, and Make Smarter Decisions with Practical Tools and Ethical Insights

As an affiliate, we earn on qualifying purchases.

As an affiliate, we earn on qualifying purchases.

From Prompting to Asset Management in AI Development

Traditional AI deployment often relies on ad-hoc prompting, requiring teams to craft and re-craft instructions for each task. Anthropic’s internal experience shows that packaging knowledge into Skills as folders represents a fundamental shift, inspired by principles of asset management and institutional memory. The concept aligns with broader trends in AI engineering, emphasizing modularity, version control, and reusable components, similar to software engineering practices. The approach builds on prior efforts to improve AI reliability but elevates it by structuring workflows as durable assets rather than ephemeral prompts.

Anthropic’s insights come from running hundreds of Skills internally, revealing patterns and categories that serve as a blueprint for other organizations seeking to institutionalize AI capabilities effectively.

“A Skill is a folder — one that can contain instructions, reference documents, scripts, templates, data, configuration, and even hooks that fire only while the Skill is active.”

— Thorsten Meyer, AI Engineer at Anthropic

MixPad Free Multitrack Recording Studio and Music Mixing Software [Download]

MixPad Free Multitrack Recording Studio and Music Mixing Software [Download]

  • Multitrack Recording and Mixing: Create mixes with audio, music, and voice tracks
  • Track Customization: Apply effects and editing tools to tracks
  • Music Creation Tools: Includes Beat Maker and MIDI Creator

As an affiliate, we earn on qualifying purchases.

As an affiliate, we earn on qualifying purchases.

Unresolved Questions About Skill Adoption and Scaling

It is not yet clear how widely organizations will adopt this folder-based approach outside Anthropic or how it scales in different enterprise contexts. The specific technical challenges of maintaining and updating large Skills libraries, as well as integration with existing systems, remain to be seen. Additionally, the impact on AI transparency and explainability, given the complexity of folder contents, is still under discussion.

AI and UX: Why Artificial Intelligence Needs User Experience

AI and UX: Why Artificial Intelligence Needs User Experience

As an affiliate, we earn on qualifying purchases.

As an affiliate, we earn on qualifying purchases.

Future Steps for Implementing Folder-Based Skills

Organizations interested in this approach should evaluate their current workflows and identify categories of Skills that could improve consistency and onboarding. Further research and pilot projects are expected to explore how to best structure, version, and maintain Skills libraries at scale. Anthropic may also release tools or best practices to facilitate broader adoption of folder-based Skills in enterprise AI deployments.

Plaud Note AI Voice Recorder, Note Taker w/Case, App Control, Transcribe & Summarize with AI, Support 112 Languages, for Meetings, Calls, Lectures, Professionals, Teams, Black, Non-Pro Version

Plaud Note AI Voice Recorder, Note Taker w/Case, App Control, Transcribe & Summarize with AI, Support 112 Languages, for Meetings, Calls, Lectures, Professionals, Teams, Black, Non-Pro Version

  • Language Support: Captures 112 languages with AI transcription
  • AI-Powered Insights: Generates transcripts, mind maps, to-do lists
  • Slim and Lightweight: Only 0.12 inches thick, 1.06 oz

As an affiliate, we earn on qualifying purchases.

As an affiliate, we earn on qualifying purchases.

Key Questions

How does treating Skills as folders differ from traditional prompt engineering?

Unlike prompts, which are single instructions or questions, Skills as folders contain multiple assets, including instructions, scripts, and data, making them more durable, reusable, and capable of encapsulating complex workflows.

What benefits does this approach offer for organizations?

It improves output consistency, reduces onboarding time by capturing tribal knowledge, and creates a library of assets that can be refined and scaled over time, enhancing organizational AI capabilities.

Are there technical challenges associated with implementing Skills as folders?

Yes, maintaining and updating large Skills libraries, ensuring proper trigger descriptions, and integrating with existing systems can pose challenges, especially at scale. These are areas for ongoing development and best practice formulation.

Will this approach work with all types of AI tasks?

The approach is most suited for operational and repetitive tasks where consistency and institutional knowledge are critical. Its applicability to more creative or less structured tasks remains to be explored.

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

The Real Cost Of A Local-Inference Rig In 2026

Analyzing the hardware costs for local AI inference in 2026, including VRAM limits, hardware tiers, and value strategies for owning models.

7 AI-Powered Platforms Transforming Student Groups In 2026

Discover how seven AI-powered platforms are transforming student organizations in 2026, enhancing management, collaboration, and learning.

HII Christens Guided Missile Destroyer George M. Neal (DDG 131)

HII officially christened the USS George M. Neal (DDG 131), a guided missile destroyer, during a ceremony at the company’s shipyard, marking a key milestone for the vessel’s construction.

SAP’s AI Focus: Build Your Own System Of Record, Not Rely On Rented Minds

SAP emphasizes owning enterprise data over relying on external models, launching Joule as a core AI interface integrated into its systems.