dot-skillslisted
Install: claude install-skill fmind/dot
# Maintain Dot Skills
Maintain first-party skills and their chezmoi links. [skillify](../../../skills/skillify/SKILL.md) owns authoring; its [package rules](../../../skills/skillify/references/package-rules.md) define package shape, resources, and standalone portability.
## Workflow
1. **Choose the owner**: inspect `git diff` and `git diff --cached`, then read neighboring descriptions and extend an existing skill when it owns the workflow. Reusable skills belong in `skills/`; repository procedures belong in `.agents/skills/`.
1. **Register additions**: add each skill and its required CLI tools to [contracts.json](../../../skills/contracts.json), and a primary case to [routing-boundaries.json](../../../dot/testdata/skills/routing-boundaries.json). Each global skill also needs `dot_agents/skills/symlink_<name>.tmpl` containing `{{ .chezmoi.sourceDir }}/skills/<name>`.
1. **Connect resources**: link each supporting resource directly from `SKILL.md`. Update project `AGENTS.md` when workflow ownership changes; setup/auth instructions belong in `README.md`.
1. **Validate**: run `mise run check:skills` while iterating, then `mise run all` on the intended candidate. For installation changes, target `uv run --frozen pytest -q dot/tests/test_skill_links.py` first. Use [git-worktree](../../../skills/git-worktree/SKILL.md) to isolate unrelated work from formatters. Review `mise run report:skills` when descriptions or routing cases change; its lexical ranking is diagnostic.
1. **Exerci