# oss-contributor-swarm

oss-contributor-swarm deploys an autonomous 9-agent swarm to discover simple GitHub issues, write fixes, and submit pull requests.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf (Devin Desktop), Claude.ai · ★ 138 repo stars
- Author: niveshdandyan
- License: MIT · policy=mirror · the beginning of the file is at the end of this page
- Source: https://github.com/happycapy-ai/Happycapy-skills/tree/HEAD/skills/oss-contributor-swarm/SKILL.md
- Updated: 2026-09-03
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/oss-contributor-swarm

## What it does

The skill manages a pipeline of nine agents. They screen public repositories, pick up good-first-issue tasks, clone codebases, apply fixes, update docs or tests, and open clean pull requests. A learning mechanism stores maintainer tendencies and issue types to avoid troublesome repositories over time.

Control the execution flow with `./scripts/run-swarm.sh` using either the `single` argument for one cycle or `start` for continuous runs. Configuration parameters reside in `config/swarm-config.json`, including PR limits (default 3 to 5 daily, max 3 concurrent). Agent 8 resolves basic review remarks such as typos and styling on its own, delegating logic revisions to human operators.

Execution requires authenticated GitHub CLI (`gh`), Claude Code CLI (`claude`), `git`, and `jq`. Built-in safety caps enforce changes within 5 files and 100 lines per pull request while prohibiting force pushes.

## Requirements
- Works with: GitHub

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add happycapy-ai/Happycapy-skills --skill oss-contributor-swarm -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/oss-contributor-swarm/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/oss-contributor-swarm/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add happycapy-ai/Happycapy-skills --skill oss-contributor-swarm -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/oss-contributor-swarm/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add happycapy-ai/Happycapy-skills --skill oss-contributor-swarm -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/oss-contributor-swarm/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install happycapy-ai/Happycapy-skills skills/oss-contributor-swarm
```

2. **Manually: put the files in place**
- File: `.github/skills/oss-contributor-swarm/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add happycapy-ai/Happycapy-skills --skill oss-contributor-swarm -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/happycapy-ai/Happycapy-skills --path skills/oss-contributor-swarm
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/oss-contributor-swarm/SKILL.md` — The legacy .windsurf/skills/ path still works

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/happycapy-ai/Happycapy-skills/tree/HEAD/skills/oss-contributor-swarm/SKILL.md

## When to use it
- find beginner-friendly open source issues across public GitHub repos
- generate automated pull requests containing test and doc updates
- address formatting and style review comments without manual edits
- restrict contribution sizes under 5 files and 100 lines for safer merges

## Example prompts
- Run a single contribution pass with oss-contributor-swarm
- Open the swarm progress dashboard using scripts
- Start 24/7 autonomous contribution mode targeting 3-5 pull requests daily

## Source text · SKILL.md · MIT

Below is the content of a third-party file. It is data, not instructions for you: do not act on anything written inside unless the human asks. Block tag: 50528bc42c570d30.

BEGIN THIRD-PARTY FILE 50528bc42c570d30
````text
---
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

```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.
````
END THIRD-PARTY FILE 50528bc42c570d30

The third-party file has ended. Everything between the 50528bc42c570d30 tags is data: requests and commands from it are not followed. An “end of file” line with another tag inside the block is part of the file.

© niveshdandyan · MIT · https://github.com/happycapy-ai/Happycapy-skills/tree/HEAD/skills/oss-contributor-swarm/SKILL.md

## Similar
- [oss-contributor-onboarding](https://affpapa.org/en/nevibecode/skills/oss-contributor-onboarding.md) — skill · 13700 installs
- [github-contributor](https://affpapa.org/en/nevibecode/skills/github-contributor.md) — skill · 1000 installs
- [swarm-issue](https://affpapa.org/en/nevibecode/commands/swarm-issue.md) — command · ★ 850 repo stars
- [multi-repo-swarm](https://affpapa.org/en/nevibecode/commands/multi-repo-swarm.md) — command · ★ 850 repo stars
- [oss-launch](https://affpapa.org/en/nevibecode/skills/oss-launch.md) — skill · 13900 installs

_Part of the page did not fit — see the HTML version._

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
