Agent skill

Git Workflow

by ruvnet in ruvnet/ruflo

Advanced git workflows with branch management, conflict resolution, and PR lifecycle

MITAuto-check: notesDevelopment

Install Git Workflow

skills CLI
$ npx skills add ruvnet/ruflo --skill git-workflow -a claude-code

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

GitHub CLI
$ gh skill install ruvnet/ruflo git-workflow --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/plugins/ruflo-jujutsu/skills/git-workflow .claude/skills/git-workflow && 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
git-workflow
GitHub stars
74k
Token cost
~391 tokens
SKILL.md length
75 words
Files
1
Skills in repo
264
Repo updated
First seen
Licence
MIT

At a glance

Advanced git workflows with branch management, conflict resolution, and PR lifecycle

  • Works in 4 steps: Analyze repo — call… → Check diff risk — call… → Manage PRs — call… → …
  • Tasks that involve Git workflow
  • SKILL.md covers When to use, Steps, Common workflows and CLI alternative
  • Calls git and npx

What it does

Git Workflow is an agent skill from ruvnet/ruflo. Advanced git workflows with branch management, conflict resolution, and PR lifecycle

Its SKILL.md is about 390 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 Git workflow. It works with Model Context Protocol and GitHub. 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 Git workflow

Example prompts

  • “/git-workflow”

Requirements

  • Node.js
  • Pre-approved tools (allowed-tools): mcp__plugin_ruflo-core_ruflo__analyze_diff, mcp__plugin_ruflo-core_ruflo__analyze_diff-risk, mcp__plugin_ruflo-core_ruflo__analyze_diff-stats, mcp__plugin_ruflo-core_ruflo__github_pr_manage, mcp__plugin_ruflo-core_ruflo__github_repo_analyze, mcp__plugin_ruflo-core_ruflo__github_metrics, Bash

Workflow steps

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

  1. Analyze repo — call mcpplugin_ruflo-core_ruflogithub_repo_analyze for repository health metrics
  2. Check diff risk — call mcpplugin_ruflo-core_rufloanalyze_diff-risk before merging
  3. Manage PRs — call mcpplugin_ruflo-core_ruflogithub_pr_manage for PR lifecycle operations
  4. View metrics — call mcpplugin_ruflo-core_ruflogithub_metrics for merge frequency, review times, etc.

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 these tools, so the agent can use them without asking each time:

    • mcp__plugin_ruflo-core_ruflo__analyze_diff
    • mcp__plugin_ruflo-core_ruflo__analyze_diff-risk
    • mcp__plugin_ruflo-core_ruflo__analyze_diff-stats
    • mcp__plugin_ruflo-core_ruflo__github_pr_manage
    • mcp__plugin_ruflo-core_ruflo__github_repo_analyze
    • mcp__plugin_ruflo-core_ruflo__github_metrics
    • Bash

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • git
    • npx

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

  • Network

    No URLs in SKILL.md. Its commands use git and npx, which can reach the network depending on how they are called.

    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

Git Workflow loads about 391 tokens when it runs. Until then it costs about 24 tokens; SKILL.md has 75 words of instructions outside code blocks.

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

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: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

  • NotePre-approves every shell command (allowed-tools: Bash)SKILL.md
    allowed-tools: mcp__plugin_ruflo-core_ruflo__analyze_diff, mcp__plugin_ruflo-core_ruflo__analyze_diff-risk, mcp__pl

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). 75 words, ~391 tokens.

