gaia-research/gaia-skill-tree / .agents/skills/gaia-steward-observe
gaia-steward-observe
VerifiedObserve the repository with every registered Gaia Steward detector and report what each one actually saw, without changing anything. Use for "/gaia-steward-full --observe", "what is Steward seeing", "scan the repo for maintenance debt", or as the first phase of a full Steward run. Distinguishes actively observed, unknown/unavailable and not-evaluated detectors; never treats an unexecuted probe as healthy.
gaia-steward-observe
Responsibility
Run the detector fleet once against the checkout head and produce a receipt that says, per detector, whether it observed, could not observe, or was not evaluated. Nothing else.
Input
- A Git worktree of
gaia-skill-tree(the detectors read Git's index, not the filesystem). - Optional driver inputs under the ignored
.gaia/steward/inputs/:ci-runs.json,advisories.json,test-history.json. Their absence is a not-evaluated state, never an error and never healthy. - The GitHub pull-request census
github-prs.json(routine 19,pr-maintenance), refreshed bypython scripts/steward_pr_census.py. A missing census reports routine 19 not evaluated; an incomplete or stale one reports it unavailable (Class A is blocked). - The GitHub issue census
github-issues.json(routine 18,issue-hygiene), refreshed bypython scripts/steward_issue_census.pybefore observing. A missing census reports routine 18 not evaluated. An incomplete or stale census reports it unavailable, which blocks Class A for the run.
Output
gaia steward full run --observe --json
python scripts/check_steward_coverage.py --receipt .gaia/steward/receipts/<run>.json
The receipt (steward-receipt-v1) carries coverageKnown, coverageUnknown,
notEvaluated, openDebt and authorityCounts. The checker turns it into a
live state per detector: actively-observed only when listed in
coverageKnown; everything else is unknown-unavailable.
Authority ceiling
Read-only. Writes only ignored state under .gaia/steward/ and the run record in
the Steward ledger. No repair, dispatch, branch or PR.
Stop conditions
- Any detector in
coverageUnknown: report it first and stop treating the run as clean; Class A is blocked for the run. - The observation budget in
POLICY.yamlis exceeded: stop and report.
Idempotency
Observing the same head twice yields the same debt ids
(debt:{kind}:{slug}:{digest}); re-observation updates lastSeen, never
duplicates debt.
Failure states
| State | Meaning |
|---|---|
coverageUnknown | a required input was missing, truncated or unreadable |
notEvaluated | an optional driver input was not supplied |
blocked result | at least one detector was unknown |
Validation
python scripts/check_steward_coverage.py
python -m pytest tests/steward/test_controller.py tests/steward/test_coverage_regressions.py -q
Tests
tests/steward/test_controller_resolution.py, tests/steward/test_routine_coverage.py,
tests/steward/test_steward_skills.py.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |