orbit_skill

Overview

This skill enforces loop-operation contracts for nexus-autoloop style autonomous workflows. It focuses on making autonomous loops predictable, auditable, and safely recoverable by validating loop artifacts and governing status semantics. Orbit produces evidence-first recommendations and minimal reversible actions to stabilize or advance loops.

How this skill works

Orbit parses required artifacts (goal.md, progress.md, state.env) and optional evidence (done.md, runner.log), validates the NEXUS_LOOP_STATUS/NEXUS_LOOP_SUMMARY footer, and scores evidence quality. It classifies failure modes (verify gaps, state drift, commit-scope risk), generates a severity-backed next action, and prepares rollback-safe handoffs to Builder, Guardian, Radar, or Nexus. High-impact decisions trigger AskUserQuestion prompts before destructive changes.

When to use it

• When a loop claims DONE but verification evidence is missing or failed
• When resuming a loop and state.env counters disagree with progress.md
• Before recommending an autocommit when the working tree may be dirty
• When goal acceptance criteria are vague or not measurable
• When you need a minimal reversible fix to unblock a stalled loop

Best practices

• Require measurable acceptance criteria in goal.md before declaring DONE
• Prefer the smallest reversible change and document rollback notes
• Separate contract violations (status/footers) from implementation bugs
• Always include verification commands and outcomes with any DONE claim
• Ask for explicit user confirmation before discarding or rewriting user changes

Example use cases

• Audit a loop that reported DONE but lacks verification output, returning CONTINUE with a remediation checklist
• Detect state drift on resume and produce a re-sync plan based on progress.md iteration evidence
• Limit autocommit scope when dirty baseline files are present and hand off safe staging to Guardian
• Create an Orbit→Builder handoff that specifies exact files, failure class, and rollback steps for a minimal patch
• Operate as the completion gate to downgrade false DONE claims and route verification work to Radar