From minions
PROACTIVELY USE after implementing code to add docstrings, type hints, cleanup. Delegates grunt work to local LLMs — saves cloud tokens. Files must be <500 lines. Use for mechanical polish, not logic changes. Changes are auto-applied.
How this skill is triggered — by the user, by Claude, or both
Slash command
/minions:skills/minion-polishThis skill is limited to the following tools:
The summary Claude sees in its skill listing — used to decide when to auto-load this skill
Dispatch local model to add mechanical polish. Changes are auto-applied.
Dispatch local model to add mechanical polish. Changes are auto-applied.
source .venv/bin/activate && python scripts/minions.py --json polish <files> --task <task>
| Task | Description |
|---|---|
all | Docstrings + types + headers (default) |
docstrings | Add function/class docstrings |
types | Add type hints |
headers | Add module-level docstrings |
# Polish single file
python scripts/minions.py --json polish src/foo.py --task all
# Multiple files
python scripts/minions.py --json polish src/foo.py src/bar.py --task docstrings
# Dry run
python scripts/minions.py --json polish src/foo.py --task all --dry-run
{
"applied": true,
"files_modified": ["src/foo.py"],
"changes": ["src/foo.py: Added 3 docstring(s)"],
"errors": [],
"stats": {"total": 1, "applied": 1, "failed": 0}
}
After completing code:
npx claudepluginhub felixmanojh/minions --plugin minionsImproves Python code quality with static analysis (ruff/mypy), Any type elimination, modernization plans (Protocols/Generics/Pydantic), plan review, and test-driven refactoring.
Configures ruff/mypy for Python linting/formatting, enforces PEP 8 naming/docstrings/type hints. Use for new projects, code reviews, or style standards.
Routes documentation tasks to code comments (audit/cleanup) or system docs (READMEs, API docs, architecture). Use for writing, auditing, or improving any docs.