# Minion Swarm

> PROACTIVELY USE when same mechanical change is needed on multiple files (add headers, comments, etc.). Delegates parallel grunt work to local LLMs — saves cloud tokens. Runs in parallel for speed. Use instead of repetitive manual edits. Files must be <500 lines each.

- Skill: `majiayu000/minion-swarm` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds add majiayu000/minion-swarm`
- Raw SKILL.md: https://api.skillmd.com/api/skills/majiayu000/minion-swarm/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: DevOps & Infra
- Author: majiayu000 (https://skillmd.com/u/majiayu000)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/majiayu000/minion-swarm

---


# Minion Swarm

Parallel patches on multiple files.

## When to Invoke

- Same change needed on many files
- Adding headers/comments across codebase
- Batch mechanical operations

## Command

```bash
source .venv/bin/activate && python scripts/minions.py --json swarm "<task>" <files...>
```

## Examples

```bash
# Add header to multiple files
python scripts/minions.py --json swarm "Add # Minions header" src/a.py src/b.py src/c.py

# With more workers
python scripts/minions.py --json swarm "Add docstring" *.py --workers 5
```

## Output

```json
{
  "completed": [{"target": "src/a.py", "result": "success"}],
  "failed": [],
  "stats": {"completed": 3, "failed": 0, "total": 3}
}
```

## Limits

- Each file <500 lines
- Mechanical changes only
- Default 3 parallel workers