startlisted
Install: claude install-skill wrg32786/aigent-os
# /start: wake the operator
Use this skill on first launch and whenever the operator asks for the home screen, start menu, or orientation.
## State contract
The canonical first-run state is `.aigent/state.json`:
```json
{
"schemaVersion": 1,
"status": "uninitialized | setup-in-progress | ready",
"completedAt": null
}
```
For compatibility with installations before v0.9, `.aigent/first-run-done` is also recognized.
- `status: ready` or a legacy first-run marker means returning operator.
- Missing state, invalid state, or any other status means first run.
- If the legacy marker exists but the JSON state is not ready, migrate the JSON state to `ready` silently.
## First run
1. Write `status: setup-in-progress` before asking questions, so an interrupted setup can resume.
2. Give a two-line, warm, plain greeting:
> I'm your AIgent operator. Let's get you one real win in the next few minutes.
3. Run `/operator-setup`, one question at a time.
4. When the operator chooses an action from the personal briefing, run `/first-win` and produce a usable artifact.
5. Teach the operating loop once:
> Later sessions pick up on their own via `/resume`. When you are done, say "close up" or run `/context-capsule` so the work is banked (it also autosaves as you go). Run `/statusline` once in Claude Code to show context usage.
6. Only after setup memory and the first artifact are successfully written:
- Set `.aigent/state.json` to `status: ready` with an ISO-8601 `completedAt