Agent skill

Stage Resolve

by ReviewStage in ReviewStage/stage-cli

Pick up the review comments the user left in the Stage UI for the current diff, make the requested changes, and resolve each thread.

MITAuto-check passedDevelopment

Install Stage Resolve

skills CLI
$ npx skills add ReviewStage/stage-cli --skill stage-resolve -a claude-code

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

GitHub CLI
$ gh skill install ReviewStage/stage-cli stage-resolve --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/ReviewStage/stage-cli.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/stage-resolve .claude/skills/stage-resolve && 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
stage-resolve
GitHub stars
274
Token cost
~1.3k tokens
SKILL.md length
711 words
Files
1
Skills in repo
10
Repo updated
First seen
Licence
MIT

At a glance

Pick up the review comments the user left in the Stage UI for the current diff, make the requested changes, and resolve each thread.

  • Works in 3 steps: List open threads → Handle each thread → Report back
  • Development work in your project
  • SKILL.md covers Prerequisites, Arguments, Step 1 — List open threads and Step 2 — Handle each thread, plus 2 more sections
  • Calls npm

What it does

Stage Resolve is an agent skill from ReviewStage/stage-cli. Pick up the review comments the user left in the Stage UI for the current diff, make the requested changes, and resolve each thread.

Its SKILL.md is about 1.3k 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. The repository describes itself as: A viewer for reviewing local code changes in small individual chapters. Works with any AI agent. The licence is MIT.

When your agent uses it

  • Development work in your project

Example prompts

  • “/stage-resolve”

Requirements

  • Node.js

Workflow steps

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

  1. List open threads
  2. Handle each thread
  3. Report back

What it can do on your machine

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

    • npm

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

  • Network

    No URLs in SKILL.md. Its commands use npm, 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

Stage Resolve loads about 1.3k tokens when it runs. Until then it costs about 37 tokens; SKILL.md has 711 words of instructions outside code blocks.

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

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 ReviewStage/stage-cli at commit 59b977b, republished under its MIT licence (© ReviewStage). 711 words, ~1,302 tokens.

