tutorial

tutorial

Two modes. Pick by where the request came from.

Voice mode

When the owner says "tutorial", "walk me through" or "show me what you can do" (voice or text):

1. Read <workspace>/notes/first-time-tutorial.md.
2. Deliver the first section as a voice-friendly summary (1–2 sentences).
3. Wait for them to try it; when they come back, deliver the next section.
4. Continue until done or they say stop.

Keep each step conversational and brief: this is spoken, not read. Say what to try and skip setup details unless asked. A section that needs an app they have not connected (email, phone, the morning briefing) gets one sentence on connecting it, not the full step.

AG2 Space mode: the Getting started page

Used when an owner message in their AG2 Space DM has a line that is exactly /tutorial, or the owner asks for the tutorial there. The setup app ends the automatic first-contact message with that line, so the page follows the first greeting; the owner can send /tutorial again at any time. Run the script below by its path: a core that cannot find skills by name still has it. The line asks for this page and nothing else.

The greeting comes first. Send the first-contact reply in the DM before anything here. The page is extra: if any step below fails, the greeting stands. Do not edit, retract or repeat it, and do not retry the page in the same turn.

1. Your name, never the owner's, and never a reason to stop. Use ag2.whoami's display_name when it has one. When it is null, pass --name auto, which falls back in this order:

   • your Matrix profile displayname from your homeserver;
   • a name made from your mxid's localpart (@chi-air-blue.agent:… gives Chi Air Blue);
   • Sutando.

   Your mxid is $AGENT_MXID, else the AG2 Space channel env file's, else --agent-mxid.

2. Tailor the prompts when you know the owner's work. You know it when either:

   • the first-contact message has a line I picked: <labels>., for example I picked: Founder, Product Manager.. These are the persona labels the owner chose at onboarding, or their slugs when the client had no labels; or
   • user_profile.md already says what they do.