| name | oss-contributor-swarm |
| description | Autonomous 9-agent swarm that continuously contributes to open source projects on GitHub. Finds good-first-issues, analyzes requirements, writes code/tests/docs, creates PRs, and responds to reviews - all automatically with learning. |
| version | 2.0.0 |
| author | niveshdandyan |
| triggers | ["contribute to open source","oss contributor","open source swarm","automated contributions","github contributor bot","good first issue finder","pr automation"] |
OSS Contributor Swarm Skill
"I don't just write PRs. I continuously contribute to open source while learning from every interaction."
This skill deploys a 9-agent swarm that autonomously:
- Qualifies repositories for contribution-friendliness
- Finds suitable "good first issues"
- Analyzes requirements
- Clones and understands codebases
- Writes fixes/features
- Adds tests (if needed)
- Updates documentation (if needed)
- Creates professional pull requests
- Responds to review feedback automatically
Quick Start
./scripts/run-swarm.sh single
./scripts/run-swarm.sh start
./scripts/run-swarm.sh dashboard
Prerequisites
- GitHub CLI (
gh) - authenticated
- Claude Code CLI (
claude)
jq and git
Key Features
Continuous Mode
Runs 24/7, automatically finding and contributing to open source projects.
Learning System
Tracks success patterns and improves over time:
- Best issue types (typo, docs, tests)
- Best languages and repo sizes
- Maintainer preferences
- Auto-avoids problematic repos
Auto-Fix Reviews
Agent 8 can automatically fix simple review requests:
- Typos, style, formatting → Auto-fix
- Logic changes → Escalate to human
Configuration
Edit config/swarm-config.json to customize:
- Target daily PRs (default: 3-5)
- Max concurrent PRs (default: 3)
- Repo qualification criteria
- Learning parameters
Safety
- Never force pushes
- Respects CONTRIBUTING.md
- Max 5 files / 100 lines per PR
- Human approval for security changes
See README.md for full documentation.
