oss contributor swarm

AI Community v2.0.0

Skill notes

Prerequisites

GitHub CLI (gh) - authenticated Claude Code CLI (claude) jq and git

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

Fluxly profile Runtime and permissions are inferred by Fluxly static checks, not author declarations or runtime test results.
Domain
AI
Author-declared agents
No explicit declaration found; this is not inferred or tested compatibility
Static check
98 / 100 · heuristic scan, not runtime safety proof
Runtime evidence
Not run; no isolated runtime test evidence is currently recorded
Author / version / license
@happycapy-ai · v2.0.0 · MIT
Token usage
Lean
Setup complexity
Plug-and-play
External API key
Not required
Operating systems
Unspecified (assume cross-platform)
Runtime requirements
No explicit requirements detected
Detected file/system behavior
  • Read-only
  • Write / modify
Network behavior
Local-only
Install commands
None (reference only)

Heads up: Tool permissions are not declared; actual access depends on the runtime.

Author source file SKILL.md

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

Discussion

Powered by GitHub Discussions. Sign in with GitHub to comment, react, or subscribe.