| name | skill-generation |
| description | Generate new agent skills following the project's conventions. Covers file structure, frontmatter format, section layout, and the generation workflow. |
When to Activate
Use this skill whenever the user asks to create, generate, or scaffold a new skill (or "agent skill").
Skill File Structure
A skill is a single Markdown file located at:
~/workspace/kocal/dotfiles/nix/home/claude/skills/<skill-name>/SKILL.md
Where <skill-name> is a short, lowercase, hyphenated identifier (e.g. github-cli, natural-writing, skill-generation).
Frontmatter
Every SKILL.md starts with a YAML frontmatter block containing exactly two fields:
---
name: <skill-name>
description: <One sentence describing when and why this skill should be loaded. Keep it under 200 characters.>
---
The description is what the agent sees in the skill list to decide whether to load it, so it must be precise and self-explanatory.