skill-authoring
por kjaylee
Coding Agents & IDEsResumo
Guide for creating effective SKILL.md files that extend agent capabilities.
Descrição
O que esta skill faz
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.
Quando usá-la
- 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
Exemplo de fluxo de trabalho
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
Instalação
clawhub install kjaylee/skill-authoringExecute o comando da CLI ou cole o prompt no Claude Code, Cursor, Codex ou no agente de código que você usa.