Agent skill

Agent GitHub Modes

by ruvnet in ruvnet/ruflo

Agent skill for github-modes - invoke with $agent-github-modes

MITAuto-check passedDevelopment

Install Agent GitHub Modes

skills CLI
$ npx skills add ruvnet/ruflo --skill agent-github-modes -a claude-code

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

GitHub CLI
$ gh skill install ruvnet/ruflo agent-github-modes --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/ruvnet/ruflo.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/agent-github-modes .claude/skills/agent-github-modes && 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
agent-github-modes
GitHub stars
74k
Used in
2 other repos
Token cost
~1.7k tokens
SKILL.md length
576 words
Files
1
Skills in repo
264
Repo updated
First seen
Licence
MIT

At a glance

Agent skill for github-modes - invoke with $agent-github-modes

  • Tasks that involve Pull requests
  • SKILL.md covers Overview, GitHub Workflow Modes, Repository Management Modes and Integration Commands, plus 3 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Agent GitHub Modes is an agent skill from ruvnet/ruflo. Agent skill for github-modes - invoke with $agent-github-modes

Its SKILL.md is about 1.7k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Development, covering Pull requests. It works with GitHub, GitHub Actions and Model Context Protocol. The repository describes itself as: 🌊 The original agent harness. Deploy intelligent multi-player swarms, coordinate autonomous workflows, and build conversational AI systems. Features adaptive memory…. The licence is MIT.

When your agent uses it

  • Tasks that involve Pull requests

Example prompts

  • “/agent-github-modes”

What it can do on your machine

Read from SKILL.md and the folder at commit de590e1. 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

    No scripts in the folder and no shell commands in SKILL.md (its code samples are bash and javascript).

    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

Agent GitHub Modes loads about 1.7k tokens when it runs. Until then it costs about 20 tokens; SKILL.md has 576 words of instructions outside code blocks.

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

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); files beside SKILL.md are not scanned.

SKILL.md

The full file from ruvnet/ruflo at commit de590e1, republished under its MIT licence (© ruvnet). 576 words, ~1,694 tokens.

