Quick Rules

Find the exact orbit.json first.
If there is more than one manifest, choose intentionally and pass --manifest.
If the manifest declares more than one platform, pass --platform.
Treat .orbit/ as generated state. Inspect it when useful, but do not edit it by hand.
Prefer repeatable invocations with --non-interactive.
Retry with --verbose before guessing how Orbit behaves.
Ask before commands with meaningful side effects:
- orbit submit
- orbit clean --all
- mutating orbit apple ... commands
- signing import/export against real credentials

Product Sources Of Truth

Manifest field docs live in the orbit.json schema. Prefer editor/schema help over handwritten markdown.

Use this skill when a repository is driven by orbit.json and Orbit CLI.

Find the exact orbit.json first.
If there is more than one manifest, choose intentionally and pass --manifest.
If the manifest declares more than one platform, pass --platform.
Treat .orbit/ as generated state. Inspect it when useful, but do not edit it by hand.
Prefer repeatable invocations with --non-interactive.
Retry with --verbose before guessing how Orbit behaves.
Ask before commands with meaningful side effects:
- orbit submit
- orbit clean --all
- mutating orbit apple ... commands
- signing import/export against real credentials

Manifest field docs live in the orbit.json schema. Prefer editor/schema help over handwritten markdown.