Skip to content
Content
Skill

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

BOOST
From plugin
happycapy-skills
13757 skills
Install
$ npx -y skills add happycapy-ai/happycapy-skills --skill oss-contributor-swarm --agent claude-code

How it fires

How this skill gets triggered: by you, by Claude, or both.

  • Fires itselfAuto-invocation. Claude auto-loads it when your prompt matches the work.Auto-invocation is when the right skill fires by itself at the right moment, driven by a FLOW.md router and a hook, instead of you invoking it by name. It is the difference between a skill being installed and a skill actually getting used.Read the full definition →
  • You can call itInvoke it directly when you want it.
  • Slash command/oss-contributor-swarm

Context preview

The summary Claude sees to decide when to auto-load this skill.

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.

SKILL.md

oss-contributor-swarm.SKILL.md
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: 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.

Read more
Ships withhappycapy-skills

A curated collection of high-quality Claude Code skills to enhance your development workflow

Get the whole plugin

Other skills on happycapy-skills.