Download SKILL.mdSave it as .claude/skills/agent-github-modes/SKILL.md (or your agent's skills folder).
name
agent-github-modes
description
Agent skill for github-modes - invoke with $agent-github-modes

name: github-modes description: Comprehensive GitHub integration modes for workflow orchestration, PR management, and repository coordination with batch optimization tools: mcp__claude-flow__swarm_init, mcp__claude-flow__agent_spawn, mcp__claude-flow__task_orchestrate, Bash, TodoWrite, Read, Write color: purple type: development capabilities:

  • GitHub workflow orchestration
  • Pull request management and review
  • Issue tracking and coordination
  • Release management and deployment
  • Repository architecture and organization
  • CI/CD pipeline coordination priority: medium hooks: pre: | echo "Starting github-modes..." echo "Initializing GitHub workflow coordination" gh auth status || (echo "GitHub CLI authentication required" && exit 1) git status > $dev$null || (echo "Not in a git repository" && exit 1) post: | echo "Completed github-modes" echo "GitHub operations synchronized" echo "Workflow coordination finalized"

GitHub Integration Modes

Overview

This document describes all GitHub integration modes available in Claude-Flow with ruv-swarm coordination. Each mode is optimized for specific GitHub workflows and includes batch tool integration for maximum efficiency.

GitHub Workflow Modes

gh-coordinator

GitHub workflow orchestration and coordination

  • Coordination Mode: Hierarchical
  • Max Parallel Operations: 10
  • Batch Optimized: Yes
  • Tools: gh CLI commands, TodoWrite, TodoRead, Task, Memory, Bash
  • Usage: $github gh-coordinator <GitHub workflow description>
  • Best For: Complex GitHub workflows, multi-repo coordination
pr-manager

Pull request management and review coordination

  • Review Mode: Automated
  • Multi-reviewer: Yes
  • Conflict Resolution: Intelligent
  • Tools: gh pr create, gh pr view, gh pr review, gh pr merge, TodoWrite, Task
  • Usage: $github pr-manager <PR management task>
  • Best For: PR reviews, merge coordination, conflict resolution
issue-tracker

Issue management and project coordination

  • Issue Workflow: Automated
  • Label Management: Smart
  • Progress Tracking: Real-time
  • Tools: gh issue create, gh issue edit, gh issue comment, gh issue list, TodoWrite
  • Usage: $github issue-tracker <issue management task>
  • Best For: Project management, issue coordination, progress tracking
release-manager

Release coordination and deployment

  • Release Pipeline: Automated
  • Versioning: Semantic
  • Deployment: Multi-stage
  • Tools: gh pr create, gh pr merge, gh release create, Bash, TodoWrite
  • Usage: $github release-manager <release task>
  • Best For: Release management, version coordination, deployment pipelines

Repository Management Modes

repo-architect

Repository structure and organization

  • Structure Optimization: Yes
  • Multi-repo: Support
  • Template Management: Advanced
  • Tools: gh repo create, gh repo clone, git commands, Write, Read, Bash
  • Usage: $github repo-architect <repository management task>
  • Best For: Repository setup, structure optimization, multi-repo management
Show full SKILL.md (237 more words)Show less
code-reviewer

Automated code review and quality assurance

  • Review Quality: Deep
  • Security Analysis: Yes
  • Performance Check: Automated
  • Tools: gh pr view --json files, gh pr review, gh pr comment, Read, Write
  • Usage: $github code-reviewer <review task>
  • Best For: Code quality, security reviews, performance analysis
branch-manager

Branch management and workflow coordination

  • Branch Strategy: GitFlow
  • Merge Strategy: Intelligent
  • Conflict Prevention: Proactive
  • Tools: gh api (for branch operations), git commands, Bash
  • Usage: $github branch-manager <branch management task>
  • Best For: Branch coordination, merge strategies, workflow management

Integration Commands

sync-coordinator

Multi-package synchronization

  • Package Sync: Intelligent
  • Version Alignment: Automatic
  • Dependency Resolution: Advanced
  • Tools: git commands, gh pr create, Read, Write, Bash
  • Usage: $github sync-coordinator <sync task>
  • Best For: Package synchronization, version management, dependency updates
ci-orchestrator

CI/CD pipeline coordination

  • Pipeline Management: Advanced
  • Test Coordination: Parallel
  • Deployment: Automated
  • Tools: gh pr checks, gh workflow list, gh run list, Bash, TodoWrite, Task
  • Usage: $github ci-orchestrator <CI/CD task>
  • Best For: CI/CD coordination, test management, deployment automation
security-guardian

Security and compliance management

  • Security Scan: Automated
  • Compliance Check: Continuous
  • Vulnerability Management: Proactive
  • Tools: gh search code, gh issue create, gh secret list, Read, Write
  • Usage: $github security-guardian <security task>
  • Best For: Security audits, compliance checks, vulnerability management

Usage Examples

Creating a coordinated pull request workflow:
bash
$github pr-manager "Review and merge feature$new-integration branch with automated testing and multi-reviewer coordination"
Managing repository synchronization:
bash
$github sync-coordinator "Synchronize claude-code-flow and ruv-swarm packages, align versions, and update cross-dependencies"
Setting up automated issue tracking:
bash
$github issue-tracker "Create and manage integration issues with automated progress tracking and swarm coordination"

Batch Operations

All GitHub modes support batch operations for maximum efficiency:

Parallel GitHub Operations Example:
javascript
[Single Message with BatchTool]:
  Bash("gh issue create --title 'Feature A' --body '...'")
  Bash("gh issue create --title 'Feature B' --body '...'")
  Bash("gh pr create --title 'PR 1' --head 'feature-a' --base 'main'")
  Bash("gh pr create --title 'PR 2' --head 'feature-b' --base 'main'")
  TodoWrite { todos: [todo1, todo2, todo3] }
  Bash("git checkout main && git pull")

Integration with ruv-swarm

All GitHub modes can be enhanced with ruv-swarm coordination:

javascript
// Initialize swarm for GitHub workflow
mcp__claude-flow__swarm_init { topology: "hierarchical", maxAgents: 5 }
mcp__claude-flow__agent_spawn { type: "coordinator", name: "GitHub Coordinator" }
mcp__claude-flow__agent_spawn { type: "reviewer", name: "Code Reviewer" }
mcp__claude-flow__agent_spawn { type: "tester", name: "QA Agent" }

// Execute GitHub workflow with coordination
mcp__claude-flow__task_orchestrate { task: "GitHub workflow", strategy: "parallel" }

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

Files

Just SKILL.md in .agents/skills/agent-github-modes of ruvnet/ruflo.

Open the folder on GitHubat commit de590e1

Used in 2 other repositories

We found 2 copies of this SKILL.md (exact, near-identical or edited) in other folders, from 2 other GitHub owners. This page covers the copy in ruvnet/ruflo, which our catalogue first saw on October 7, 2026.

Compare with similar skills

Agent GitHub Modes 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.

Agent GitHub Modes compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Agent GitHub Modes this skillruvnet/ruflo74k2 repos~1.7kAutomated safety check: PassMIT
Plane Release Notes Generatormakeplane/plane60k—~2.5kAutomated safety check: PassAGPL-3.0
ZCF Release AutomationUfoMiao/zcf6.1k—~3.4kAutomated safety check: PassMIT
Renovate Actions PR Reviewbacknotprop/plannotator9.2k—~640Automated safety check: PassApache-2.0
Mariadb Operator PR Reviewmariadb-operator/mariadb-operator1k—~3.3kAutomated safety check: PassApache-2.0
Link Ticket To SessionJayantDevkar/claude-code-karma329—~1.8kAutomated safety check: NotesApache-2.0

Similar skills

  • Builds categorized release notes for a Plane release pull request from its commits and writes them into the PR description, for both the plane-cloud and plane-ee repos.

    60k GitHub stars~2.5k tokensUpdated yesterday
    DevelopmentAuto-check passed
  • Automates a version release with changesets: analyzes code changes, writes a bilingual CHANGELOG, bumps the version and commits through a release branch and pull request.

    6.1k GitHub stars~3.4k tokensUpdated 1 mo ago
    DevelopmentAuto-check passed
  • Renovate Actions PR Review

    backnotprop/plannotator

    Reviews Renovate pull requests that bump GitHub Actions by checking pinned SHAs against upstream tags, scanning changelogs and confirming workflows stay compatible.

    9.2k GitHub stars~640 tokensUpdated today
    DevelopmentAuto-check passed
  • Mariadb Operator PR Review

    mariadb-operator/mariadb-operator

    Perform a structured maintainer-style PR review for the mariadb-operator repository.

    1k GitHub stars~3.3k tokensUpdated 2 days ago
    DevelopmentAuto-check passed
  • Link Ticket To Session

    JayantDevkar/claude-code-karma

    Link the current Claude Code session to a ticket (Linear, Jira, GitHub Issues, or GitHub Pull Requests) and cache its title/status in karma.

    329 GitHub stars~1.8k tokensUpdated 8 days ago
    DevelopmentAuto-check: notes
  • Code Review

    nteract/semiotic

    Review Semiotic pull requests for behavioral bugs, regressions, contract drift, and missing evidence.

    2.7k GitHub stars~1.5k tokensUpdated today
    DevelopmentAuto-check passed

More from ruvnet/ruflo

All 264 skills in this repo
  • Stores, searches, and retrieves successful patterns with HNSW-indexed semantic search so agents can reuse past solutions instead of relearning them.

    74k GitHub starsUsed in 2 repos~830 tokens
    Auto-check passed
  • Runs claude-flow CLI security scans for input validation, path traversal, SQL injection, XSS, hardcoded secrets and known CVEs, and writes an audit report.

    74k GitHub starsUsed in 2 repos~823 tokens
    Auto-check passed
  • Applies the SPARC method (specification, pseudocode, architecture, refinement, completion) with 17 specialized modes and multi-agent orchestration, from research to deployment.

    74k GitHub starsUsed in 2 repos~829 tokens
    Auto-check passed
  • Coordinates a hierarchical swarm of specialized agents through the claude-flow CLI for work that spans several files or modules at once.

    74k GitHub starsUsed in 2 repos~779 tokens
    Auto-check passed
  • Sets up and drives Ruflo, an npm-installed orchestration layer for multi-agent swarms, persistent memory, routing, hooks and its MCP tool catalog.

    74k GitHub starsUsed in 1 repo~975 tokens
    Auto-check passed
  • Agent Coordination

    ruvnet/ruflo

    Reference for spawning, listing, monitoring and stopping agents with claude-flow commands, with agent type families, routing codes and coordination tips.

    74k GitHub starsUsed in 2 repos~519 tokens
    Auto-check passed

Categories

Questions about Agent GitHub Modes

What does Agent GitHub Modes do?

Agent skill for github-modes - invoke with $agent-github-modes. Agent GitHub Modes is an agent skill from ruvnet/ruflo.

When should I use Agent GitHub Modes?

Agent GitHub Modes fits situations like: tasks that involve Pull requests.

How do I install Agent GitHub Modes in Claude Code?

Run `npx skills add ruvnet/ruflo --skill agent-github-modes -a claude-code`. Or copy the skill folder (.agents/skills/agent-github-modes in ruvnet/ruflo) into .claude/skills/agent-github-modes in your project. Claude Code loads it when a task matches its description.

How do I install Agent GitHub Modes in Codex?

Run `npx skills add ruvnet/ruflo --skill agent-github-modes -a codex`. Or copy the skill folder (.agents/skills/agent-github-modes in ruvnet/ruflo) into .agents/skills/agent-github-modes in your project. Codex loads it when a task matches its description.

Can I use Agent GitHub Modes 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 ruvnet/ruflo --skill agent-github-modes -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/agent-github-modes, .gemini/skills/agent-github-modes, .github/skills/agent-github-modes and .opencode/skills/agent-github-modes in your project.

What does Agent GitHub Modes need to run?

SKILL.md names no scripts, command-line tools or credentials: Agent GitHub Modes is instructions for the agent only.

Does Agent GitHub Modes 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 Agent GitHub Modes 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. Review the folder before installing.

What licence does Agent GitHub Modes use?

Agent GitHub Modes is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Agent GitHub Modes use?

About 1.7k tokens (SKILL.md is roughly 6.8k 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 Agent GitHub Modes?

Skills that share tags, products or a category with Agent GitHub Modes: Plane Release Notes Generator (makeplane/plane, 60k stars), ZCF Release Automation (UfoMiao/zcf, 6.1k stars), Renovate Actions PR Review (backnotprop/plannotator, 9.2k stars) and Mariadb Operator PR Review (mariadb-operator/mariadb-operator, 1k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Agent GitHub Modes?

ruvnet (a GitHub user) maintains it in ruvnet/ruflo, which has 74,012 GitHub stars. The repository holds 264 skills in this directory. The repository was last updated on October 7, 2026.

Source: ruvnet/ruflo on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.