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.

25 stars

Best use case

oss-contributor-swarm is best used when you need a repeatable AI agent workflow instead of a one-off prompt.

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.

Teams using oss-contributor-swarm should expect a more consistent output, faster repeated execution, less prompt rewriting.

When to use this skill

  • You want a reusable workflow that can be run more than once with consistent structure.

When not to use this skill

  • You only need a quick one-off answer and do not need a reusable workflow.
  • You cannot install or maintain the underlying files, dependencies, or repository context.

Installation

Claude Code / Cursor / Codex

$curl -o ~/.claude/skills/oss-contributor-swarm/SKILL.md --create-dirs "https://raw.githubusercontent.com/ComeOnOliver/skillshub/main/skills/happycapy-ai/Happycapy-skills/oss-contributor-swarm/SKILL.md"

Manual Installation

  1. Download SKILL.md from GitHub
  2. Place it in .claude/skills/oss-contributor-swarm/SKILL.md inside your project
  3. Restart your AI agent — it will auto-discover the skill

How oss-contributor-swarm Compares

Feature / Agentoss-contributor-swarmStandard Approach
Platform SupportNot specifiedLimited / Varies
Context Awareness High Baseline
Installation ComplexityUnknownN/A

Frequently Asked Questions

What does this skill do?

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.

Where can I find the source code?

You can find the source code on GitHub using the link provided at the top of the page.

SKILL.md Source

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

Related Skills

github-contributor

25
from ComeOnOliver/skillshub

Strategic guide for becoming an effective GitHub contributor. Covers opportunity discovery, project selection, high-quality PR creation, and reputation building. Use when looking to contribute to open-source projects, building GitHub presence, or learning contribution best practices.

swarm

25
from ComeOnOliver/skillshub

Autonomous multi-agent workflow system for complex coding tasks. Use when the user requests non-trivial changes that would benefit from autonomous execution with built-in review gates. Ideal for refactoring modules, adding major features, migrating codebases, adding comprehensive test coverage, or any multi-step development task that can run autonomously. NOT for simple fixes, typos, or single-file changes.

when-using-advanced-swarm-use-swarm-advanced

25
from ComeOnOliver/skillshub

Advanced swarm patterns with dynamic topology switching and self-organizing behaviors for complex multi-agent coordination

when-orchestrating-swarm-use-swarm-orchestration

25
from ComeOnOliver/skillshub

Complex multi-agent swarm orchestration with task decomposition, distributed execution, and result synthesis

when-deploying-cloud-swarm-use-flow-nexus-swarm

25
from ComeOnOliver/skillshub

Deploy cloud-based AI agent swarms with event-driven workflow automation using Flow Nexus platform. Supports hierarchical, mesh, ring, and star topologies with E2B sandbox distribution.

swarm-orchestration

25
from ComeOnOliver/skillshub

Orchestrate multi-agent swarms with agentic-flow for parallel task execution, dynamic topology, and intelligent coordination. Use when scaling beyond single agents, implementing complex workflows, or building distributed AI systems.

swarm-advanced

25
from ComeOnOliver/skillshub

Advanced swarm orchestration patterns for research, development, testing, and complex distributed workflows

parallel-swarm-implementation

25
from ComeOnOliver/skillshub

Loop 2 of the Three-Loop Integrated Development System. META-SKILL that dynamically compiles Loop 1 plans into agent+skill execution graphs. Queen Coordinator selects optimal agents from 86-agent registry and assigns skills (when available) or custom instructions. 9-step swarm with theater detection and reality validation. Receives plans from research-driven-planning, feeds to cicd-intelligent-recovery. Use for adaptive, theater-free implementation.

flow-nexus-swarm

25
from ComeOnOliver/skillshub

Cloud-based AI swarm deployment and event-driven workflow automation with Flow Nexus platform

agent-swarm-workflow

25
from ComeOnOliver/skillshub

Jeffrey Emanuel's multi-agent implementation workflow using NTM, Agent Mail, Beads, and BV. The execution phase that follows planning and bead creation. Includes exact prompts used.

swarm-planner

25
from ComeOnOliver/skillshub

[EXPLICIT INVOCATION ONLY] Creates dependency-aware implementation plans optimized for parallel multi-agent execution.

super-swarm-spark

25
from ComeOnOliver/skillshub

Only to be triggered by explicit super-swarm-spark commands.