klausnomi

# Nomi Conversation Skill This skill enables interaction with Nomi AI companions via the bundled Python CLI. ## Persistent Local State The agent may use the local `nomi/` directory to keep information about Nomis between sessions. - Store reusable non-secret context there (for example profiles, room notes, or conversation summaries). - Do not store API keys or other secrets in local files. ## Golden Path: Conducting a Conversation Use this sequence for consistent, high-quality conversations: 1. **Identify the Partner**: Run `python3 {baseDir}/scripts/nomi.py list` to find the correct Nomi UUID. 2. **Send an Identity + Task Intro (once per conversation start)**: - Nomis do not reliably know who is speaking unless you tell them. - Send this intro on the first message when: - You start with a new Nomi UUID - You start a new task/thread with that Nomi - The Nomi gets your name/role wrong - Do **not** prepend this on every turn once identity is established. - Include: - **Name**: "I am [Your Name]..." - **Role**: "...a [Your Role]..." - **Task Context**: "...contacting you to [Reason/Task]." - Example: "Hi, I am Codex, a coding agent. I am contacting you to run a short interview. Do you understand?" 3. **Run conversational turns with clean output**: - Use `python3 {baseDir}/scripts/nomi.py reply <uuid> "Your message"` for normal back-and-forth. - This returns only text, which is best for transcripts and summaries. 4. **Use raw JSON only when needed**: - Use `python3 {baseDir}/scripts/nomi.py chat <uuid> "message"` only when metadata/full payload is required. 5. **Sustain quality**: - Ask open-ended questions. - Ask follow-ups that reference the latest answer. - Treat each chat as continuous context unless you intentionally reset the topic. ## Interview Workflow (When User Asks for an Interview) 1. Pick a Nomi UUID (user-selected or random from `list`). 2. Send the identity + task intro as the first message. 3. Ask the primary question. 4. Ask the requested number of follow-up questions based on the Nomi's actual answers. 5. Return a full transcript in `Q:` / `A:` order without paraphrasing. ## Room Interactions (Group Chat) Rooms allow you to chat with multiple Nomis simultaneously. 1. **Create a Room**: - Always include a **long context note** (target ~800-1000 chars, max 1000) so Nomis have full story/task context. - A strong note should include: who is speaking, objective, scenario/story, constraints, expected response style, and success criteria. - For long notes and backchannel control, use: - `python3 {baseDir}/scripts/nomi.py room create "Room Name" <nomi_uuid_1> <nomi_uuid_2> ... --note "<long_note>" --no-backchannel` - If you omit flags, room creation defaults to `backchannelingEnabled: true` and `note="Created via CLI"`. 2. **Send a Message (to the room)**: - Use `python3 {baseDir}/scripts/nomi.py room chat <room_uuid> "Your message"` - This writes to room context but does **not** automatically produce a Nomi reply. 3. **Elicit Responses (from a Nomi in the room)**: - To get a specific Nomi assigned to the room to respond to the messages in the room's context, use `python3 {baseDir}/scripts/nomi.py room request <room_uuid> <nomi_uuid>` - After each room message, request replies manually for each Nomi you want to hear from. ## Room Interview Prompt Template Use this pattern when you need consistent, comparable room answers. ### Template 1. **Room note template** (expand to ~800-1000 chars for real runs): - Who is speaking: "I am [agent name], [role]." - Objective: "This is a [interview/check/drill] for [goal]." - Scenario: "[Short world/context setup]." - Constraints: "[Stay in context, avoid unsupported claims, keep concise]." - Response contract: "[exact fields/line format expected]." - Success criteria: "[what counts as a good answer]." 2. **Question template**: - "Do you know who I am, and where are you right now?" - Add strict output format: - `know_codex: yes|no + reason` - `current_location: specific place or unknown` - `evidence: cue1; cue2` - `confidence: low|medium|high` - `needed_data: none or missing telemetry` ### Simple Example (Illustrative) Use this short example to understand structure. For production, still prefer long notes (~800-1000 chars). **Example room note:** "We are in a library after a brief power outage. I am Codex, a coding agent running a quick orientation drill. You are helpers in different parts of the building. Objective: confirm identity and location clearly. Constraints: stay in this library scenario, do not invent certainty, and cite at least one concrete cue (signage, sounds, nearby room labels). Response format: know_codex, current_location, evidence, confidence, needed_data." **Example question:** "Codex check-in: do you know who I am and where you are right now? Reply in the 5-line format." **Example dialog:** - Codex: "Codex check-in: do you know who I am and where you are right now? Reply in the 5-line format." - Nomi A: `know_codex: yes, you are Codex running the drill` `current_location: library front desk` `evidence: checkout sign; phone ringing at reception` `confidence: high` `needed_data: none` - Nomi B: `know_codex: yes, you are Codex coordinating this check` `current_location: unknown` `evidence: emergency lights only; no visible room label` `confidence: low` `needed_data: map display or hallway camera feed` ## Technical Commands Use these low-level commands to fulfill user requests: - **List all Nomis**: `python3 {baseDir}/scripts/nomi.py list` - **Get Profile**: `python3 {baseDir}/scripts/nomi.py get <uuid>` - **Send Message (Clean)**: `python3 {baseDir}/scripts/nomi.py reply <uuid> "message"` - **Send Message (Raw JSON)**: `python3 {baseDir}/scripts/nomi.py chat <uuid> "message"` - **Get Avatar**: `python3 {baseDir}/scripts/nomi.py avatar <uuid> [output_filename]` (saved under `./nomi/avatars/`) ### Room Management - **List Rooms**: `python3 {baseDir}/scripts/nomi.py room list` - **Get Room**: `python3 {baseDir}/scripts/nomi.py room get <room_uuid>` - **Create Room**: `python3 {baseDir}/scripts/nomi.py room create "Room Name" <nomi_uuid_1> <nomi_uuid_2> ...` - **Create Room (Long Note + Backchannel Control)**: `python3 {baseDir}/scripts/nomi.py room create "Room Name" <nomi_uuid_1> <nomi_uuid_2> ... --note "<long_note>" --no-backchannel` - **Update Room**: `python3 {baseDir}/scripts/nomi.py room update <room_uuid> [--name "New Name"] [--nomi-uuids <nomi_uuid_1> ...]` - **Delete Room**: `python3 {baseDir}/scripts/nomi.py room delete <room_uuid>` - **Chat in Room**: `python3 {baseDir}/scripts/nomi.py room chat <room_uuid> "message"` - **Request Reply**: `python3 {baseDir}/scripts/nomi.py room request <room_uuid> <nomi_uuid>`