Equipping agents for the real world with Agent Skills
Agent Skills are organized folders of instructions, scripts, and resources that agents can discover and load dynamically to perform better at specific tasks.
Anthropic's engineering announcement of Agent Skills: a markdown-based pattern for extending Claude's capabilities by progressive disclosure. Important as an *institutional* ratification of the thin-harness / fat-skills framing.
Classification
- Role
- framework-piece
- Domain
- software
- Source type
- blog
- Harness types
- grounding-context-loadingexecution-harnesslearning-harnessratification-harness
- Validation position
- before-generationduring-generation
- Validation mode
- empiricalinstitutional
- Prescription stance
- mixed
- Relation to argument
- capability-is-extendedfirst-mile-input-formationinstitutions-shape-capabilitydiffusion-adoption-bottleneck
- Tags
- agent-skillsanthropicprogressive-disclosureinstitutional-launchmarkdown-skills
Extended capability commentary
- Input legibility
- Task structure
- Reward richness
- Repairability
- Observability
- Offline evaluability
- Institutional ratification
- The model vendor officially blessing the markdown-skill pattern is a ratification event, not only a technical one.
Why it matters
When the model vendor publishes an engineering post describing the pattern, the pattern becomes a point of reference that downstream tooling, hiring, and documentation can anchor on. The library should treat this as institutional ratification of the thin-harness-adjacent thesis.
Annotation
An important entry for the institutions-shape-capability axis. Anthropic's engineering post is not just a feature announcement — it is the moment the markdown-skill pattern gets a canonical, vendor-endorsed framing. That changes what downstream practitioners cite, what conference talks reference, and which designs are considered "default."
Three things to note:
- The pattern has been used internally at Anthropic for some time (search snippet: "they now have hundreds of them in production"). The public post is ratification, not invention.
- Progressive disclosure — scanning only metadata until a skill is relevant — is a specific design move and deserves to be tracked. It is not just "markdown files"; it is a loading strategy.
- Agent Skills and MCP are presented as complementary, not competing. That framing matters for the library's
harness_typestaxonomy.
Related entries
- Willison, "Claude Skills are awesome, maybe a bigger deal than MCP" — practitioner synthesis the same week.
- Tan, "Thin Harness, Fat Skills" — the ethos this operationalises.
- HumanLayer, "Skill Issue" — working-through of where skills stop and harness-engineering continues.
Related entries
- Claude Skills are awesome, maybe a bigger deal than MCPSimon Willison · 2025-10-15#agent-skills#markdown-skills#progressive-disclosurecapability-is-extendedfirst-mile-input-formationdiffusion-adoption-bottleneckgrounding-context-loadingexecution-harnesslearning-harness
- Thin Harness, Fat SkillsGarry Tan · 2026-04-10#markdown-skillscapability-is-extendeddiffusion-adoption-bottleneckfirst-mile-input-formationexecution-harnesslearning-harness
- Resurrecting deceased darlings: The Missing Foreword to AI and the Art of Being HumanAndrew Maynard · 2025-10-18capability-is-extendedfirst-mile-input-formationinstitutions-shape-capabilitydiffusion-adoption-bottlenecklearning-harness
- Hermes Agent READMENous Research · 2026-04-28capability-is-extendedfirst-mile-input-formationdiffusion-adoption-bottleneckgrounding-context-loadingexecution-harnesslearning-harness
Overlap is computed on tags, relation-to-argument, and harness types — not on role or domain, because contrasts are often the most useful neighbours.