Agent skill

Ralph Two Pass Scan

by bradygaster in bradygaster/squad

Cuts GitHub API calls by separating lightweight list scanning from full hydration

MITAuto-check passed

Install Ralph Two Pass Scan

skills CLI
$ npx skills add bradygaster/squad --skill ralph-two-pass-scan -a claude-code

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

GitHub CLI
$ gh skill install bradygaster/squad ralph-two-pass-scan --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/bradygaster/squad.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.squad-templates/skills/ralph-two-pass-scan .claude/skills/ralph-two-pass-scan && 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
ralph-two-pass-scan
GitHub stars
3.3k
Token cost
~332 tokens
SKILL.md length
117 words
Files
1
Skills in repo
31
Repo updated
First seen
Licence
MIT

At a glance

Cuts GitHub API calls by separating lightweight list scanning from full hydration

  • SKILL.md covers Context and Pattern
  • Calls gh

What it does

Ralph Two Pass Scan is an agent skill from bradygaster/squad. Cuts GitHub API calls by separating lightweight list scanning from full hydration

Its SKILL.md is about 330 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It works with GitHub. The repository describes itself as: Squad: AI agent teams for any project. The licence is MIT.

Example prompts

  • “/ralph-two-pass-scan”

What it can do on your machine

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

    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

Ralph Two Pass Scan loads about 332 tokens when it runs. Until then it costs about 25 tokens; SKILL.md has 117 words of instructions outside code blocks.

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

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 bradygaster/squad at commit 71818eb, republished under its MIT licence (© bradygaster). 117 words, ~332 tokens.

