File contents 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
Task
What it checks
allEverything (default)
docstringsMissing function/class/module docstrings
typesMissing type hints
headersMissing 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
Run discover first to show scope
Confirm with user: "Found 12 files. Apply?"
Run with --apply on approval
Report summary
Converted and distributed by TomeVault — claim your Tome and manage your conversions.
1 --- 2 name: felixmanojh-minions-minion-sweep 3 description: Minion Sweep 4 --- 5 6 # Minion Sweep 7 8 Codebase-wide maintenance scan. 9 10 ## When to Invoke 11 12 - User requests "add docstrings to all files" 13 - Periodic codebase cleanup 14 - Tech debt reduction 15 16 ## Commands 17 18 ```bash 19 # Discover what needs work 20 source .venv/bin/activate && python scripts/minions.py --json sweep <dir> --task <task> 21 22 # Apply fixes 23 source .venv/bin/activate && python scripts/minions.py --json sweep <dir> --task <task> --apply 24 ``` 25 26 ## Tasks 27 28 | Task | What it checks | 29 |------|----------------| 30 | `all` | Everything (default) | 31 | `docstrings` | Missing function/class/module docstrings | 32 | `types` | Missing type hints | 33 | `headers` | Missing module-level docstrings only | 34 35 ## Examples 36 37 ```bash 38 # Discover 39 python scripts/minions.py --json sweep src/ --task docstrings 40 41 # Apply 42 python scripts/minions.py --json sweep src/ --task docstrings --apply 43 44 # With backups 45 python scripts/minions.py --json sweep src/ --task all --apply --backup 46 ``` 47 48 ## Output (Discover) 49 50 ```json 51 { 52 "candidates": [ 53 {"file": "src/foo.py", "lines": 120, "missing": ["3 functions without docstrings"]} 54 ], 55 "total_candidates": 1, 56 "skipped": [] 57 } 58 ``` 59 60 ## Claude Integration 61 62 1. Run discover first to show scope 63 2. Confirm with user: "Found 12 files. Apply?" 64 3. Run with --apply on approval 65 4. Report summary 66 67 --- 68 > Converted and distributed by [TomeVault](https://tomevault.io/claim/felixmanojh) — claim your Tome and manage your conversions. 69 <!-- tomevault:4.0:skill_md:2026-04-15 -->
commit 0931e0a239
Frequently asked questions How do I install the Felixmanojh Minions Minion Sweep skill? Run npx skillmds@latest add tomevault-io/felixmanojh-minions-minion-sweep in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.
What does the Felixmanojh Minions Minion Sweep skill do? Minion Sweep It is listed under Coding & Dev Tools on SkillMD.
Is Felixmanojh Minions Minion Sweep safe to use? This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.
Which AI agents work with Felixmanojh Minions Minion Sweep? This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.
Is Felixmanojh Minions Minion Sweep free to use? Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.
Who published Felixmanojh Minions Minion Sweep? tomevault-io (@tomevault-io) published this skill. Their other Agent Skills are listed on their SkillMD profile.
tomevault-io