Agent skill

Oss Contributor Swarm

by happycapy-ai in happycapy-ai/Happycapy-skills

Autonomous 9-agent swarm that continuously contributes to open source projects on GitHub.

MITAuto-check passedAgent Workflows

Install Oss Contributor Swarm

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

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install happycapy-ai/Happycapy-skills oss-contributor-swarm --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/happycapy-ai/Happycapy-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/oss-contributor-swarm .claude/skills/oss-contributor-swarm && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
oss-contributor-swarm
GitHub stars
137
Token cost
~542 tokens
SKILL.md length
186 words
Files
36 (incl. scripts)
Skills in repo
28
Repo updated
First seen
Licence
MIT

At a glance

Autonomous 9-agent swarm that continuously contributes to open source projects on GitHub.

  • Works in 9 steps: Qualifies repositories for… → Finds suitable "good first issues" → Analyzes requirements → …
  • Tasks that involve Multi-agent orchestration
  • SKILL.md covers Quick Start, Prerequisites, Key Features and Configuration, plus 1 more section
  • Runs Python scripts from its folder

What it does

Oss Contributor Swarm is an agent skill from happycapy-ai/Happycapy-skills. 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.

Its SKILL.md is about 540 tokens, which your agent loads only when the skill is triggered. The skill folder holds 38 other files, including scripts (for example `README.md`, `agents/agent-0-repo-qualifier.md` and `agents/agent-0-strategic-planner.md`).

It sits in Agent Workflows, covering Multi-agent orchestration. It works with GitHub. The repository describes itself as: A curated collection of high-quality Claude Code skills to enhance your development workflow. The licence is MIT.

When your agent uses it

  • Tasks that involve Multi-agent orchestration

Example prompts

  • “/oss-contributor-swarm”

Requirements

  • Python 3

Workflow steps

9 steps, taken from the first numbered list in SKILL.md.

  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

What it can do on your machine

Read from SKILL.md and the folder at commit 9ff72fe. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 1 file in scripts/ (Python, from the files we listed), which the agent can run.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Oss Contributor Swarm loads about 542 tokens when it runs. Until then it costs about 64 tokens; SKILL.md has 186 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~64
When it runs · the whole SKILL.md, loaded when a task matches
~542

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from happycapy-ai/Happycapy-skills at commit 9ff72fe, republished under its MIT licence (© happycapy-ai). 186 words, ~542 tokens.

