skills.rest
yusifeng
yusifengCOMMUNITY
Explore all skills by this author →
GitHub

formax-surface-reset-workflow

Centralize REPL clear, reset, resume, and surface transitions into single-owner transactions.

192|7|Updated Dec 30, 2025
Search Tags:#workflow#transcript#debugging#repl#guardrails#reset#surface
One-click install
npx skills add https://github.com/yusifeng/formax --skill formax-surface-reset-workflow
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: formax-surface-reset-workflow
Source: https://github.com/yusifeng/formax/tree/main/.codex/skills/formax-surface-reset-workflow
Command: npx skills add https://github.com/yusifeng/formax --skill formax-surface-reset-workflow

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Improve REPL reliability by centralizing clear/reset/resume/surface transitions to prevent black screens, flicker, or duplicate rows.

Core Features & Use Cases

  • Route REPL surface changes through a single-owner reset transaction
  • Enforce deterministic remount behavior of transcript surfaces
  • Guard against overlapping clear paths and UI regressions

Quick Start

Run this skill to enforce a stable REPL surface during resets, then route changes through the prescribed reset flow.

Frequently Asked Questions about formax-surface-reset-workflow

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I fix REPL black screens and flicker during surface resets?▼

Centralize clear/reset/resume transitions through a single-owner reset transaction to prevent REPL black screens and flicker. This enforces deterministic remount behavior for transcript surfaces and guards against overlapping clear paths that cause UI regressions.

What causes duplicate rows in the REPL transcript surface?▼

Duplicate rows in the REPL transcript surface occur from overlapping clear paths during transitions. Routing changes through a single transaction workflow via replaceTranscript and resetTranscriptSurface eliminates conflicting clear operations.

How do I stabilize Ctrl+O and Ctrl+E transitions in the REPL UI?▼

Stabilize Ctrl+O and Ctrl+E transitions by routing them through a prescribed reset flow enforcing deterministic surface remount behavior. This centralizes transition logic and includes regression tests to prevent UI flicker.

Do I need to modify packages/core to improve REPL reset reliability?▼

Improving REPL reset reliability involves referencing core runtime files under packages/core related to the REPL surface. The workflow applies changes affecting transcript surfaces and Ink Static paths to ensure stable transitions.

What is the best way to handle REPL transcript surface remounts?▼

The best way to handle REPL transcript surface remounts is enforcing a single transaction workflow using replaceTranscript and resetTranscriptSurface. This deterministic approach includes guardrails preventing overlapping clear paths and UI regressions.

Why does my REPL UI flicker when switching transcript surfaces?▼

REPL UI flicker during surface switching happens when clear and reset operations overlap. Centralizing transitions into a single-owner reset transaction with guardrails prevents the conflicting paths causing visual instability.

Related Skills

Explore More Software Engineering Skills→
nexus-a1nexus-a1

refactor

Analyzes multi-language codebases to propose non-destructive refactoring opportunities.

Community
Advanced
yusifengyusifeng
192

formax-expanded-transcript-workflow

Enforce contracts for thinking_delta persistence and panel wiring in the REPL.

Community
Advanced
zyj18860969891-bytezyj18860969891-byte

taskflow-inbox-triage

Route inbox items to Slack posts, owner notifications, or end-of-day summaries.

Community
Intermediate
rpamisrpamis
2.7k

comet-hotfix

Automates bug-fix workflows from build through verify and archive phases.

Official
Advanced