# Remove Skill > Remove a tracked skill directory and purge non-archived repo references (breaking change). Use when this capability is needed. - Skill: `tomevault-io/remove-skill` (Agent Skill, multi-file: 2 files) - Install (CLI): `npx skillmds@latest add tomevault-io/remove-skill` - Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/remove-skill/raw - Safety review: pending (external: skill-scanner PASS, skillspector CAUTION) - Works with: Claude Code, Claude.ai, OpenAI Codex - Category: AI & ML - Author: tomevault-io (https://skillmd.com/u/tomevault-io) - Updated: 2026-09-17 - Page: https://skillmd.com/skills/tomevault-io/remove-skill --- # Remove Skill ## Contract Prereqs: - Run inside a git work tree. - `bash`, `git`, `python3`, and `rg` available on `PATH`. - You understand this is a breaking change (no compatibility shims are created). Inputs: - Target directory via `--skill-dir` (must start with `skills/`). - Safety flags: - `--dry-run` to print planned changes without writing. - `--yes` to 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 references - `1`: deletion failed or references remain - `2`: usage error Failure modes: - `--skill-dir` invalid or missing `SKILL.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](https://tomevault.io/claim/graysurf) — claim your Tome and manage your conversions.