| name | agents-skill-save |
| description | Use when creating a new local skill or fixing an existing skill that was saved to the wrong skills tree. Symptoms - a skill was written under ~/.claude/skills, the active setup uses ~/.agents/skills, or skill instructions still reference the old path convention. |
Agents Skill Save
When to Use
Use this when you need to save a new skill into the active local skills tree, or when an existing skill still points at the older ~/.claude/skills/ layout.
It is especially useful after creating a skill from session work and needing to place it in the right directory the first time.
Commands
ls -la ~/.agents ~/.agents/skills
sed -n '1,260p' /path/to/SKILL.md
mkdir -p ~/.agents/skills/<skill-name>
mv ~/.claude/skills/<old-path>/SKILL.md ~/.agents/skills/<skill-name>/SKILL.md
sed -n '1,220p' ~/.agents/skills/<skill-name>/SKILL.md
Common Failures
| Symptom | Fix |
|---|
~/.agents/skills exists but the new skill was written under ~/.claude/skills | Move the file into ~/.agents/skills/<name>/SKILL.md and remove the misplaced copy |
Skill text still mentions ~/.claude/skills/ | Patch the instructions so future skill writes follow the active tree |
Unsure whether to use a personal namespace like joe/ | Do not invent one unless the existing ~/.agents/skills/ tree already uses it |
| Parent directory does not exist | Create it first with mkdir -p ~/.agents/skills/<skill-name> |
| Not sure whether a manifest must be updated | Check ~/.claude/plugins/ and ~/.agents/ metadata only if the current setup actually uses registration |