Download SKILL.mdSave it as .claude/skills/oss-contributor-swarm/SKILL.md (or your agent's skills folder). This skill also uses 35 other files; get the full folder from GitHub.
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.

© happycapy-ai, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 35 other files (scripts) in skills/oss-contributor-swarm of happycapy-ai/Happycapy-skills.

  • SKILL.md
  • .gitignore
  • LICENSE
  • README.md
  • agents/agent-0-repo-qualifier.md
  • agents/agent-0-strategic-planner.md
  • agents/agent-1-issue-scout.md
  • agents/agent-2-issue-analyst.md
  • agents/agent-3-codebase-explorer.md
  • agents/agent-4-code-writer.md
  • agents/agent-5-test-writer.md
  • agents/agent-6-docs-writer.md
  • agents/agent-7-pr-creator.md
  • agents/agent-8-review-responder.md
  • agents/agent-9-status-monitor.md
  • config/swarm-config.json
  • dashboard/dashboard-server.py
  • dashboard/pr-dashboard.html
  • … and 18 more

Open the folder on GitHubat commit 9ff72fe

Compare with similar skills

Oss Contributor Swarm next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Oss Contributor Swarm compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Oss Contributor Swarm this skillhappycapy-ai/Happycapy-skills137—~542Automated safety check: PassMIT
Context Mode Opsmksglu/context-mode26k—~6kAutomated safety check: PassCustom licence
PRP Workstream OrchestratorWirasm/prp2.3k—~3.5kAutomated safety check: PassMIT
Codex Issue Coordinatorowainlewis/blueprint412—~2.6kAutomated safety check: PassMIT
agystack Runtime Setupjtaroreh/agystack112—~1.7kAutomated safety check: PassMIT
Swarm Coordinationdralgorhythm/claude-agentic-framework125—~1.6kAutomated safety check: PassNone

Similar skills

  • Context Mode Ops

    mksglu/context-mode

    Runs maintenance for the context-mode project with parallel subagents: issue triage, PR review, releases, bug fixes, announcements and branch syncing.

    26k GitHub stars~6k tokensUpdated today
    Agent WorkflowsAuto-check passed
  • Coordinates several PRP workstreams in isolated Git worktrees from one session, verifying proof, holding merge gates and sequencing the merges.

    2.3k GitHub stars~3.5k tokensUpdated 9 days ago
    Agent WorkflowsAuto-check passed
  • Codex Issue Coordinator

    owainlewis/blueprint

    Lets one Codex thread run a batch of GitHub issues through separate worker threads, each with its own worktree, branch, tested pull request and gated merge.

    412 GitHub stars~2.6k tokensUpdated yesterday
    Agent WorkflowsAuto-check passed
  • agystack Runtime Setup

    jtaroreh/agystack

    Configures agystack's model tiers per role and its execution runtime, choosing between local subagents and Cloud Run jobs for large parallel swarms.

    112 GitHub stars~1.7k tokensUpdated 9 days ago
    Agent WorkflowsAuto-check passed
  • Swarm Coordination

    dralgorhythm/claude-agentic-framework

    Rules for several agents sharing one repository: an orchestrator tracks work in two tiers, workers write to scratch files, and every handoff leaves a pointer to an artifact.

    125 GitHub stars~1.6k tokensUpdated 2 mo ago
    Agent WorkflowsAuto-check passed
  • Turns a one-line objective into a multi-step plan file with PR-sized steps, context briefs, a dependency graph, parallel-step detection and an adversarial review.

    277k GitHub starsUsed in 5 repos~1.3k tokens
    Agent WorkflowsAuto-check passed

More from happycapy-ai/Happycapy-skills

All 28 skills in this repo
  • Happycapy Skill Creator

    happycapy-ai/Happycapy-skills

    Automate HappyCapy skill creation by finding and adapting existing skills from anthropics/skills repository.

    137 GitHub stars~627 tokensUpdated 1 mo ago
    Auto-check passed
  • 360 Panorama Viewer

    happycapy-ai/Happycapy-skills

    Build a fully self-contained 360° equirectangular panorama viewer as a single HTML file.

    137 GitHub stars~2.1k tokensUpdated 1 mo ago
    Auto-check passed
  • Generate Image

    happycapy-ai/Happycapy-skills

    Generate and transform images using AI Gateway API. An agent skill from happycapy-ai/Happycapy-skills.

    137 GitHub stars~2k tokensUpdated 1 mo ago
    Auto-check: notes
  • LLM Council

    happycapy-ai/Happycapy-skills

    Multi-model LLM Council with live dashboard. An agent skill from happycapy-ai/Happycapy-skills.

    137 GitHub stars~581 tokensUpdated 1 mo ago
    Auto-check passed
  • PPTX

    happycapy-ai/Happycapy-skills

    Create polished PowerPoint (.pptx) presentations directly from a topic or content description.

    137 GitHub stars~1.5k tokensUpdated 1 mo ago
    Auto-check passed
  • World Class Carousel

    happycapy-ai/Happycapy-skills

    Generate world-class Instagram carousel content on any topic.

    137 GitHub stars~16k tokensUpdated 1 mo ago
    Auto-check: notes

Works with

Categories

Questions about Oss Contributor Swarm

What does Oss Contributor Swarm do?

Autonomous 9-agent swarm that continuously contributes to open source projects on GitHub. Oss Contributor Swarm is an agent skill from happycapy-ai/Happycapy-skills. Autonomous 9-agent swarm that continuously contributes to open source projects on GitHub.

When should I use Oss Contributor Swarm?

Oss Contributor Swarm fits situations like: tasks that involve Multi-agent orchestration.

How do I install Oss Contributor Swarm in Claude Code?

Run `npx skills add happycapy-ai/Happycapy-skills --skill oss-contributor-swarm -a claude-code`. Or copy the skill folder (skills/oss-contributor-swarm in happycapy-ai/Happycapy-skills) into .claude/skills/oss-contributor-swarm in your project. Claude Code loads it when a task matches its description.

How do I install Oss Contributor Swarm in Codex?

Run `npx skills add happycapy-ai/Happycapy-skills --skill oss-contributor-swarm -a codex`. Or copy the skill folder (skills/oss-contributor-swarm in happycapy-ai/Happycapy-skills) into .agents/skills/oss-contributor-swarm in your project. Codex loads it when a task matches its description.

Can I use Oss Contributor Swarm in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add happycapy-ai/Happycapy-skills --skill oss-contributor-swarm -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/oss-contributor-swarm, .gemini/skills/oss-contributor-swarm, .github/skills/oss-contributor-swarm and .opencode/skills/oss-contributor-swarm in your project.

What does Oss Contributor Swarm need to run?

Going by SKILL.md and its folder, Oss Contributor Swarm needs Python for the scripts in its folder. Our summary lists: Python 3.

Does Oss Contributor Swarm access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Oss Contributor Swarm safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Oss Contributor Swarm use?

Oss Contributor Swarm is published under the MIT licence (from the LICENSE file in the skill folder). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Oss Contributor Swarm use?

About 542 tokens (SKILL.md is roughly 2.2k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Oss Contributor Swarm?

Skills that share tags, products or a category with Oss Contributor Swarm: Context Mode Ops (mksglu/context-mode, 26k stars), PRP Workstream Orchestrator (Wirasm/prp, 2.3k stars), Codex Issue Coordinator (owainlewis/blueprint, 412 stars) and agystack Runtime Setup (jtaroreh/agystack, 112 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Oss Contributor Swarm?

happycapy-ai (a GitHub user) maintains it in happycapy-ai/Happycapy-skills, which has 137 GitHub stars. The repository holds 28 skills in this directory. The repository was last updated on September 3, 2026.

Source: happycapy-ai/Happycapy-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.