sd0xdev/sd0x-harness/safe-remove
Claude Code and agent skill by sd0xdev/sd0x-harness
- community
Checking that the SKILL.md file is still in the repository.
Safely remove plugin assets (skill/agent/rule/script/hook) with dependency detection and reference cleanup. Use when: user says 'remove skill', 'delete skill', 'deprecate', 'clean up unused', or /safe-remove. Not for: code refactoring (use /simplify), feature removal requiring architecture changes (manual).
Install
npx vskill@latest install sd0xdev/sd0x-harness/safe-removeSKILL.md
The same SKILL.md was published earlier as sd0xdev/sd0x-harness/safe-remove.
Safe Remove
Safely remove plugin assets by discovering dependencies, classifying impact, and executing removal with verification.
Input
/safe-remove <type> <name> [--execute] [--dry-run]
| Argument | Description | Default | |
|---|---|---|---|
<type> | Asset type: skill, agent, rule, script, hook | Required | |
<name> | Asset name (e.g., create-skill, strict-reviewer) | Required | |
--execute | Apply removal (with AskUserQuestion confirmation) | off | |
--dry-run | Output plan only (default behavior) | on |
If both--dry-runand--executeare provided,--dry-runwins (safe default).
Workflow
Phase 1: Resolve Target
Validate <type> and locate canonical files for the asset.
| Type | Primary Files | Secondary Files | |
|---|---|---|---|
skill | skills/<name>/ (entire directory) | — | |
agent | agents/<name>.md | — | |
rule | rules/<name>.md | .claude/rules/<name>.md (mirror) | |
script | scripts/<name>.* | — | |
hook | Entry in hooks/hooks.json | Hook script file |
If target not found, output error: Target not found: <type> <name> and stop.
Phase 2: Build Reference Graph
Scan the entire codebase for references to the target. Use type-specific patterns from references/removal-policy.md.
Phase 3: Classify Impacts
Apply 2-tier classification per references/removal-policy.md:
| Tier | Definition | Action | |
|---|---|---|---|
| BLOCKER | Structured runtime binding — removal breaks execution | HALT with file:line details | |
| PATCHABLE | Prose/documentation reference — safe to auto-edit | Include in patch plan |
Phase 4: Apply (--execute only)
Requires AskUserQuestion confirmation before any changes.
Execution order (patches first, deletes last):
- Patch PATCHABLE references:
- Remove the skill's entry from
docs/skill-catalog.yml(tracked CLAUDE files carry no command table since R3; still grep them for prose mentions) - Remove/update entries in README.md + locale variants (count + detail row)
- Update prose mentions in other skills/rules
- Delete target files:
- For
skilltype: remove entireskills/<name>/directory +test/skills/<name>*.test.js - For
scripttype: removescripts/<name>.*+test/scripts/<name>.test.js - For
hooktype: remove hook script + JSON entry +test/hooks/<name>.test.js - For other types: remove primary + secondary files per Phase 1 table
- Remove empty directories after deletion
Note:.claude/CLAUDE.mdmust be patched directly — do not rely on hook auto-sync for content removal.
Phase 5: Verify
Run type-specific verification from references/removal-policy.md:
If residual references found, report them. If clean, output Verification passed.
Output Format
Dry-run Plan
Prohibited
- Auto-triggering (always explicit invocation only)
- Deleting without
--executeflag + user confirmation - Removing assets referenced in auto-loop rules without user acknowledgment
- Force-deleting when BLOCKERs exist
- Modifying files outside the removal scope (no side-effect changes)
References
| File | Purpose | When to Read | |
|---|---|---|---|
references/removal-policy.md | BLOCKER/PATCHABLE classification rules + per-asset-type matrix | Always (Phase 2-5) |
Examples
Security
- Security scanPassed, 100 of 100Pattern checks on the skill's files.
- Model reviewNot runA model review is scheduled for the next rescan.
Quality evaluation
- Task evaluationNot runNo evaluation yet. Run one in Skill Studio.
Source
- SKILL.md in the repositoryCheckingskills/safe-remove/SKILL.md
Popularity
- Repository stars
- 191
- Repository forks
- 26
- 7-day trend score
- 31
Stars and forks are for the whole GitHub repository, not this skill alone. Not refreshed yet.
Works with
Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.
- Claude Code
- Cursor
- GitHub Copilot
- Windsurf
- Codex
- Gemini CLI
- Cline
- Amp
- Roo Code
- Goose
- Continue
- Kilo Code
- Junie
- Trae
- OpenHands
- Qwen Code
- AI Agent
- Tabnine Chat
- Sourcegraph Cody
- Amazon Q
- Firebase Genkit
- Sweep
- Devin
- Phind
- Mentat
- Claude Desktop
- Aider
- GPT Pilot
- Plandex
- bolt.new
- v0
- Replit Agent
- Anse
- TypingMind
- BetterChatGPT
- LibreChat
- Warp AI
- Pieces
- Fig AI
Embed badge
[](https://verified-skill.com/skills/sd0xdev/sd0x-harness/safe-remove)