Interview
Runs a phased conversational interview across all PAI context files using InterviewScan.ts, which orders targets by PHASE and assigns conversation mode per file. Phase 1 (foundational TELOS) always runs first regardless of completeness: MISSION, GOALS, PROBLEMS, STRATEGIES, CHALLENGES, NARRATIVES, SPARKS, BELIEFS, WISDOM, MODELS, FRAMES in leverage order. Phase 2: IDEAL_STATE (HEALTH, MONEY, FREEDOM, RELATIONSHIPS, CREATIVE) in Fill mode. Phase 3: preferences (BOOKS, AUTHORS, BANDS, MOVIES, RESTAURANTS, FOOD_PREFERENCES, LEARNING, MEETUPS, CIVIC) in mixed mode. Phase 4: light touch on CURRENT_STATE/SNAPSHOT and PRINCIPAL_IDENTITY. Phase 9 (RHYTHMS) deferred. Review mode (≥80%) reads file then asks targeted questions one at a time — still accurate, outdated, missing, sharpen? Fill mode (<80%) walks scanner prompts one at a time. The principal answers in natural language; the DA formats into file structure. Voice confirms on actual changes only. Stop signals respected immediately. Target vs. north-star type confirmed per entry. Timestamped backup to TELOS/Backups/ before multi-edit at ≥50% of a file. TelosRenderer.ts regenerates PRINCIPAL_TELOS.md after foundational changes. USE WHEN /interview, resume interview, continue interview, start the interview, review TELOS, fill in context, what's missing in setup, conversational review, phased review, TELOS walkthrough, quarterly context refresh. NOT FOR single-file edits (use Telos Update workflow), intaking external content (use Migrate), identity edits (use _PROFILE).
What this skill does
# Interview — phased conversational context review + fill
## 🚨 MANDATORY: Voice Notification
Before running the workflow, send:
```bash
curl -s -X POST http://localhost:31337/notify \
-H "Content-Type: application/json" \
-d '{"message": "Starting the interview. Scanning phases first."}' \
> /dev/null 2>&1 &
```
## What this skill does
Runs a **phased conversational interview** across every PAI context file. Phase 1 (foundational TELOS) is the core — the DA always reviews it first, even if files look "complete," because foundational context is never actually done. Only after Phase 1 does the interview move to IDEAL_STATE dimensions, preferences, and identity.
### The phases
| Phase | Scope | Mode default |
|---|---|---|
| **Phase 1** | Foundational TELOS context — MISSION, GOALS, PROBLEMS, STRATEGIES, CHALLENGES, NARRATIVES, SPARKS, BELIEFS, WISDOM, MODELS, FRAMES | Review (files are typically already populated — surface updates/refinements) |
| **Phase 2** | IDEAL_STATE dimensions (minus RHYTHMS) — HEALTH, MONEY, FREEDOM, RELATIONSHIPS, CREATIVE | Fill (typically sparse — walk through prompts) |
| **Phase 3** | Preferences — BOOKS, AUTHORS, BANDS, MOVIES, RESTAURANTS, FOOD_PREFERENCES, LEARNING, MEETUPS, CIVIC | Mix — depends on completeness |
| **Phase 4** | CURRENT_STATE/SNAPSHOT + PRINCIPAL_IDENTITY | Light touch |
| **Phase 9** | Deferred — RHYTHMS (skipped in normal flow) | — |
### Review vs. Fill mode
- **Fill mode** (completeness < 80%): walk through the scanner's prompts, write answers to the file's structured slots.
- **Review mode** (completeness ≥ 80%): read the file contents to the principal first, then ask targeted questions — "Anything outdated? Anything missing? Sharpen or refine any of these?"
The scanner marks each target's mode based on completeness. The DA respects that mode in the conversation.
## Workflow
### Step 1 — Scan
Run the scanner to see phase breakdown and current state:
```bash
bun ~/.claude/PAI/TOOLS/InterviewScan.ts
```
The scanner orders items phase-first (Phase 1 always before Phase 2). Present the per-phase summary to the principal:
> "Your setup is 85% overall. Phase 1 foundational TELOS is at 100% — but every file is worth a review pass. Phase 2 IDEAL_STATE is at 59%. Phase 3 preferences mostly good except FOOD_PREFERENCES at 7%. Starting with Phase 1: MISSION. Ready?"
### Step 2 — Walk Phase 1 first
**Do not skip Phase 1.** Even if every foundational TELOS file scores 100%, walk through each in priority order. These files are never truly "done" — a quarterly review pass is what keeps them current.
Phase 1 order (by leverage): MISSION → GOALS → PROBLEMS → STRATEGIES → CHALLENGES → NARRATIVES → SPARKS → BELIEFS → WISDOM → MODELS → FRAMES.
For each file:
1. Get the per-file detail:
```bash
bun ~/.claude/PAI/TOOLS/InterviewScan.ts --file <NAME>
```
2. Check the mode:
- `REVIEW mode` (≥80% complete) → read the file contents to the principal first, then ask review questions
- `FILL mode` (<80% complete) → walk through the scanner's prompts
3. Run the conversation loop (below)
4. When the principal says "next" or "done with this one," move to the next Phase 1 file
### Step 3 — Conversation loop (per file)
**Review mode** (for Phase 1 files at ≥80%):
1. Read the file with the Read tool.
2. Summarize what's there to the principal in 2-3 sentences. No voice here — text only.
3. Ask targeted review questions ONE AT A TIME:
- "Is <specific item> still accurate?"
- "Anything outdated to retire?"
- "Any recent thinking that belongs here but isn't captured?"
- "Anything you'd sharpen, reframe, or expand?"
4. The principal answers by voice or text.
5. If the principal wants a change, the DA writes it via Edit tool — precise old_string/new_string, preserve surrounding structure.
6. Voice-confirm only on actual changes:
```bash
curl -s -X POST http://localhost:31337/notify \
-H "Content-Type: application/json" \
-d '{"message": "Updated <FILE> — captured the refinement."}' \
> /dev/null 2>&1 &
```
7. Ask: "Anything else for <FILE>, or move on?"
**Fill mode** (for files below 80%):
1. Ask the first scanner prompt — one at a time, never a firehose.
2. The principal answers (voice or typed).
3. The DA writes the answer into the correct slot in the file — replacing TBD markers, filling empty sections, appending items.
4. Voice-confirm what got captured.
5. Next prompt. Repeat until done with this file or the principal says "next."
### Step 4 — Phase transitions
After Phase 1 completes:
1. Voice: "Phase 1 done. Ready for Phase 2 IDEAL_STATE, or break here?"
2. If the principal says continue, proceed to Phase 2 top priority (usually HEALTH).
3. If the principal says stop, run final scan, voice a summary of what changed, say goodbye.
Same pattern Phase 2 → Phase 3 → Phase 4.
### Step 5 — Regenerate PRINCIPAL_TELOS.md
After foundational changes, regenerate the startup summary so future sessions pick up the updates:
```bash
bun ~/.claude/PAI/TOOLS/TelosRenderer.ts 2>/dev/null || true
```
## Rules
- **One question at a time.** Never dump all prompts at once.
- **The principal never types schema.** They speak/type the answer in their own words; the DA formats it into the file's structure.
- **Always show the principal what got written** before moving on. Brief voice + one line text.
- **Respect stop signals.** "Enough" / "stop" / "later" → save progress (state is already persistent in the files themselves), end gracefully.
- **Don't ask again about filled fields.** The scanner's completeness score decides what's still gap-worthy.
- **Narrative dimensions stay narrative.** For CREATIVE/RELATIONSHIPS, don't coerce answers into metrics — write prose that matches the principal's words.
- **Target/North-Star classification.** After writing a target's entries, ask once: "Is this a concrete achievable target, or a north-star orientation?" Update the `type:` field accordingly. (Default `target`.)
- **Back up before multi-edit.** If about to rewrite ≥50% of a file, save timestamped backup to `TELOS/Backups/FILENAME-YYYYMMDD-HHMMSS.md` first.
## Examples
### User: `/interview`
The DA runs InterviewScan, presents top 3 gaps, asks the principal to pick.
### User: `/interview --resume`
The DA runs scan (same as above — state is in the files themselves, no separate session to resume).
### User: `/interview health`
The DA skips the full scan, jumps straight to the IDEAL_STATE/HEALTH interview.
### User: "next area" (mid-interview)
The DA marks current section progress via file state (already saved by Edit tool), re-scans, asks the principal to pick next highest-priority or auto-continue.
## Related
- `/migrate` — intake content from other sources (not an interview, a one-shot classification)
- `/Telos` — edit a single TELOS file directly with backup
- `/_PROFILE` — manage PRINCIPAL_IDENTITY directly
Related in Image & Video
watch
IncludedWatch a video (URL or local path). Downloads with yt-dlp, extracts auto-scaled frames with ffmpeg, pulls the transcript from captions (or Whisper API fallback), and hands the result to Claude so it can answer questions about what's in the video.
physical-ai-defect-image-generation
IncludedUse when the user wants to orchestrate defect image generation, run associated setup, or handle outputs on OSMO. The Day 0 path handles cold-start with USD-to-ROI, image-edit augmentation, and AnomalyGen to create initial PCBA datasets. The Day 1 path performs inference and labeling on real images. This skill helps with first-time asset setup, creation of finetuning checkpoints, and configuring deployment. Trigger keywords: defect image generation, dig workflow, dig pipeline, defect image detection workflow, aoi pipeline, aoi anomalygen, usd2roi anomalygen, day 0 pcba, day 1 pcba, day 1 real-photo alignment, day 1 manual roi, metal surface anomaly, glass defect, anomalygen finetune, setup_pcb, setup_metal, setup_glass, setup_pretrained, dig setup, dig datasets, dig pretrained checkpoint, dig image-edit endpoint.
accelint-react-best-practices
IncludedReact performance optimization and best practices. ALWAYS use this skill when working with any React code - writing components, hooks, JSX; refactoring; optimizing re-renders, memoization, state management; reviewing for performance; fixing hydration mismatches; debugging infinite re-renders, stale closures, input focus loss, animations restarting; preventing remounting; implementing transitions, lazy initialization, effect dependencies. Even simple React tasks benefit from these patterns. Covers React 19+ (useEffectEvent, Activity, ref props). Triggers - useEffect, useState, useMemo, useCallback, memo, inline components, nested components, components inside components, re-render, performance, hydration, SSR, Next.js, useDeferredValue, combined hooks.
elevenlabs-agents
IncludedBuild conversational AI voice agents with ElevenLabs Platform using React, JavaScript, React Native, or Swift SDKs. Configure agents, tools (client/server/MCP), RAG knowledge bases, multi-voice, and Scribe real-time STT. Use when: building voice chat interfaces, implementing AI phone agents with Twilio, configuring agent workflows or tools, adding RAG knowledge bases, testing with CLI "agents as code", or troubleshooting deprecated @11labs packages, Android audio cutoff, CSP violations, dynamic variables, or WebRTC config. Keywords: ElevenLabs Agents, ElevenLabs voice agents, AI voice agents, conversational AI, @elevenlabs/react, @elevenlabs/client, @elevenlabs/react-native, @elevenlabs/elevenlabs-js, @elevenlabs/agents-cli, elevenlabs SDK, voice AI, TTS, text-to-speech, ASR, speech recognition, turn-taking model, WebRTC voice, WebSocket voice, ElevenLabs conversation, agent system prompt, agent tools, agent knowledge base, RAG voice agents, multi-voice agents, pronunciation dictionary, voice speed control, elevenlabs scribe, @11labs deprecated, Android audio cutoff, CSP violation elevenlabs, dynamic variables elevenlabs, case-sensitive tool names, webhook authentication
humanizer
IncludedHumanize AI-generated text by detecting and removing patterns typical of LLM output. Rewrites text to sound natural, specific, and human. Uses 28 pattern detectors, 560+ AI vocabulary terms across 3 tiers, and statistical analysis (burstiness, type-token ratio, readability) for comprehensive detection. Use when asked to humanize text, de-AI writing, make content sound more natural/human, review writing for AI patterns, score text for AI detection, or improve AI-generated drafts. Covers content, language, style, communication, and filler categories.
generating-mermaid-diagrams
IncludedSalesforce architecture diagrams using Mermaid with ASCII fallback. Use this skill when generating text-based diagrams for Salesforce architecture, OAuth flows, ERDs, integration sequences, or Agentforce structure. TRIGGER when: user says "diagram", "visualize", "ERD", or asks for sequence diagrams, flowcharts, class diagrams, or architecture visualizations in Mermaid. DO NOT TRIGGER when: user wants PNG/SVG image output (use generating-visual-diagrams), or asks about non-Salesforce systems.