github-remote

A read-first command-line wrapper around GitHub’s REST API for inspecting pull requests, branches, continuous integration checks, reviews, workflow runs, and merge status.

In plain words
What is it for?
Checking whether a pull request or branch is ready to merge and investigating why its CI checks failed.
Why use it?
It combines common GitHub status checks into one project-scoped overview instead of requiring several separate commands.

Skill for Claude CodeCodex

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add skills/osouthgate/agent-plus-skills/github-remote
Any agent
npx skills add osouthgate/agent-plus-skills --skill github-remote
Clone the repo
git clone --depth 1 https://github.com/osouthgate/agent-plus-skills

Made for: Claude Code, Codex.

Per session 118 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 3,169 The whole file, excluding the scripts and references it only reads on demand.
Security scan B 2 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00118 $0.03169
Opus 5 $0.00059 $0.01584
Sonnet 5 $0.00024 $0.00634
Haiku 4.5 $0.00012 $0.00317

Measured 2d ago against content hash 9f24b5eedb6d, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade B, and why

github-remote scanned grade B with 2 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 2d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Reads agent configuration directoriesmediumAgent snooping

.claude/, .codex/, .gemini/ hold keys, settings and other credentials a mod has no legitimate need for.

3. Fail with a missing-config message pointing at `.env`, `~/.claude/settings.json`, and `gh auth login`.

Makes network callslowCapability

Not a fault in itself. Listed so you know the mod talks to something, and to what.

**This wrapper is read-first by design.** The only write surface is `pr comment`. Every other state-changing GitHub operation is deliberately unwrapped — if the user wants to DO something (merge, close, create, dispatch)
github-remote/skills/github-remote/SKILL.md · 178 lines

How it starts

The opening of the file, as written. The whole thing — 178 lines — stays where its author put it; the contents beside it link to each section on GitHub.

github-remote

Project-scoped CLI that wraps the GitHub REST API into a read-first, JSON-output triage tool. Stdlib-only Python 3 (no pip installs, no venvs). Designed for agent-driven PR/CI inspection — one call returns PR state + checks + reviews + runs so you don't burn tool calls chaining gh pr view / gh pr checks / gh run view per investigation.

Lives at ${CLAUDE_SKILL_DIR}/../../bin/github-remote; the plugin auto-adds bin/ to PATH, so just run github-remote ....

Prerequisites

  • GITHUB_TOKEN set in project .env / .env.local / shell env, OR gh logged in (the CLI falls back to gh auth token). Get a PAT at https://github.com/settings/tokens.
  • Repo resolution: pass --repo owner/name, or set GITHUB_REPO, or run from a git checkout whose origin points at github.com.

The CLI bails with a clear missing-config message if neither auth nor repo is resolvable.

When to reach for this

  • User asks "is this PR green / mergeable" → run overview <branch-or-pr-number> --pretty. One call → PR + checks + reviews + runs + mergeable + review comment count.
  • User asks "why did CI fail on " → run overview <branch> to see failing job names, then run logs <run-id> --errors-only --tail 100.
  • User asks "resolve the PR for " → run pr resolve <branch>. Exits non-zero with candidates on ambiguity; never auto-picks.
  • User asks "wait for the run on main" → run run wait main --timeout 1800. Accepts a branch or a run ID. Exits non-zero on timeout or non-success conclusion.
  • User asks "post a comment on PR 498" → run pr comment 498 --body '…'. Posts via /issues/{n}/comments (issue-style comments on PRs, which is what gh pr comment does).

Headline commands

github-remote pr list [--state open|closed|merged|all] [--base <branch>] [--author <u>] [--limit 50]
github-remote pr resolve <branch-or-partial-title>
github-remote pr show <N-or-branch>
github-remote pr comment <N-or-branch> --body <text>

github-remote issue list [--state open|closed|all] [--assignee <u>] [--label <l>] [--limit 50]
github-remote issue resolve <title-pattern>
github-remote issue show <N>

github-remote run list [--branch <b>] [--status in_progress|completed|queued] [--limit 20]
github-remote run show <RUN_ID>
github-remote run logs <RUN_ID> [--job <name>] [--errors-only] [--tail 50]
github-remote run wait <RUN_ID-or-branch> [--timeout 1800] [--poll-interval 10]

github-remote overview <branch-or-pr-number>

github-remote whoami [--json]   # identity for `agent-plus refresh` ("what's my github identity")

Read the full file on GitHub · 178 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 2d ago First seen · 178 lines · 118 tokens per session scan B 9f24b5eedb6d

Subscribe to this mod's changes

github-remote is a skill published in the GitHub repository osouthgate/agent-plus-skills (2 stars, last pushed 3mo ago), licensed MIT. It adds 118 tokens to every session and 3,169 once invoked, about $0.0006 per session on Opus 5. A static security scan graded it B with 2 findings (reads agent configuration directories, makes network calls). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.

Related

Other skills, from other repositories

model-compatibility

Model family compatibility matrix covering loaders, resolutions, samplers, CFG, VAE, ControlNet, and LoRA compatibility for SD 1.5, SDXL, Flux, SD3, and video models.

artokun/comfyui-mcp · 47 tokens

comfyui-node-registry

Authoring & publishing ComfyUI custom nodes to the Comfy Registry, covering node structure, pyproject.toml spec, comfy-cli publishing, and CI.

artokun/comfyui-mcp · 38 tokens

flux-txt2img

Build Flux txt2img workflows with Flux.1 Dev (SRPO), Flux 2 Klein 9B, Turbo LoRAs, FluxGuidance, and DualCLIPLoader patterns.

artokun/comfyui-mcp · 44 tokens

civitai

Discover Civitai models with the BUILT-IN downloadmodel action:"searchcivitai" and install/generate them locally. Find a checkpoint/LoRA/embedding on Civitai, download it into ComfyUI, and use its trigger words. Optionally pair the official Civitai MCP for community features (images browsing, posting, collections).

artokun/comfyui-mcp · 76 tokens

chief-strategy-officer

Owns where the business plays and how it wins over a multi-year horizon — portfolio choices, corporate development, strategic partnerships, and planning under uncertainty. Use this for a decision about which markets or businesses to be in, whether to build, buy, or partner, how to allocate capital across business…

cbrock84/headcount · 93 tokens

performance-analysis

Measurement approaches, profiling patterns, bottleneck identification, and optimization guidance. Use when diagnosing performance issues, establishing baselines, identifying bottlenecks, or planning for scale. Always measure before optimizing.

rsmdt/the-startup · 42 tokens