SkillsAdd

smithery.ai

formax-expanded-transcript-workflow

Use when implementing/debugging Ctrl+O Expanded Transcript (second view) and thinking persistence in the REPL.

First seen Apr 17, 2026

Installation

$ npx skills add https://smithery.ai
View on skills.sh ↗ Website ↗

Similar popular skills

Related neighbors and high-traction skills in the same topics — useful to compare before installing.

agent-browser Shared topics
vercel-labs/agent-browser

Browser automation CLI for AI agents. Use when the user needs to interact with websites, includ…

810.4K installs
azure-aigateway Shared topics
microsoft/azure-skills

Configure Azure API Management as an AI Gateway for AI models, MCP tools, and agents. WHEN: sem…

566.3K installs
azure-compute Shared topics
microsoft/azure-skills

Azure VM/VMSS router. WHEN: create / provision / deploy / spin-up VM, recommend VM size, compar…

510K installs
supabase-postgres-best-practices Shared topics
supabase/agent-skills

Postgres best practices maintained by Supabase, for Postgres running anywhere. Load this skill …

391.6K installs
prisma-cli Shared topics
prisma/skills

Prisma ORM CLI commands reference covering init, generate, migrate, db, dev, complete, studio, …

267K installs
supabase Shared topics
supabase/agent-skills

Use when doing ANY task involving Supabase. Triggers: Supabase products (Database, Auth, Edge F…

263K installs

Also in this package

Other skills from smithery.ai · top by installs.

npx skills add https://smithery.ai
smithery-ai-cli 7.8K frontend-design 6.2K skill-creator 2.5K ck:ui-ux-pro-max 1.3K pdf 1.2K xlsx 966 pptx 894 docx 884 webapp-testing 1 web-design-reviewer 657

Browse all from smithery.ai

More details

Agent compatibility

Declared targets from SKILL.md / docs. Unmarked agents are not listed — the skill may still install via the CLI.

Claude Code Not declared
Cursor Not declared
Codex Not declared
GitHub Copilot Not declared
Windsurf Not declared
Gemini CLI Not declared
Cline Not declared
OpenCode Not declared

Package contents

Files included with this skill beyond the listing page.

  • skill md SKILL.md 3,263 B
  • docs SUMMARY.md 153 B

History

  1. First seen on skills.sh
  2. First recorded snapshot · 1 installs

SKILL.md

formax-expanded-transcript-workflow

Goal

Use this skill when changing Ctrl+O expanded transcript behavior, thinking persistence, or compact / expanded projection boundaries in the REPL.

Read First

  • docs/contracts/transcript-surface-contract.md
  • docs/contracts/semantics-contract.md
  • docs/runbooks/repl-surface-debugging.md when the change can affect clear / remount behavior

These docs are canonical. If stable expanded-transcript behavior changes, update them before or with code.

If the change touches clear / remount ownership directly, also use formax-surface-reset-workflow.

Code Map

  • Key handling: packages/core/src/screens/repl/hotkeys.ts
  • View wiring + footer: packages/core/src/screens/REPL.tsx
  • Compact projection: packages/core/src/screens/repl/compactProjection.ts
  • Transcript rendering: packages/core/src/screens/repl/transcript.tsx
  • Thinking persistence: packages/core/src/features/repl/controller/streaming/streaming.ts
  • Expanded Transcript panels: packages/core/src/screens/repl/panels.tsx
  • Compact command lifecycle: packages/core/src/features/repl/controller/send/send.ts
  • Surface reset owner: packages/core/src/screens/repl/useSurfaceTransitionManager.ts

High-Signal Patterns

  • No fake thinking:

- thinking_delta is the only source of truth - never synthesize thinking rows from timers or summaries

  • Avoid Static hacks for toggles:

- Static is append-only; if content must disappear, use reset / remount ownership instead of trying to "unrender" it

  • One footer:

- prefer a single global footer; avoid per-panel footer duplication

  • Compact ordering contract:

- keep banner -> summary (expanded only) -> > /compact ... -> compact subline

  • UI vs LLM orthogonality:

- transcript slicing and ui.kind remain independent from prompt-history packing and reminder injection

Minimal Workflow

  1. Lock the semantic source first: thinking_delta persistence and transcript projection rules before renderer polish.
  2. Keep default transcript low-noise and Expanded Transcript read-only.
  3. Preserve compact / expanded ordering before adjusting footer or panel layout.
  4. If clear / remount logic changes, route through the shared surface reset path instead of local Static workarounds.
  5. Run the regression set below before review.

Minimum Regression

  • bun run test -- packages/core/src/screens/repl/compactProjection.test.ts packages/core/src/screens/repl/expandedTranscript.test.tsx packages/core/src/screens/repl/hotkeys.test.tsx
  • bun run test -- packages/core/src/screens/repl/surfaceSmoke.test.tsx
  • bun run test:surface-screen-model
  • bun run type-check

Guardrails

  • Do not introduce synthetic thinking or show thinking when the model did not emit thinking_delta.
  • Do not let Ctrl+O steal input while prompt mode or overlays are active.
  • Do not move header / messages outside Static to “fix” duplication; solve ownership and remount boundaries instead.
  • Expanded Transcript stays read-only; do not quietly turn it into an interactive input surface.