Agent skill · writing content · alirezarezvani
write-a-skill
Create new agent skills with proper structure, progressive disclosure, and bundled resources. Use when user wants to create, write, build, or author a new skill.
Why this skill is useful
Provides a structured process for creating agent skills, including templates and validation tools that the AI wouldn't reliably generate on its own.
What it needs
Requires python installed locally. About 3k tokens when loaded. Last updated 2026-08-05. 23,939 stars on the source repository.
What this skill does
Writing Skills Derived from Matt Pocock's write-a-skill (MIT). Matt's voice and 3-phase workflow preserved verbatim. Additions: validation tools + references + cs- wrapper (see Tooling + Companions below). Process 1. Gather requirements - ask user about: 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? 2. Draft the skill - create: SKILL.md with concise instructions Additional reference files if content exceeds 500 lines Utility scripts if deterministic operations needed 3. Review with user - present draft and ask: Does this cover your use cases? Anything missing or unclear? Should any section be more/less detailed? Skill Structure SKILL.md Template Description Requirements The description is the only thing your agent sees when deciding which skill to load. It's surfaced in the system prompt alongside all other installed skills. Your agent reads these descriptions and picks the relevant skill based on the user's request. Goal: Give your agent just enough info to know: 1. What capability this skill provides 2. When/why to trigger it (specific keywords, contexts, file types) Format: Max 1024 chars Write in third person First sentence: what it does Second sentence: "Use when [specific triggers]" Good example: Bad example: The bad example gives your agent no way to distinguish this from other document skills. When to Add Scripts Add utility scripts when: Operation is deterministic (validation, formatting) Same code would be generated repeatedly Errors need explicit handling Scripts save tokens and improve reliability vs generated code. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills alirezarezvani/write-a-skill--a25d08