unstale
FeaturedDetect and repair staleness residue in Python library code and notebooks — dead imports, dead code, resolved TODOs, stale comments/docstrings, and HANDOFF blockers. Use this whenever you want to clean up after a refactor, fix a comment that no longer matches the code, remove unused imports, check for leftover TODOs, detect doc drift, or tidy a notebook before sharing or submission — even without the word "unstale." Default mode auto-detects library .py scope and runs ruff + vulture (deterministic), then LLM semantic checks; never touches notebooks. `--artifact <nb.ipynb>` cleans a notebook as a deliverable (full treatment including dead-code detection). `--exploratory <nb.ipynb>` tidies a working notebook non-destructively (structural + semantic only, no removals ever). Always emits a structured report before any edit.
Install
Quality Score: 90/100
Skill Content
Details
- Author
- dgilford
- Repository
- dgilford/ai-science-toolkit
- Created
- 3 months ago
- Last Updated
- yesterday
- Language
- Shell
- License
- MIT
Similar Skills
Semantically similar based on skill content — not just same category
code-cleanup
Detect stale TODOs, unused imports, and dead code.
loose-ends
Use when a repo has accumulated unfinished work notes — todo lists, plans, specs, handoffs, parked findings, night reports — scattered across branches, worktrees and agent scratch directories, and the user wants to read, reconcile and clean them up. Triggers on "/loose-ends", "clean up my todos", "what's parked", "reconcile these markdowns", "I have half-finished plans everywhere", "which of these docs can I delete", "repo cleanup", "unfinished notes".
cleanup-audit
Multi-agent parallel investigation that finds bugs, drift, dead code, redundant docs, and stale references in this repo. Spawns 8 read-only sub-agents on independent axes (stale-refs first, then consistency × 3, redundancy × 2, dead-artifact × 2), deduplicates findings, classifies into 5 tiers, and surfaces user-only decisions. Use after major refactors, before releases, or for periodic repo hygiene checks.