Agent skill

YugabyteDB Phorge Diff Creator

by yugabyte in yugabyte/yugabyte-db

Creates a Phorge code review diff for the current branch with arc diff, while applying public-repo confidentiality rules since Phorge content later lands verbatim on the public GitHub repo.

Custom licenceAuto-check passedDevelopment

Install YugabyteDB Phorge Diff Creator

skills CLI
$ npx skills add yugabyte/yugabyte-db --skill create-diff -a claude-code

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

GitHub CLI
$ gh skill install yugabyte/yugabyte-db create-diff --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/yugabyte/yugabyte-db.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/create-diff .claude/skills/create-diff && 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
create-diff
GitHub stars
11k
Token cost
~3.1k tokens
SKILL.md length
1,714 words
Files
1
Skills in repo
7
Repo updated
First seen
Licence
Custom licence

At a glance

Creates a Phorge code review diff for the current branch with arc diff, while applying public-repo confidentiality rules since Phorge content later lands verbatim on the public GitHub repo.

  • Works in 11 steps: Commit pending changes → Run linter and confirm no lint errors → 5: PG code style pass (only when… → …
  • Publishing the current branch's changes as a Phorge diff for review
  • SKILL.md covers Confidentiality -- read before…, Prerequisites, Workflow and Notes
  • Calls git; reaches phorge.dev.yugabyte.com

What it does

Because Phorge revisions and their triggered Jenkins logs are visible to anyone with company access, and anything in the diff's code, tests, fixtures or comments is upstreamed to the public GitHub repo without a separate scrubbing pass, the skill applies public-repo rules to everything in the diff before creating it with arc diff --create: the title, summary, test plan, inline comments, commit messages, code, tests, fixtures, golden output and filenames.

It lists what must never appear: customer-identifying data such as company names or cluster UUIDs, substituted with a generic name like acme-corp; PII such as real names, emails or IP addresses, replaced with documentation-range placeholders such as the RFC 5737 IPv4 ranges or names like Alice and Bob; unanonymized customer schema or queries, rebuilt as a synthetic minimal reproducer with generic identifiers; secrets and credentials, replaced with placeholders such as an example AWS key; and unreleased YugabyteDB-internal information such as roadmap details or embargoed security findings.

When your agent uses it

  • Publishing the current branch's changes as a Phorge diff for review
  • Checking a diff for customer data or secrets before it goes out for review
  • Writing a test reproducer from a customer report without leaking real data

Example prompts

  • “Create a Phorge diff for my current branch's changes.”
  • “Check this diff for any customer-identifying data before I publish it.”
  • “Rewrite this test case using placeholder IPs and generic table names.”

Requirements

  • The arc CLI configured for this repository's Phorge instance

Workflow steps

11 steps, taken from the step headings in SKILL.md.

  1. Commit pending changes
  2. Run linter and confirm no lint errors
  3. 5: PG code style pass (only when src/postgres files changed)
  4. Determine tracker reference
  5. 5: Gather remaining title metadata
  6. Build the title
  7. Determine subscribers
  8. 5: Cut the prose the branch added
  9. Create the diff with arc diff --create
  10. Post a "trigger jenkins" comment
  11. Report back to the user

What it can do on your machine

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

    Shell commands in SKILL.md call:

    • git

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

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • phorge.dev.yugabyte.com

    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

YugabyteDB Phorge Diff Creator loads about 3.1k tokens when it runs. Until then it costs about 35 tokens; SKILL.md has 1,714 words of instructions outside code blocks.

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

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

Its licence (Custom licence) doesn't allow us to republish the file, so here is its outline and opening line. It has 1,714 words (~3,077 tokens).

“Create a Phorge diff for the current branch using arc diff --create.”

— opening of SKILL.md by yugabyte, Custom licence
name
create-diff

Read the full SKILL.md on GitHub

Files

Just SKILL.md in .claude/skills/create-diff of yugabyte/yugabyte-db.

Open the folder on GitHubat commit 9d312a8

Compare with similar skills

YugabyteDB Phorge Diff Creator 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.

YugabyteDB Phorge Diff Creator compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
YugabyteDB Phorge Diff Creator this skillyugabyte/yugabyte-db11k—~3.1kAutomated safety check: PassCustom licence
Verdaccio Code Reviewverdaccio/verdaccio18k—~853Automated safety check: PassMIT
Bug Huntercodexstar69/bug-hunter519—~5kAutomated safety check: PassMIT
Code Review with Beads Tasksmaslennikov-ig/claude-code-orchestrator-kit260—~2kAutomated safety check: PassCustom licence
Code Review Specialist (Ukrainian)luongnv89/claude-howto42k—~484Automated safety check: PassMIT
Code Review SecurityOWASP/secure-agent-playbook187—~549Automated safety check: PassCC-BY-4.0

Similar skills

  • Verdaccio Code Review

    verdaccio/verdaccio

    Reviews a verdaccio diff, branch or PR against the repository's review guide, verifies each finding in the code and reports only actionable issues.

    18k GitHub stars~853 tokensUpdated yesterday
    DevelopmentAuto-check passed
  • Bug Hunter

    codexstar69/bug-hunter

    Precision-first adversarial bug hunting for runtime, logic, data, concurrency, and security defects.

    519 GitHub stars~5k tokensUpdated 1 mo ago
    DevelopmentAuto-check passed
  • Code Review with Beads Tasks

    maslennikov-ig/claude-code-orchestrator-kit

    Reviews staged changes, a branch, a PR or a path for bugs, security gaps and performance issues, then writes an evidence-based report and creates Beads tasks.

    260 GitHub stars~2k tokensUpdated 7 mo ago
    DevelopmentAuto-check passed
  • Code review covering security, performance, quality and maintainability, with a fixed report layout and two analysis scripts; the SKILL.md itself is in Ukrainian.

    42k GitHub stars~484 tokensUpdated 7 days ago
    DevelopmentAuto-check passed
  • Code Review Security

    OWASP/secure-agent-playbook

    Security-focused code review mapped to OWASP Top 10 and ASVS.

    187 GitHub stars~549 tokensUpdated 12 days ago
    DevelopmentAuto-check passed
  • Reviewdog

    AgentSecOps/SecOpsAgentKit

    Automated code review and security linting integration for CI/CD pipelines using reviewdog.

    220 GitHub starsUsed in 1 repo~3k tokens
    DevelopmentAuto-check passed

More from yugabyte/yugabyte-db

  • YugabyteDB ASH Instrumentation

    yugabyte/yugabyte-db

    Procedure for adding or changing YugabyteDB Active Session History wait states in TServer and DocDB C++ code, including the macro to use for sync and async paths.

    11k GitHub stars~4.5k tokensUpdated today
    Auto-check passed
  • YugabyteDB Issue Creator

    yugabyte/yugabyte-db

    Creates a GitHub issue or JIRA ticket for a YugabyteDB change or bug, after scrubbing customer data, secrets and unreleased details from anything public.

    11k GitHub stars~2k tokensUpdated today
    Auto-check passed
  • YugabyteDB Backport Review

    yugabyte/yugabyte-db

    Checks a YugabyteDB backport revision on Phorge against the original diff it was ported from and flags differences, tracing unexplained code back to master.

    11k GitHub stars~2.5k tokensUpdated today
    Auto-check passed
  • YBA Read-Only Query CLI

    yugabyte/yugabyte-db

    Runs read-only lookups - list, describe, get - against a live YugabyteDB Anywhere control plane using the yba CLI, with mutating commands explicitly off-limits.

    11k GitHub stars~1.1k tokensUpdated today
    Auto-check passed
  • Create Fork Pull Request

    yugabyte/yugabyte-db

    Pushes the current branch to your fork and opens a cross-repository GitHub pull request, with a strict check against leaking customer data into public text.

    11k GitHub stars~5.7k tokensUpdated today
    Auto-check passed
  • cargo-pgrx Commands and Tests

    yugabyte/yugabyte-db

    Helps choose and run cargo-pgrx commands and decide whether a Rust test is a plain test or a pg_test, so code never crosses the Postgres boundary the wrong way.

    11k GitHub stars~1.9k tokensUpdated today
    Auto-check passed

Questions about YugabyteDB Phorge Diff Creator

What does YugabyteDB Phorge Diff Creator do?

Creates a Phorge code review diff for the current branch with arc diff, while applying public-repo confidentiality rules since Phorge content later lands verbatim on the public GitHub repo. Because Phorge revisions and their triggered Jenkins logs are visible to anyone with company access, and anything in the diff's code, tests, fixtures or comments is upstreamed to the public GitHub repo without a separate scrubbing pass, the skill applies public-repo rules to everything in the diff before creating it with arc diff --create: the title, summary, test plan, inline comments, commit messages, code, tests, fixtures, golden output and filenames.

When should I use YugabyteDB Phorge Diff Creator?

YugabyteDB Phorge Diff Creator fits situations like: publishing the current branch's changes as a Phorge diff for review; checking a diff for customer data or secrets before it goes out for review; writing a test reproducer from a customer report without leaking real data.

How do I install YugabyteDB Phorge Diff Creator in Claude Code?

Run `npx skills add yugabyte/yugabyte-db --skill create-diff -a claude-code`. Or copy the skill folder (.claude/skills/create-diff in yugabyte/yugabyte-db) into .claude/skills/create-diff in your project. Claude Code loads it when a task matches its description.

How do I install YugabyteDB Phorge Diff Creator in Codex?

Run `npx skills add yugabyte/yugabyte-db --skill create-diff -a codex`. Or copy the skill folder (.claude/skills/create-diff in yugabyte/yugabyte-db) into .agents/skills/create-diff in your project. Codex loads it when a task matches its description.

Can I use YugabyteDB Phorge Diff Creator 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 yugabyte/yugabyte-db --skill create-diff -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/create-diff, .gemini/skills/create-diff, .github/skills/create-diff and .opencode/skills/create-diff in your project.

What does YugabyteDB Phorge Diff Creator need to run?

Going by SKILL.md and its folder, YugabyteDB Phorge Diff Creator needs the command-line tools its instructions call (git). Our summary lists: The arc CLI configured for this repository's Phorge instance.

Does YugabyteDB Phorge Diff Creator access the network?

SKILL.md names 1 domain. In commands or code: phorge.dev.yugabyte.com; the agent is likely to contact it when it follows the instructions. This is read from the text; nothing was executed.

Is YugabyteDB Phorge Diff Creator 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 YugabyteDB Phorge Diff Creator use?

YugabyteDB Phorge Diff Creator has a licence file (the repository's licence) that doesn't match a standard licence. Read it on GitHub before reusing the skill.

How many tokens does YugabyteDB Phorge Diff Creator use?

About 3.1k tokens (SKILL.md is roughly 12k 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 YugabyteDB Phorge Diff Creator?

Skills that share tags, products or a category with YugabyteDB Phorge Diff Creator: Verdaccio Code Review (verdaccio/verdaccio, 18k stars), Bug Hunter (codexstar69/bug-hunter, 519 stars), Code Review with Beads Tasks (maslennikov-ig/claude-code-orchestrator-kit, 260 stars) and Code Review Specialist (Ukrainian) (luongnv89/claude-howto, 42k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains YugabyteDB Phorge Diff Creator?

yugabyte (a GitHub organization) maintains it in yugabyte/yugabyte-db, which has 10,583 GitHub stars. The repository holds 7 skills in this directory. The repository was last updated on October 8, 2026.

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