Agent skill

Watch PR

by s3s-project in s3s-project/s3s

Follow an open pull request with xtask watch-pr. An agent skill from s3s-project/s3s.

Apache-2.0Auto-check passedDevelopment

Install Watch PR

skills CLI
$ npx skills add s3s-project/s3s --skill watch-pr -a claude-code

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

GitHub CLI
$ gh skill install s3s-project/s3s watch-pr --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/s3s-project/s3s.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/watch-pr .claude/skills/watch-pr && 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
watch-pr
GitHub stars
311
Token cost
~900 tokens
SKILL.md length
555 words
Files
1
Skills in repo
10
Repo updated
First seen
Licence
Apache-2.0

At a glance

Follow an open pull request with xtask watch-pr. An agent skill from s3s-project/s3s.

  • A pull request has to be watched until it merges
  • SKILL.md covers What it watches, When it exits, Reading the log and Waiting for checks instead
  • Calls gh and cargo
  • A watcher exits and has to be restarted from its log

What it does

Watch PR is an agent skill from s3s-project/s3s. Follow an open pull request with xtask watch-pr. Use when a pull request has to be watched until it merges or closes, when a watcher exits and has to be restarted from its log, or when deciding between watching the pull request and waiting for its checks.

Its SKILL.md is about 900 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. The licence is Apache-2.0.

When your agent uses it

  • A pull request has to be watched until it merges
  • A watcher exits and has to be restarted from its log
  • Deciding between watching the pull request and waiting for its checks

Example prompts

  • “/watch-pr”

What it can do on your machine

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

    • gh
    • cargo

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

  • Network

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

Watch PR loads about 900 tokens when it runs. Until then it costs about 66 tokens; SKILL.md has 555 words of instructions outside code blocks.

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

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 s3s-project/s3s at commit cd69f7e, republished under its Apache-2.0 licence (© s3s-project). 555 words, ~900 tokens.

