Claude Skills are awesome, maybe a bigger deal than MCP
A skill is a Markdown file telling the model how to do something, optionally accompanied by extra documents and pre-written scripts.
Practitioner synthesis of Anthropic's Agent Skills feature, arguing the markdown-file pattern is conceptually simpler and more token-efficient than MCP, and that the ease of sharing a single file is the feature.
Classification
- Role
- synthesis-node
- Domain
- software
- Source type
- blog
- Harness types
- grounding-context-loadingexecution-harnesslearning-harnesssocial-harness
- Validation position
- before-generation
- Validation mode
- empirical
- Prescription stance
- mixed
- Relation to argument
- capability-is-extendedfirst-mile-input-formationdiffusion-adoption-bottleneck
- Tags
- agent-skillsmarkdown-skillsmcpprogressive-disclosuretoken-efficiency
Extended capability commentary
- Input legibility
- Progressive disclosure — scan metadata, load full skill on demand — is a legibility pattern.
- Task structure
- Reward richness
- Repairability
- Observability
- Offline evaluability
- Institutional ratification
- Distribution is social: skills spread as shareable markdown files, not packaged tools.
Why it matters
Makes visible the argument that the markdown-skill pattern is a diffusion mechanism, not only a technical one. Pair with Tan (thin harness) and Anthropic's engineering post to triangulate what 'skills' actually refer to.
Annotation
Willison argues two things at once:
- Conceptual simplicity beats MCP. A skill is a markdown file; the model knows how to read markdown; a CLI tool with
--helpsolves most of what an MCP server solves, at a fraction of the token budget. - Distribution is the feature. Many skills are a single file. The shareability is the point — skills spread.
Read as a synthesis node that connects:
- Anthropic's Agent Skills announcement — the institutional launch of the pattern.
- Tan, "Thin Harness, Fat Skills" — the practitioner ethos that the markdown-skills pattern operationalises.
- HumanLayer, "Skill Issue" — what harness-engineering work remains around skills.
Related entries
- Equipping agents for the real world with Agent SkillsAnthropic · 2025-10-15#agent-skills#progressive-disclosure#markdown-skillscapability-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
- Hermes Agent READMENous Research · 2026-04-28capability-is-extendedfirst-mile-input-formationdiffusion-adoption-bottleneckgrounding-context-loadingexecution-harnesslearning-harnesssocial-harness
- Resurrecting deceased darlings: The Missing Foreword to AI and the Art of Being HumanAndrew Maynard · 2025-10-18capability-is-extendedfirst-mile-input-formationdiffusion-adoption-bottlenecklearning-harnesssocial-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.