oss contributor swarm
- Repo stars 122
- License MIT
- Author repo Happycapy-skills
- Domain
- AI
- Author-declared agents
- No explicit declaration found; this is not inferred or tested compatibility
- Static check
- 98 / 100 · heuristic scan, not runtime safety proof
- Runtime evidence
- Not run; no isolated runtime test evidence is currently recorded
- Author / version / license
- @happycapy-ai · v2.0.0 · MIT
- Token usage
- Lean
- Setup complexity
- Plug-and-play
- External API key
- Not required
- Operating systems
- Unspecified (assume cross-platform)
- Runtime requirements
- No explicit requirements detected
- Detected file/system behavior
-
- Read-only
- Write / modify
- Network behavior
- Local-only
- Install commands
- None (reference only)
Heads up: Tool permissions are not declared; actual access depends on the runtime.
# 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:
1. Qualifies repositories for contribution-friendliness
2. Finds suitable "good first issues"
3. Analyzes requirements
4. Clones and understands codebases
5. Writes fixes/features
6. Adds tests (if needed)
7. Updates documentation (if needed)
8. Creates professional pull requests
9. Responds to review feedback automatically
## Quick Start
```bash
# Run a single contribution cycle
./scripts/run-swarm.sh single
# Run continuous 24/7 mode (target: 3-5 PRs/day)
./scripts/run-swarm.sh start
# View dashboard
./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.
Sections and files
Listed in source order.
sections -> Quick Start → Prerequisites → Key Features → Continuous Mode → Learning System → Auto-Fix Reviews
terms -> 9-agent swarm · > "I don't just write PRs. · This skill deploys a 9-agent swarm that autonomously: 1. · See README.md for full documentation.
files/cmd -> git · config/swarm-config.json · fixes/features · ./scripts/run-swarm.sh · 24/7 · PRs/day · CONTRIBUTING.md · README.md
body sha256 -> c72ef1028162
Prerequisites
GitHub CLI (
gh) - authenticated Claude Code CLI (claude)jqandgitContinuous 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.jsonto customize: Target daily PRs (default: 3-5) Max concurrent PRs (default: 3) Repo qualification criteria Learning parameters