Download SKILL.mdSave it as .claude/skills/watch-pr/SKILL.md (or your agent's skills folder).
name
watch-pr
description
Follow an open pull request with xtask watch-pr. Use when a pull request has to be watched until it merges or closes, when a watcher exits and has to be restarted from its log, or when deciding between watching the pull request and waiting for its checks.
license
Apache-2.0

Watching a pull request

cargo run -p xtask -- watch-pr <PR#> follows the state that decides whether a pull request can land. Hang it in the background when a pull request opens, read its log when it exits, and hang it again: a zero exit is the signal, and a non-zero exit means the watcher itself failed.

What it watches

Each tick prints one state line; the line is appended to target/pr-watch/pr-<n>.log when it differs from the last logged one, once when the log is empty, and at a heartbeat every twenty ticks (--log moves the file). The line covers state, draft, mergeStateStatus, auto-merge, base and head, the review decision, review and comment counts, labels, review requests, the check summary with the names of failing checks, the title, and the merge-queue entry.

When it exits

It exits when something decision-relevant changes, when the pull request merges or closes, or when its twelve-hour budget runs out. Restarting it after each exit keeps the coverage continuous: the baseline is restored from the last line of the log, so a restart does not re-report a change that was already read, and it does not miss one that happened while nothing was watching.

A zero exit means one of those three; a non-zero exit means the snapshot failed three times in a row, usually because gh is unavailable. The failure lines are printed to stdout rather than appended to the log, so read them before restarting.

It deliberately ignores the churn that would wake somebody for nothing: check counts moving while the set is still running, a flap between BLOCKED, UNSTABLE and UNKNOWN (GitHub reports UNKNOWN while it recomputes mergeability, and the answer is usually the state the pull request already had), and comments written by a bot. A new failure, a settled check set, a review, a label, a review request, a merge-queue entry and the merge or close transition all count.

Keep one watcher per pull request, and hang the next one after every exit; the twelve-hour budget means a pull request that stays open needs a new watcher every twelve hours, so a quiet one takes two hangs a day.

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

Reading the log

Read the log at natural nodes rather than polling it: when a watcher exits, when a review arrives, when the checks settle. Report what changed, then hang the next watcher with the last line as its baseline. When the pull request merges or closes, keep the terminal line in the same log, stop watching, and continue with the landing steps in the pull-request skill — the merge does not delete the head branch and main may have moved.

Waiting for checks instead

watch-pr covers the pull request as a whole. When the checks, or a single run, are the whole question, gh watches them directly:

  • gh pr checks <PR> --watch --interval 60 waits for the checks of a pull request (exit code 0 when they pass, non-zero when one fails, 8 while the set is pending).
  • gh run watch <run-id> --exit-status follows one workflow run.

gh pr checks --watch refreshes every ten seconds by default, so pass 60 to match the pace used here. Reach for watch-pr when the draft state, the reviews, the labels, the review requests or the merge-queue entry matter: it keeps a baseline across restarts, which the built-in commands do not.

© s3s-project, Apache-2.0. 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/watch-pr of s3s-project/s3s.

Open the folder on GitHubat commit cd69f7e

Compare with similar skills

Watch PR 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.

Watch PR compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Watch PR this skills3s-project/s3s311—~900Automated safety check: PassApache-2.0
Finishing a Development Branchobra/superpowers297k5 repos~1.9kAutomated safety check: PassMIT
PR Babysitteropeninterpreter/openinterpreter69k3 repos~4.2kAutomated safety check: PassApache-2.0
Check PRonyx-dot-app/onyx32k2 repos~2.3kAutomated safety check: PassMIT
PR Design DocOpenHands/OpenHands90k—~2.4kAutomated safety check: PassMIT
WooCommerce Code Reviewwoocommerce/woocommerce11k3 repos~1.1kAutomated safety check: PassCustom licence

Similar skills

  • 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
  • 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
  • Check PR

    onyx-dot-app/onyx

    Checks a GitHub, GitLab, or Perforce (p4) pull request (or merge request, or shelved changelist) for unresolved review comments, failing status checks, and incomplete PR descriptions.

    32k GitHub starsUsed in 2 repos~2.3k tokens
    DevelopmentAuto-check passed
  • PR Design Doc

    OpenHands/OpenHands

    For a non-trivial pull request, write a self-contained HTML design doc under the temporary .pr/ directory and link a visibility-appropriate preview in the PR description, so maintainers grasp the…

    90k GitHub stars~2.4k tokensUpdated today
    DevelopmentAuto-check passed
  • WooCommerce Code Review

    woocommerce/woocommerce

    Reviews WooCommerce code changes against the project's standards, flagging backend PHP architecture, naming, documentation, data integrity and testing violations.

    11k GitHub starsUsed in 3 repos~1.1k tokens
    DevelopmentAuto-check passed
  • Record PR Demo

    payloadcms/payload

    A skill your agent uses when a Payload pull request needs a concise visual walkthrough for reviewers.

    45k GitHub stars~1k tokensUpdated yesterday
    DevelopmentAuto-check passed

More from s3s-project/s3s

All 10 skills in this repo
  • Code Coverage

    s3s-project/s3s

    Measure and grow the line coverage of the s3s crate. An agent skill from s3s-project/s3s.

    311 GitHub stars~789 tokensUpdated yesterday
    Auto-check passed
  • Gh Stack

    s3s-project/s3s

    Work with stacked pull requests in this repository using gh stack.

    311 GitHub stars~1.6k tokensUpdated yesterday
    Auto-check passed
  • Code Review

    s3s-project/s3s

    Review a pull request or a proposed change to this repository.

    311 GitHub stars~2k tokensUpdated yesterday
    Auto-check passed
  • Codegen

    s3s-project/s3s

    Change generated code in this repository. An agent skill from s3s-project/s3s.

    311 GitHub stars~726 tokensUpdated yesterday
    Auto-check passed
  • Fuzz Testing

    s3s-project/s3s

    Add, run or schedule a fuzz target in this repository. An agent skill from s3s-project/s3s.

    311 GitHub stars~838 tokensUpdated yesterday
    Auto-check passed
  • Mutation Testing

    s3s-project/s3s

    Run or triage the mutation sweep in this repository. An agent skill from s3s-project/s3s.

    311 GitHub stars~917 tokensUpdated yesterday
    Auto-check passed

Categories

Questions about Watch PR

What does Watch PR do?

Follow an open pull request with xtask watch-pr. An agent skill from s3s-project/s3s. Watch PR is an agent skill from s3s-project/s3s. Follow an open pull request with xtask watch-pr.

When should I use Watch PR?

Watch PR fits situations like: A pull request has to be watched until it merges; A watcher exits and has to be restarted from its log; deciding between watching the pull request and waiting for its checks.

How do I install Watch PR in Claude Code?

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

How do I install Watch PR in Codex?

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

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

What does Watch PR need to run?

Going by SKILL.md and its folder, Watch PR needs the command-line tools its instructions call (gh and cargo).

Does Watch PR access the network?

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

Is Watch PR 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 Watch PR use?

Watch PR is published under the Apache-2.0 licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Watch PR use?

About 900 tokens (SKILL.md is roughly 3.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 Watch PR?

Skills that share tags, products or a category with Watch PR: Finishing a Development Branch (obra/superpowers, 297k stars), PR Babysitter (openinterpreter/openinterpreter, 69k stars), Check PR (onyx-dot-app/onyx, 32k stars) and PR Design Doc (OpenHands/OpenHands, 90k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Watch PR?

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

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