Claude-skill-registry-data minion-sweep

install
source · Clone the upstream repo
git clone https://github.com/majiayu000/claude-skill-registry-data
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/majiayu000/claude-skill-registry-data "$T" && mkdir -p ~/.claude/skills && cp -r "$T/data/minion-sweep" ~/.claude/skills/majiayu000-claude-skill-registry-data-minion-sweep && rm -rf "$T"
manifest: data/minion-sweep/SKILL.md
source content

Minion Sweep

Codebase-wide maintenance scan.

When to Invoke

  • User requests "add docstrings to all files"
  • Periodic codebase cleanup
  • Tech debt reduction

Commands

# Discover what needs work
source .venv/bin/activate && python scripts/minions.py --json sweep <dir> --task <task>

# Apply fixes
source .venv/bin/activate && python scripts/minions.py --json sweep <dir> --task <task> --apply

Tasks

TaskWhat it checks
all
Everything (default)
docstrings
Missing function/class/module docstrings
types
Missing type hints
headers
Missing module-level docstrings only

Examples

# Discover
python scripts/minions.py --json sweep src/ --task docstrings

# Apply
python scripts/minions.py --json sweep src/ --task docstrings --apply

# With backups
python scripts/minions.py --json sweep src/ --task all --apply --backup

Output (Discover)

{
  "candidates": [
    {"file": "src/foo.py", "lines": 120, "missing": ["3 functions without docstrings"]}
  ],
  "total_candidates": 1,
  "skipped": []
}

Claude Integration

  1. Run discover first to show scope
  2. Confirm with user: "Found 12 files. Apply?"
  3. Run with --apply on approval
  4. Report summary