OpenSkillIndex← back to search
claude-code

Skillshub oss-contributor-swarm

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.

install
source · Clone the upstream repo
git clone https://github.com/ComeOnOliver/skillshub
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/ComeOnOliver/skillshub "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/happycapy-ai/Happycapy-skills/oss-contributor-swarm" ~/.claude/skills/comeonoliver-skillshub-oss-contributor-swarm && rm -rf "$T"
manifest: skills/happycapy-ai/Happycapy-skills/oss-contributor-swarm/SKILL.md
source content

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

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