skill-authoringlisted
Install: claude install-skill Rhovian/niles
# Skill authoring
A skill shares a context window with everything else, and agents you don't control will load it. It earns its tokens only by changing what an agent would otherwise do. Measure that instead of assuming it.
## Process
Steps 1, 7, 8, and 9 need a fresh agent with no context: either a subagent, or the user running a prompt in a new session. If neither is available, do those steps yourself as a cold read and mark them unverified in the handoff. Don't present a self-review as a baseline.
To fix or review an existing skill, first reproduce the problem (step 9 for triggering, step 1 for behavior), then run steps 3-8 on the change.
1. Watch it fail first. Run 2-3 realistic tasks with no skill, and record what goes wrong, verbatim where you can. The skill fixes those failures and stays brief about everything the baseline already does well.
2. Write the description for triggering. It's the only part that's always loaded (1024 characters at most, and some listings truncate sooner), so put the trigger first. Say when to use the skill, in the user's words, and when not to. Agents tend to under-trigger, so name concrete situations.
3. Write the body for a capable agent that isn't necessarily Claude.
- Keep instructions that change default behavior. Keep exact commands, configs, versions, paths, and gotchas, meaning anything that drifts between versions or that an older or smaller model would get wrong.
- Cut explanations of things any capable agent knows, and