setuplisted
Install: claude install-skill TomSchimana/Zanmai
# setup
First-time install. Steve runs this when the vault has no `zanmai/user.md`. The skill is invoked by reading this file and following the workflow below, it is not a slash command.
## Directive
This skill drives the dialogue. The deterministic state changes (folder creation, `zanmai/user.md` write) are done by `zanmai/system/scripts/zanmai.py setup init`. Do not write `zanmai/user.md` directly from the conversation. Use the script. The script is the single point of state change so future migrations can reason about what got written.
## When to use
- `zanmai/user.md` is missing.
- The user asks for an initial install or first run in their writing language.
- An older install needs to migrate to a new schema version, in which case the workflow calls `zanmai.py setup update`, not `init`.
## When not to use
- `zanmai/user.md` already exists and the schema is current. Refuse and tell the user.
- The user wants to add a single bundle. That is `import-bundle`, not setup.
- The user wants to rename folders. That is a manual operation, not in scope here.
## How to ask the user
Three modes:
- Structured choice with two to four options uses the `AskUserQuestion` form. Each option shows its own trade-off, the user picks one.
- Open text (name, email, free-form preference) uses an inline chat question.
- A trivial yes-or-no question with a sensible default does not get asked. Apply the default, mention it in one line if it might surprise the user, and let the user correct.