Download SKILL.mdSave it as .claude/skills/git-workflow/SKILL.md (or your agent's skills folder).
name
git-workflow
description
Advanced git workflows with branch management, conflict resolution, and PR lifecycle
allowed-tools
mcp__plugin_ruflo-core_ruflo__analyze_diff, mcp__plugin_ruflo-core_ruflo__analyze_diff-risk, mcp__plugin_ruflo-core_ruflo__analyze_diff-stats, mcp__plugin_ruflo-core_ruflo__github_pr_manage, mcp__plugin_ruflo-core_ruflo__github_repo_analyze, mcp__plugin_ruflo-core_ruflo__github_metrics, Bash
argument-hint
<branch|pr|merge|rebase> [options]

Git Workflow

Advanced git workflow automation for branch management and PR lifecycle.

When to use

When managing complex git operations — multi-branch workflows, release branching, conflict resolution, or PR coordination.

Steps

  1. Analyze repo — call mcp__plugin_ruflo-core_ruflo__github_repo_analyze for repository health metrics
  2. Check diff risk — call mcp__plugin_ruflo-core_ruflo__analyze_diff-risk before merging
  3. Manage PRs — call mcp__plugin_ruflo-core_ruflo__github_pr_manage for PR lifecycle operations
  4. View metrics — call mcp__plugin_ruflo-core_ruflo__github_metrics for merge frequency, review times, etc.

Common workflows

Feature branch
bash
git checkout -b feat/my-feature
# ... make changes ...
# analyze diff before PR
# create PR with risk assessment
Release branch
bash
git checkout -b release/v1.2.0
# cherry-pick fixes
# analyze all diffs for risk
# merge when risk score is acceptable

CLI alternative

bash
npx @claude-flow/cli@latest hooks pre-task --description "git workflow"

© 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 plugins/ruflo-jujutsu/skills/git-workflow of ruvnet/ruflo.

Open the folder on GitHubat commit de590e1

Compare with similar skills

Git Workflow 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.

Git Workflow compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Git Workflow this skillruvnet/ruflo74k—~391Automated safety check: NotesMIT
GitHubswarmclawai/swarmclaw687—~820Automated safety check: PassMIT
GitHubMassLab-SII/open-agent-skills133—~7.1kAutomated safety check: PassApache-2.0
Sidecarjoshukraine/dotfiles429—~926Automated safety check: PassMIT
Apex GitHub Operationsjonathan-vella/apex217—~1.5kAutomated safety check: PassMIT
Create Connectorharness/harness-skills115—~2kAutomated safety check: PassApache-2.0

Similar skills

  • GitHub

    swarmclawai/swarmclaw

    GitHub operations via gh CLI: issues, PRs, CI runs, code review, API queries.

    687 GitHub stars~820 tokensUpdated 3 mo ago
    DevelopmentAuto-check passed
  • GitHub

    MassLab-SII/open-agent-skills

    Comprehensive GitHub repository management toolkit. An agent skill from MassLab-SII/open-agent-skills.

    133 GitHub stars~7.1k tokensUpdated 9 mo ago
    DevelopmentAuto-check passed
  • Sidecar

    joshukraine/dotfiles

    Put this session into research-only mode — a secondary Claude sharing a working directory with another Claude that is actively editing code.

    429 GitHub stars~926 tokensUpdated yesterday
    DevelopmentAuto-check passed
  • Apex GitHub Operations

    jonathan-vella/apex

    WORKFLOW SKILL — Full GitHub contribution lifecycle: branches, conventional commits, issues, PRs, Actions, releases.

    217 GitHub stars~1.5k tokensUpdated today
    DevOps & CloudAuto-check passed
  • Create Connector

    harness/harness-skills

    Generate Harness Connector YAML for integrations and create/test via MCP.

    115 GitHub stars~2k tokensUpdated today
    DevOps & CloudAuto-check passed
  • Merges external GitHub pull requests while keeping the original author credited, and fixes conflicts after the merge instead of rewriting the contribution.

    16k GitHub starsUsed in 1 repo~847 tokens
    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 Git Workflow

What does Git Workflow do?

Advanced git workflows with branch management, conflict resolution, and PR lifecycle. Git Workflow is an agent skill from ruvnet/ruflo.

When should I use Git Workflow?

Git Workflow fits situations like: tasks that involve Git workflow.

How do I install Git Workflow in Claude Code?

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

How do I install Git Workflow in Codex?

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

Can I use Git Workflow 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 git-workflow -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/git-workflow, .gemini/skills/git-workflow, .github/skills/git-workflow and .opencode/skills/git-workflow in your project.

What does Git Workflow need to run?

Going by SKILL.md and its folder, Git Workflow needs the command-line tools its instructions call (git and npx). Our summary lists: Node.js. Its frontmatter pre-approves these tools: mcp__plugin_ruflo-core_ruflo__analyze_diff, mcp__plugin_ruflo-core_ruflo__analyze_diff-risk, mcp__plugin_ruflo-core_ruflo__analyze_diff-stats, mcp__plugin_ruflo-core_ruflo__github_pr_manage, mcp__plugin_ruflo-core_ruflo__github_repo_analyze, mcp__plugin_ruflo-core_ruflo__github_metrics, Bash.

Does Git Workflow access the network?

SKILL.md contains no URLs. Its commands use git and npx, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Git Workflow safe to install?

Our automated static check of SKILL.md found notes only (pre-approves every shell command (allowed-tools: bash)), nothing it rates as a warning. It is not a guarantee. Review the folder before installing.

What licence does Git Workflow use?

Git Workflow 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 Git Workflow use?

About 391 tokens (SKILL.md is roughly 1.6k 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 Git Workflow?

Skills that share tags, products or a category with Git Workflow: GitHub (swarmclawai/swarmclaw, 687 stars), GitHub (MassLab-SII/open-agent-skills, 133 stars), Sidecar (joshukraine/dotfiles, 429 stars) and Apex GitHub Operations (jonathan-vella/apex, 217 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Git Workflow?

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.