write-a-skill

Scaffold new agent skills with structured templates, progressive disclosure, and bundled utility scripts.

mattpocock ↓ 226k
Claude Code
View source ↗

What it does

  • What task/domain does the skill cover?
  • What specific use cases should it handle?
  • Does it need executable scripts or just instructions?
  • Any reference materials to include?
  • SKILL.md with concise instructions
  • Additional reference files if content exceeds 500 lines
  • Utility scripts if deterministic operations needed

Requirements & configuration

  • Does it need executable scripts or just instructions?
  • Errors need explicit handling

Derived from the skill's own SKILL.md documentation · extracted 2026-07-23

Scaffold new agent skills with structured templates, progressive disclosure, and bundled utility scripts.

Source

Repository: https://github.com/mattpocock/skills

write-a-skill FAQ

What does the write-a-skill skill do?

Create new agent skills with proper structure, progressive disclosure, and bundled resources. Use when user wants to create, write, or build a new skill. What task/domain does the skill cover? What specific use cases should it handle?

What does write-a-skill require?

Does it need executable scripts or just instructions? Errors need explicit handling

How do I install write-a-skill?

Run: npx -y skills add https://github.com/mattpocock/skills --skill write-a-skill --agent claude-code — the source lives at github.com/mattpocock/skills.

Maintain write-a-skill?

Let people know it's listed here — add the badge (live metrics, light/dark aware) or a plain link to your README or docs.

write-a-skill on getagentictools
[![write-a-skill on getagentictools](https://getagentictools.com/badge/skills/mattpocock-skills-write-a-skill.svg)](https://getagentictools.com/skills/mattpocock-skills-write-a-skill?ref=badge)
npx agentictools info skills/mattpocock-skills-write-a-skill

The second line is the CLI lookup for this page — handy in READMEs and docs.