orient-gaps

Detect blockers, open forks, loose ends, and silent gaps in projects via a read-only subagent sweep.

14|1|Updated Jun 14, 2026
One-click install
npx skills add https://github.com/allemaar/open-skills --skill orient-gaps-allemaar
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: orient-gaps
Source: https://github.com/allemaar/open-skills/tree/main/skills/orient-gaps
Command: npx skills add https://github.com/allemaar/open-skills --skill orient-gaps-allemaar

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? When work stalls, it is hard to see exactly what is stuck, what is missing, and whether status claims rest on real evidence. This Skill answers "what is stuck or missing?" on any project, repo, plan, or task by computing a fresh, read-only assessment of blockers, unresolved decisions, uncommitted work, and inferred silent gaps. ## Core Features & Use Cases - Stall surface detection: Delegates evidence gathering to a bounded, read-only subagent that checks git state (uncommitted files, unmerged branches), plan documents (unchecked items, TODO/FIXME markers), and conversation threads to attribute blockers as on-you versus on-others. - Silent gap inference: Surfaces what is plausibly missing but unproven (no tests next to new code, stale docs), always marked with provenance tiers (attested, inferred, guessed) and never presented as confirmed fact. - Audit mode: The --audit flag raises claim-versus-evidence mismatches and gamed signals, such as a "tests pass" claim with no test files or commit counts padded by whitespace-only changes. - Use Case: Before trusting a status update on a repo, run the gaps check to see that one blocker awaits review, three files are uncommitted, and a schema decision was never recorded, each with a re-runnable source reference. ## Quick Start Ask the agent to run /orient-gaps on the current repository to show what is stuck, what is missing, and whether the evidence supports trusting it.

Frequently Asked Questions about orient-gaps

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I find what is blocking my project?

Run the /orient-gaps command on the repository or plan in question. It spawns a bounded read-only subagent that checks git status, plan documents, and conversation threads, then returns blockers attributed as on-you versus on-others with re-runnable source references.

What is the difference between orient-gaps and orient-status?

orient-gaps reports the stall surface: what is stuck, missing, or unbacked by evidence. orient-status reports position, remaining work, and ETA. Use orient-gaps when you ask why you cannot move forward, and orient-status when you ask how far along you are.

Does orient-gaps modify my repository or files?

No, it is strictly read-only. It never mutates state, stores nothing between calls, and recomputes everything fresh from current evidence on each invocation. The only reference point is a caller-supplied intent line.

What does the --audit flag do in orient-gaps?

The --audit flag adds a third analysis tier that flags claims lacking corroborating evidence, such as a done claim with no commit, and gamed signals like commit counts inflated by whitespace-only changes. Hollow metrics are tagged with the guessed tier so they read as hollow.

What happens when orient-gaps finds no evidence?

It fails closed by setting the gate status to degraded or indeterminate with a sentinel value, never a plausible ready verdict. An empty stall surface with real evidence collapses to a one-line clean success state instead.