orient-status

Computes current position, remaining work, and banded ETA for repos, plans, or folders via a read-only subagent.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? When returning to a project after a gap or starting a session cold, it is hard to answer "how far along am I and when will it be done?" without manually digging through git history, plans, and checklists. This Skill computes that status read fresh on every call, with honest provenance tagging so you know which numbers are attested facts and which are guesses. ## Core Features & Use Cases - Position and remaining-work read: Gathers evidence from git (branch, dirty count, ahead/behind, commits), plan files (open/done checklist counts, current phase), and folder signals via a bounded read-only subagent, returning only a distilled bundle. - Banded ETA with fail-closed honesty: Forecasts are always ranges tagged "estimate, not observed"; on barren evidence the output degrades visibly (gate_status degraded/indeterminate) instead of fabricating a confident answer. - --resume mode: Rebuilds context after a break with exactly one next move, its counter-case, and the dropped alternative. - Three output faces: A structured YON record for agent consumers, a plain-language markdown read for humans, and a visual widget (Claude Code) with a mandatory information-complete ASCII twin. - Use Case: You return to a feature branch after a week away and ask where things stand; the Skill reports the current phase, 4 open items out of 5, a 1-3 day ETA band, and the single next move to pick the thread back up. ## Quick Start Ask the agent "where are we on this repo and what's the ETA?" or invoke /orient-status, optionally passing a one-line goal so distance and ETA fields can be computed.

Frequently Asked Questions about orient-status

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

FAQPage Schema
How do I check project status and ETA with an AI agent?

Invoke /orient-status or ask "how far along is this repo" and the Skill computes position, remaining work, and a banded ETA from git, plan files, and folder evidence. A bounded read-only subagent does the gathering so you only see the distilled result.

How to resume work after losing context on a task?

Use the --resume flag, which rebuilds context after a gap by showing the exact spot you stopped, the half-finished thought, and exactly one next move with its counter-case. It suppresses the full snapshot to focus on re-entry.

Does orient-status work on folders without git or a plan file?

Yes, but it degrades honestly: with no durable state it reports an indeterminate gate status, marks every field as guessed, and suggests naming the goal in one line. The empty-folder read is treated as a success state, not an error.

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

orient-status reports the current position and forecast only. orient-map covers what changed since you last looked, orient-gaps covers what is stuck or missing, and orient-roadmap covers what comes next; orient-status deliberately does not answer those questions.

Why does the status output show an ETA range instead of a date?

The Skill bans point estimates because a single date implies false precision. ETAs are always bands tagged "estimate, not observed", and with no plan on record the ETA is reported as unknown rather than fabricated.

Does orient-status modify my repository or store state between runs?

No, it is strictly read-only and ephemeral. Every call recomputes from current evidence, nothing is written to disk, and the only reference points (intent line, last-look anchor) are caller-supplied or harness-held.