Skip to main content
skill CX Codex

oss-contributor-swarm — Claude Code skill: setup & overview

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

MIT ★ 138 updated 2026-09-03

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add happycapy-ai/Happycapy-skills --skill oss-contributor-swarm -a claude-code
Open on GitHub

What oss-contributor-swarm 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.

What it helps with

  • 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 for the agent

  • 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

How to install oss-contributor-swarm

1Skills CLI (Vercel)

npx skills add happycapy-ai/Happycapy-skills --skill oss-contributor-swarm -a claude-code

2Manually: put the files in place

~/.claude/skills/oss-contributor-swarm/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/oss-contributor-swarm/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about oss-contributor-swarm

How to install oss-contributor-swarm in Claude Code?

Run npx skills add happycapy-ai/Happycapy-skills --skill oss-contributor-swarm -a claude-code in your terminal.

What does oss-contributor-swarm do?

It coordinates a 9-agent team that searches for good first issues on GitHub, writes code fixes with tests, submits PRs, and handles basic review feedback.

What dependencies are required before running the swarm?

You must install and authenticate GitHub CLI (gh), plus have Claude Code CLI (claude), git, and jq available in your system path.

Source text

SKILL.md · MIT
---
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.

© niveshdandyan · MIT · happycapy-ai/Happycapy-skills

Similar skills

All skills for Git and GitHub →

From the same set41

The whole set →
video-frames video-frames pulls frames and thumbnails from video files using ffmpeg. It helps Claude Code inspect video contents or grab screenshots at specific timestamps. CX Codex +1 ★ 138repo stars weather Fetches current conditions and forecasts for a city or airport. It works for quick answers and JSON-based weather requests. CX Codex +1 ★ 138repo stars llm-council llm-council is a Claude Code skill that sends one prompt to several AI models and displays their replies side by side, with shared-answer synthesis and anonymous voting. CX Codex +1 ★ 138repo stars capy-cortex capy-cortex keeps a local base of rules, anti-patterns and preferences, then feeds the matching ones into context through hooks. Useful when an agent keeps repeating the same mistakes. CX Codex +1 ★ 138repo stars happycapy-skill-creator happycapy-skill-creator adapts existing skills from anthropics/skills for HappyCapy environments. It strips Docker dependencies and bundles the result into a .skill archive. CX Codex +1 ★ 138repo stars youtube-music Search YouTube Music by track or artist, then open a result in the default browser. It needs an API key and MCP configuration. CX Codex +1 ★ 138repo stars agent-4-code-writer agent-4-code-writer — a Claude Code subagent that implements fixes or features within an open-source contributor swarm using an existing issue plan and codebase map. CX Codex ★ 138repo stars agent-3-codebase-explorer agent-3-codebase-explorer explores a repository before a fix or feature, locating relevant files and documenting the project structure for the next agents. CX Codex ★ 138repo stars

Project sponsors

Companies that keep this analytics open