Remove Skill
Contract
Prereqs:
- Run inside a git work tree.
bash,git,python3, andrgavailable onPATH.- You understand this is a breaking change (no compatibility shims are created).
Inputs:
- Target directory via
--skill-dir(must start withskills/). - Safety flags:
--dry-runto print planned changes without writing.--yesto skip the interactive confirmation prompt.
Outputs:
- Deletes the skill directory under
--skill-dir(tracked + untracked files). - Deletes any matching script-spec files under
tests/script_specs/**for scripts in that skill. - Removes references in tracked Markdown files.
- Fails if any remaining references are found.
Exit codes:
0: removed + no remaining references1: deletion failed or references remain2: usage error
Failure modes:
--skill-dirinvalid or missingSKILL.md.- Remaining references in non-Markdown tracked files (must be fixed manually).
Scripts (only entrypoints)
$AGENT_HOME/skills/tools/skill-management/remove-skill/scripts/remove_skill.sh
Converted and distributed by TomeVault — claim your Tome and manage your conversions.