Download SKILL.mdSave it as .claude/skills/ralph-two-pass-scan/SKILL.md (or your agent's skills folder).
name
ralph-two-pass-scan
description
Cuts GitHub API calls by separating lightweight list scanning from full hydration
domain
work-monitoring
confidence
high
source
extracted

Skill: Ralph — Two-Pass Issue Scanning

Confidence: high Domain: work-monitoring Last validated: 2026-03-24

Context

Cuts GitHub API calls from N+1 to ~7 per round (~72% reduction) by separating list scanning from full hydration. Addresses the scanning inefficiency described in issue #596.

Pattern

Pass 1 — Lightweight Scan
gh issue list --state open --json number,title,labels,assignees --limit 100

Skip hydration if ANY of these match:

ConditionSkip reason
assignees non-empty AND no status:needs-reviewAlready owned
Labels contain status:blocked or status:waiting-externalExternally gated
Labels contain status:done or status:postponedClosed loop
Title matches stale/noisy pattern ([chore], [auto])Low-signal
Pass 2 — Selective Hydration

For each issue surviving Pass 1:

gh issue view <number> --json number,title,body,labels,assignees,comments,state

Then apply normal Ralph triage logic. Rule of thumb: hydrate ≤ 30% of scanned list. If more than 30% survive Pass 1, tighten filter rules.

© bradygaster, 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 .squad-templates/skills/ralph-two-pass-scan of bradygaster/squad.

Open the folder on GitHubat commit 71818eb

Compare with similar skills

Ralph Two Pass Scan 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.

Ralph Two Pass Scan compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Ralph Two Pass Scan this skillbradygaster/squad3.3k—~332Automated safety check: PassMIT
PR Babysitteropeninterpreter/openinterpreter69k3 repos~4.2kAutomated safety check: PassApache-2.0
Diagnosing Superpowers Sessionsobra/superpowers297k3 repos~1.7kAutomated safety check: PassMIT
Greplooponyx-dot-app/onyx32k4 repos~3.3kAutomated safety check: PassMIT
GitHub Deep Researchbytedance/deer-flow84k4 repos~1.3kAutomated safety check: PassMIT
Update V8 Versionopeninterpreter/openinterpreter69k2 repos~845Automated safety check: PassApache-2.0

Similar skills

  • 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
  • Investigates a session where Superpowers went wrong, reads the transcripts on disk and produces an evidence-cited report, optionally prepared as a bug report for the maintainers.

    297k GitHub starsUsed in 3 repos~1.7k tokens
    Agent WorkflowsAuto-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
  • GitHub Deep Research

    bytedance/deer-flow

    Researches a GitHub repository over four rounds using the GitHub API and web search, then writes a structured markdown report with timeline, metrics and Mermaid diagrams.

    84k GitHub starsUsed in 4 repos~1.3k tokens
    Research & ScienceAuto-check passed
  • Update V8 Version

    openinterpreter/openinterpreter

    Bumps the pinned v8 and rusty_v8 versions in Codex, validates the release-candidate path with the v8-canary check, and traces failures to upstream build changes.

    69k GitHub starsUsed in 2 repos~845 tokens
    DevOps & CloudAuto-check passed
  • Last30days

    mvanhorn/last30days-skill

    Research what people actually say about any topic in the last 30 days.

    64k GitHub stars~7.9k tokensUpdated today
    Research & ScienceAuto-check: notes

More from bradygaster/squad

All 31 skills in this repo
  • Fact Checking

    bradygaster/squad

    Review and validate claims using counter-hypothesis testing.

    3.3k GitHub stars~503 tokensUpdated today
    Auto-check passed
  • Architectural Review

    bradygaster/squad

    How to review PRs for architectural quality — module boundaries, dependency direction, export surface, pattern consistency

    3.3k GitHub stars~2.2k tokensUpdated today
    Auto-check passed
  • Archival Integrity

    bradygaster/squad

    Preserve content when moving entries between tracked Squad state files

    3.3k GitHub stars~735 tokensUpdated today
    Auto-check passed
  • CI Validation Gates

    bradygaster/squad

    Defensive CI/CD patterns: semver validation, token checks, retry logic, and draft detection

    3.3k GitHub stars~1.1k tokensUpdated today
    Auto-check passed
  • CLI Wiring

    bradygaster/squad

    Checklist and patterns for wiring new CLI commands into cli-entry.ts

    3.3k GitHub stars~501 tokensUpdated today
    Auto-check passed
  • Enables squad agents on different machines to share work via git-based task queuing

    3.3k GitHub stars~2.7k tokensUpdated today
    Auto-check passed

Works with

Questions about Ralph Two Pass Scan

What does Ralph Two Pass Scan do?

Cuts GitHub API calls by separating lightweight list scanning from full hydration. Ralph Two Pass Scan is an agent skill from bradygaster/squad.

How do I install Ralph Two Pass Scan in Claude Code?

Run `npx skills add bradygaster/squad --skill ralph-two-pass-scan -a claude-code`. Or copy the skill folder (.squad-templates/skills/ralph-two-pass-scan in bradygaster/squad) into .claude/skills/ralph-two-pass-scan in your project. Claude Code loads it when a task matches its description.

How do I install Ralph Two Pass Scan in Codex?

Run `npx skills add bradygaster/squad --skill ralph-two-pass-scan -a codex`. Or copy the skill folder (.squad-templates/skills/ralph-two-pass-scan in bradygaster/squad) into .agents/skills/ralph-two-pass-scan in your project. Codex loads it when a task matches its description.

Can I use Ralph Two Pass Scan 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 bradygaster/squad --skill ralph-two-pass-scan -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/ralph-two-pass-scan, .gemini/skills/ralph-two-pass-scan, .github/skills/ralph-two-pass-scan and .opencode/skills/ralph-two-pass-scan in your project.

What does Ralph Two Pass Scan need to run?

Going by SKILL.md and its folder, Ralph Two Pass Scan needs the command-line tools its instructions call (gh).

Does Ralph Two Pass Scan 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 Ralph Two Pass Scan 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 Ralph Two Pass Scan use?

Ralph Two Pass Scan 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 Ralph Two Pass Scan use?

About 332 tokens (SKILL.md is roughly 1.3k 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 Ralph Two Pass Scan?

Skills that share tags, products or a category with Ralph Two Pass Scan: PR Babysitter (openinterpreter/openinterpreter, 69k stars), Diagnosing Superpowers Sessions (obra/superpowers, 297k stars), Greploop (onyx-dot-app/onyx, 32k stars) and GitHub Deep Research (bytedance/deer-flow, 84k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Ralph Two Pass Scan?

bradygaster (a GitHub user) maintains it in bradygaster/squad, which has 3,259 GitHub stars. The repository holds 31 skills in this directory. The repository was last updated on October 9, 2026.

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