oss-contributor-swarm - SKILL.md Agent Skill

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

# 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.