Download SKILL.mdSave it as .claude/skills/stage-resolve/SKILL.md (or your agent's skills folder).
name
stage-resolve
description
Pick up the review comments the user left in the Stage UI for the current diff, make the requested changes, and resolve each thread.
user-invocable
true

stage-resolve

Reads the local review comments the user left in the Stage browser UI (created by /stage-chapters), acts on each open thread, and resolves it. Uses stagereview comments, which reads and writes the same local database the UI uses — the stagereview show server does not need to be running, and the UI picks up your replies and resolutions automatically.

Every comment you write through the CLI is attributed to the agent and shows an "Agent" badge in the UI, so the user can tell your replies from their own notes.

Prerequisites

Run this check before any other work. If it fails, stop with the error message — do not continue.

  1. stagereview is installed. Run which stagereview. If it exits non-zero, instruct the user:

    stagereview is not installed. Run:
    
        npm install -g stagereview

Arguments

  • Diff selectors. Pass through any git refs or flags the user gave (--pr 123, --base main, --ref staged, main..feature, …) to every list and create call exactly as given. They select the same diff scope /stage-chapters used, so you see the threads the UI shows. With no arguments the CLI uses the same default scope stagereview show uses for the working tree.
  • A single thread ID (full UUID or a prefix of at least 6 characters). When given, handle only that thread and skip the listing step.

Step 1 — List open threads

Run this before editing any files, and keep the output — you will address threads by the IDs it returns:

bash
stagereview comments list --status open --json [refs...] [--pr <ref>] [--base <ref>] [--compare <ref>] [--ref <mode>]

Each thread has id, filePath, side (additions = new file lines, deletions = old file lines), startLine, endLine, status, and comments ordered oldest first. Each comment carries body, authorType (user or agent), and timestamps.

If the list is empty, tell the user there are no open comment threads for this diff and stop.

The diff scope is keyed on git state. If the working tree was clean when the review was opened and you then edit files, a later list with no arguments resolves to a different (working-tree) scope. Address threads by ID (show, reply, resolve, reopen are not scoped), and do not commit while working through threads unless the user asks.

Show full SKILL.md (378 more words)Show less

Step 2 — Handle each thread

For each open thread, in order:

  1. Read the whole conversation. The first comment is the request; later comments may refine it or answer earlier questions.
  2. Skip threads waiting on the user. If the last comment has authorType: "agent" and asks the user a question they have not answered, leave the thread alone and mention it in your summary.
  3. Decide what the comment asks for.
    • A request or instruction ("rename this", "add a null check", "extract a helper") → make the change.
    • A question that implies an action ("should we add a test for this?", "could this be a constant?") → treat it as a request and make the change.
    • A pure question ("why does this fall back to the primary org?") → answer it and resolve the thread:
      bash
      stagereview comments resolve <threadId> --body "<answer>"
    • Genuinely unclear → do not guess and do not silently skip. Ask for clarification and leave the thread open:
      bash
      stagereview comments reply <threadId> --body "<specific question>"
  4. Before editing, read the surrounding source, not just the anchored lines — the comment is anchored to a diff line range, but the right fix may live nearby. Follow the repository's coding guidelines (for example AGENTS.md or CLAUDE.md) and existing conventions.
  5. Make the change, then run the project's relevant checks (typecheck, lint, tests) for the files you touched.
  6. Resolve with a short summary of what changed:
    bash
    stagereview comments resolve <threadId> --body "Fixed: <what changed and where>"
    Keep the body to one or two sentences. Do not paste file contents.

To inspect a single thread in full at any point:

bash
stagereview comments show <threadId>

Step 3 — Report back

Run the listing again with the same selectors you used in Step 1:

bash
stagereview comments list --status open [same selectors as Step 1]

Then tell the user:

  • which threads you resolved and, in a line each, what you changed;
  • which threads you replied to with a question and are waiting on them;
  • that the Stage UI in their browser has already picked up your replies and resolutions.

Leaving your own comments

If you notice something worth flagging while working — a risk, a follow-up, a question about intent — leave a comment on the diff rather than burying it in chat:

bash
stagereview comments create --file <path> --line <n> [--end-line <n>] [--side additions|deletions] --body "<text>" [same selectors as Step 1]

Line numbers refer to the new file for additions (the default) and the old file for deletions.

© ReviewStage, 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 skills/stage-resolve of ReviewStage/stage-cli.

Open the folder on GitHubat commit 59b977b

Compare with similar skills

Stage Resolve 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.

Stage Resolve compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Stage Resolve this skillReviewStage/stage-cli274—~1.3kAutomated safety check: PassMIT
Vercel Composition Patternssupabase/supabase111k58 repos~726Automated safety check: PassMIT
Finishing a Development Branchobra/superpowers297k5 repos~1.9kAutomated safety check: PassMIT
Typescript Advanced Typesrolling-scopes/rsschool-app10k25 repos~4.2kAutomated safety check: PassMPL-2.0
PR Babysitteropeninterpreter/openinterpreter69k3 repos~4.2kAutomated safety check: PassApache-2.0
Code Review ChecklistshareAI-lab/learn-claude-code78k4 repos~1.1kAutomated safety check: PassMIT

Similar skills

  • Official

    React composition patterns that scale. An agent skill from supabase/supabase.

    111k GitHub starsUsed in 58 repos~726 tokens
    DevelopmentAuto-check passed
  • Walks the last step of a branch: confirm tests pass, detect the git environment, ask how to integrate, carry out your choice and clean up the worktree.

    297k GitHub starsUsed in 5 repos~1.9k tokens
    DevelopmentAuto-check passed
  • Typescript Advanced Types

    rolling-scopes/rsschool-app

    Master TypeScript's advanced type system including generics, conditional types, mapped types, template literals, and utility types for building type-safe applications.

    10k GitHub starsUsed in 25 repos~4.2k tokens
    DevelopmentAuto-check passed
  • PR Babysitter

    openinterpreter/openinterpreter

    Watches an open GitHub pull request until it merges, handling review comments, diagnosing CI failures and retrying flaky checks along the way.

    69k GitHub starsUsed in 3 repos~4.2k tokens
    DevelopmentAuto-check passed
  • Code Review Checklist

    shareAI-lab/learn-claude-code

    Reviews code against a five-part checklist covering security, correctness, performance, maintainability and testing, and reports findings in a fixed format.

    78k GitHub starsUsed in 4 repos~1.1k tokens
    DevelopmentAuto-check passed
  • Greploop

    onyx-dot-app/onyx

    Iteratively improves a PR (GitHub), MR (GitLab), or shelved changelist (Perforce) until Greptile gives it a 5/5 confidence score with zero unresolved comments.

    32k GitHub starsUsed in 4 repos~3.3k tokens
    DevelopmentAuto-check passed

More from ReviewStage/stage-cli

All 10 skills in this repo
  • Fixing CI

    ReviewStage/stage-cli

    A skill your agent uses when CI is failing on a branch and you need to diagnose failures from GitHub, fix them locally with iterative verification, and re-push clean commits.

    274 GitHub stars~977 tokensUpdated 1 mo ago
    Auto-check passed
  • Fixing PR Comments

    ReviewStage/stage-cli

    A skill your agent uses when a pull request has unresolved review comments that need to be addressed, or when asked to fix PR feedback

    274 GitHub stars~953 tokensUpdated 1 mo ago
    Auto-check passed
  • Iterate PR

    ReviewStage/stage-cli

    A skill your agent uses when a PR is open and the user wants to autonomously monitor and fix PR review comments, CI failures, and rebase conflicts on a recurring loop, or when asked to…

    274 GitHub stars~1.1k tokensUpdated 1 mo ago
    Auto-check passed
  • Linear Issue

    ReviewStage/stage-cli

    A skill your agent uses when creating a Linear issue from the current coding context, or when the user invokes /linear-issue.

    274 GitHub stars~2k tokensUpdated 1 mo ago
    Auto-check passed
  • Quality Review

    ReviewStage/stage-cli

    A skill your agent uses when reviewing code changes against AGENTS.md implementation quality standards, or when asked to do an implementation quality review

    274 GitHub stars~1.3k tokensUpdated 1 mo ago
    Auto-check passed
  • Rebase Origin Main

    ReviewStage/stage-cli

    A skill your agent uses when rebasing the current branch onto origin/main, including resolving merge conflicts along the way

    274 GitHub stars~927 tokensUpdated 1 mo ago
    Auto-check passed

Categories

Questions about Stage Resolve

What does Stage Resolve do?

Pick up the review comments the user left in the Stage UI for the current diff, make the requested changes, and resolve each thread. Stage Resolve is an agent skill from ReviewStage/stage-cli. Pick up the review comments the user left in the Stage UI for the current diff, make the requested changes, and resolve each thread.

When should I use Stage Resolve?

Stage Resolve fits situations like: development work in your project.

How do I install Stage Resolve in Claude Code?

Run `npx skills add ReviewStage/stage-cli --skill stage-resolve -a claude-code`. Or copy the skill folder (skills/stage-resolve in ReviewStage/stage-cli) into .claude/skills/stage-resolve in your project. Claude Code loads it when a task matches its description.

How do I install Stage Resolve in Codex?

Run `npx skills add ReviewStage/stage-cli --skill stage-resolve -a codex`. Or copy the skill folder (skills/stage-resolve in ReviewStage/stage-cli) into .agents/skills/stage-resolve in your project. Codex loads it when a task matches its description.

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

What does Stage Resolve need to run?

Going by SKILL.md and its folder, Stage Resolve needs the command-line tools its instructions call (npm). Our summary lists: Node.js.

Does Stage Resolve access the network?

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

Is Stage Resolve 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 Stage Resolve use?

Stage Resolve 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 Stage Resolve use?

About 1.3k tokens (SKILL.md is roughly 5.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 Stage Resolve?

Skills that share tags, products or a category with Stage Resolve: Vercel Composition Patterns (supabase/supabase, 111k stars), Finishing a Development Branch (obra/superpowers, 297k stars), Typescript Advanced Types (rolling-scopes/rsschool-app, 10k stars) and PR Babysitter (openinterpreter/openinterpreter, 69k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Stage Resolve?

ReviewStage (a GitHub organization) maintains it in ReviewStage/stage-cli, which has 274 GitHub stars. The repository holds 10 skills in this directory. The repository was last updated on September 7, 2026.

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