skill-authoring
par kjaylee
Coding Agents & IDEsRésumé
Guide for creating effective SKILL.md files that extend agent capabilities.
Description
Ce que fait ce skill
A guide for writing SKILL.md files that extend agent capabilities on the agentskills.io standard. Covers frontmatter structure, conciseness principles, and freedom-level matching for different task types.
Provides explicit anti-patterns and a freedom-level framework that prevent authors from over-specifying or under-specifying agent behavior.
Quand l'utiliser
- Writing a new SKILL.md for a custom agent workflow
- Updating an existing skill's description to improve activation reliability
- Teaching an agent a domain-specific process it doesn't already know
- Deciding how prescriptive skill instructions should be for a given task
- Splitting a large skill into SKILL.md and references/ for token efficiency
Exemple de workflow
User asks: Write a SKILL.md for a code review workflow
- 1
Identify the task type and determine the appropriate freedom level (high, medium, or low)
- 2
Draft frontmatter with name, description, and metadata fields
- 3
Write instructions matching the chosen freedom level, using scripts or pseudocode where consistency is required
- 4
Add directory structure if scripts or reference documents are needed
- 5
Review for token efficiency and remove any explanations the agent already knows
A complete SKILL.md file with frontmatter, structured instructions, and guardrails appropriate for the code review workflow
Installation
clawhub install kjaylee/skill-authoringExécute la commande CLI, ou colle l'instruction dans Claude Code, Cursor, Codex ou l'agent de code que tu utilises.