Skip to main content
skill CX Codex

start · wrg32786 — Claude Code skill: setup and use

start — a Claude Code skill that opens a home screen on first launch or when work resumes. It guides setup or gives a brief status update with an action menu.

MIT ★ 26 updated 2026-11-16

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add wrg32786/aigent-os --skill start -a claude-code
Open on GitHub

What start does

The start skill checks whether setup has been completed and chooses the matching flow. On a first run, it records progress in .aigent/state.json, asks questions through /operator-setup, then calls /first-win after an action is chosen and saves the result. Setup becomes ready only after the memory and first artifact have been written.

On return, the skill reads memory/about-you.md and recent session memory, then gives a short briefing and offers actions such as planning the day, drafting content, doing research, or building an automation. The flow also uses /resume, /context-capsule, and /statusline. If those commands are unavailable, their steps in the flow cannot run.

What it helps with

  • guide a first-time setup
  • summarize current priorities and blockers
  • choose a next action from a home screen
  • create a first usable result after setup

Example prompts for the agent

  • Open the home screen and guide me through initial setup.
  • Give me today's briefing and show the action menu.
  • Help me pick what to work on next today.

How to install start

1Skills CLI (Vercel)

npx skills add wrg32786/aigent-os --skill start -a claude-code

2Manually: put the files in place

~/.claude/skills/start/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/start/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about start

How do I install start in Claude Code?

Run npx skills add wrg32786/aigent-os --skill start -a claude-code. The skill file is at ~/.claude/skills/start/SKILL.md.

What does the start skill do?

It guides first-run setup and starts work on an initial artifact. On later runs, it reads session memory and presents a briefing with an action menu.

Which commands does start use?

The setup and first artifact flow call /operator-setup and /first-win. It also uses /resume, /context-capsule, and /statusline.

Source text

SKILL.md · MIT
---
name: start
description: "Provide a home screen with first-run setup, first win, or a return briefing and action menu. Use when launching for the first time or asking what to do today."
trigger: /start
---

# /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` value.
   - Write `.aigent/first-run-done` for backward compatibility.

Do not mark setup ready before the durable writes succeed.

## Returning operator

1. Read `memory/about-you.md` and recent session memory.
2. Give a short, specific briefing: what matters today, what changed, and what is blocked.
3. Surface the action menu.

## Action menu

Present a short numbered list and accept either the number or a plain-language request:

1. Plan my day
2. Draft content
3. Research something
4. Build an automation
5. Check my numbers
6. Talk it through

On first run, lead with zero-dependency actions so the first win never waits on a connector.

## Rules

- Use plain English and the operator's nouns.
- Ask one setup question at a time.
- Never invent business facts.
- If an operation fails, state what failed, what was attempted, and what durable state was or was not written.
- Do not leave `status: setup-in-progress` indefinitely after a successful setup.

© wrg32786 · MIT · wrg32786/aigent-os

Similar skills

All skills for Agent setup: memory, context, orchestration →

start by other authors comes first.

start official anthropics Checks connected MCP servers and surveys bio-research tools. Helps researchers get oriented with the plugin before starting a project. CX Codex +1 5,100installs start Donchitos start is a Claude Code skill that inspects a repository, sets the project stage, and points to the next step after cloning a game studio template. CX Codex +1 692installs start official Anthropic start is a Claude Code skill that initializes the productivity system and opens its dashboard. It is used during plugin setup or to bootstrap memory from tasks. CX Codex +1 ★ 36,654repo stars start official Zoom This Claude Code skill picks a Zoom integration path and points to the implementation skill for the task. It starts from an app idea or a question about integrating Zoom. CX Codex +1 ★ 36,654repo stars start ulpi-io start is a Claude Code skill that routes incoming tasks, selects domain skills, evaluates sub-agent delegation, and limits context exploration before code edits. CX Codex +1 152installs jetson-quick-start Jetson Team jetson-quick-start starts a setup questionnaire for Jetson or IGX BSP customization and passes the answers to downstream skills. Use it before preparing a new workspace or working with an existing one. CX Codex +1 1,200installs desk-journal official github GitHub Copilot skill manages persistent desk journals across session boundaries. Records completed actions, state snapshots, and next steps in Markdown. CX Codex +1 25installs recall BetaBots-LLC recall — a skill for Claude Code and Codex that surfaces past AI coding dialogues. It retrieves settled decisions, gotchas, and unfinished tasks from a local index. CX Codex +1 ★ 50repo stars agent-memory Alireza Rezvani A four-tier memory ladder for Claude Code that promotes facts through recurrence across days instead of model confidence. ★ 30,251repo stars rekindle Skitchy rekindle — a local SQLite MCP server that assembles project context when a session starts and saves it before compaction. Useful when you keep re-explaining where you left off. CX Codex +1 ★ 5repo stars agentmemory-hooks rohitg00 The agentmemory-hooks skill uses lifecycle hooks to capture session observations automatically. It helps trace missing events and adjust which activity reaches local agentmemory storage. CX Codex +1 11,700installs

From the same set58

The whole set →
sweep-heat The sweep-heat Claude Code skill marks cold notes in the bottom 20 of HEAT_INDEX.md as dormant. Run it to inspect the heat index or change note statuses. CX Codex +1 ★ 26repo stars supersede The supersede Claude Code skill replaces outdated vault-note entries while retaining their history. The agent uses it for requests to update a note or mark a claim as no longer true. CX Codex +1 ★ 26repo stars Stuck The Stuck Claude Code skill guides an agent through possible next steps before it calls a task blocked. It activates when the agent runs out of ideas or is about to ask for help. CX Codex +1 ★ 26repo stars status The status Claude Code skill reports the current operating state of aigent-OS. Ask for a snapshot of its mode, objective, next action, or blockers. CX Codex +1 ★ 26repo stars sprite-spec This Claude Code skill turns pixel-art character ideas into sprite specifications. It activates for character or sprite-sheet design, covering palettes, proportions, and animation states. CX Codex +1 ★ 26repo stars solution-hunt The solution-hunt Claude Code skill finds legitimate alternatives when a task hits a blocker. It searches local notes and skills, then looks through GitHub and documentation. CX Codex +1 ★ 26repo stars skill-recall This Claude Code skill matches a task with local skills. Run /skill-recall to find candidates or record a gap when none fit. CX Codex +1 ★ 26repo stars skill-hunt The skill-hunt Claude Code skill finds skills that fill a capability gap. It ranks candidates, checks a selected skill, then installs it in quarantine. CX Codex +1 ★ 26repo stars

Project sponsors

Companies that keep this analytics open