Skill: Ralph — Two-Pass Issue Scanning
**Confidence:** high
Best use case
Skill: Ralph — Two-Pass Issue Scanning is best used when you need a repeatable AI agent workflow instead of a one-off prompt.
**Confidence:** high
Teams using Skill: Ralph — Two-Pass Issue Scanning should expect a more consistent output, faster repeated execution, less prompt rewriting.
When to use this skill
- You want a reusable workflow that can be run more than once with consistent structure.
When not to use this skill
- You only need a quick one-off answer and do not need a reusable workflow.
- You cannot install or maintain the underlying files, dependencies, or repository context.
Installation
Claude Code / Cursor / Codex
Manual Installation
- Download SKILL.md from GitHub
- Place it in
.claude/skills/ralph-two-pass-scan/SKILL.mdinside your project - Restart your AI agent — it will auto-discover the skill
How Skill: Ralph — Two-Pass Issue Scanning Compares
| Feature / Agent | Skill: Ralph — Two-Pass Issue Scanning | Standard Approach |
|---|---|---|
| Platform Support | Not specified | Limited / Varies |
| Context Awareness | High | Baseline |
| Installation Complexity | Unknown | N/A |
Frequently Asked Questions
What does this skill do?
**Confidence:** high
Where can I find the source code?
You can find the source code on GitHub using the link provided at the top of the page.
SKILL.md Source
# 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:** | Condition | Skip reason | |-----------|-------------| | `assignees` non-empty AND no `status:needs-review` | Already owned | | Labels contain `status:blocked` or `status:waiting-external` | Externally gated | | Labels contain `status:done` or `status:postponed` | Closed 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.
Related Skills
My Skill
No description provided.
rework-rate
Measure and interpret PR rework rate — the emerging 5th DORA metric
project-conventions
Core conventions and patterns for this codebase
tiered-memory
Three-tier agent memory model (hot/cold/wiki) for 20-55% context reduction per spawn
test-discipline
Update tests when changing APIs — no exceptions
Skill: Retro Enforcement
## Purpose
reflect
Learning capture system that extracts HIGH/MED/LOW confidence patterns from conversations to prevent repeating mistakes. Use after user corrections ("no", "wrong"), praise ("perfect", "exactly"), or when discovering edge cases. Complements .squad/agents/{agent}/history.md and .squad/decisions.md.
notification-routing
Route agent notifications to specific channels by type — prevent alert fatigue from single-channel flooding
iterative-retrieval
Max-3-cycle protocol for agent sub-tasks with WHY context and coordinator validation. Use when spawning sub-agents to complete scoped work.
error-recovery
Standard recovery patterns for all squad agents. When something fails, adapt — don't just report the failure.
docs-standards
Microsoft Style Guide + Squad-specific documentation patterns
{skill-name}
{what this skill teaches agents}