New: 98,000+ skills indexed from GitHub repos with 100+ stars · every skill safety-checkedBrowse top skillsTop skills
Esc to closeBrowse all skills
Submit a skillBrowse skills
Submit a skillBrowse skills

Agent skill

Formax Surface Reset Workflow

by yusifeng in yusifeng/formax

A skill your agent uses when changing REPL clear/reset/resume/surface behavior (onClearTerminal, transcriptSeq remount, Ink Static paths, Ctrl+O/Ctrl+E transitions).

MITAuto-check passed

Install Formax Surface Reset Workflow

skills CLI
$ npx skills add yusifeng/formax --skill formax-surface-reset-workflow -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install yusifeng/formax formax-surface-reset-workflow --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/yusifeng/formax.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.codex/skills/formax-surface-reset-workflow .claude/skills/formax-surface-reset-workflow && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
formax-surface-reset-workflow
GitHub stars
195
Token cost
~861 tokens
SKILL.md length
266 words
Files
1
Skills in repo
21
Repo updated
First seen
Licence
MIT

At a glance

A skill your agent uses when changing REPL clear/reset/resume/surface behavior (onClearTerminal, transcriptSeq remount, Ink Static paths, Ctrl+O/Ctrl+E transitions).

  • Works in 5 steps: Identify the exact path (/resume,… → Route it through replaceTranscript /… → Treat reset as one transaction, not… → …
  • Changing REPL clear/reset/resume/surface behavior (onClearTerminal
  • SKILL.md covers Goal, Read First, Code Map and Trigger Conditions, plus 4 more sections
  • Calls bun

What it does

Formax Surface Reset Workflow is an agent skill from yusifeng/formax. Use when changing REPL clear/reset/resume/surface behavior (onClearTerminal, transcriptSeq remount, Ink Static paths, Ctrl+O/Ctrl+E transitions). Enforces single-owner reset transaction and prevents black-screen/flicker/duplicate-row regressions.

Its SKILL.md is about 860 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

The repository describes itself as: Terminal-first AI assistant for software engineering tasks (inspired by Claude Code v2.0.67). The licence is MIT.

When your agent uses it

  • Changing REPL clear/reset/resume/surface behavior (onClearTerminal
  • TranscriptSeq remount
  • Ink Static paths
  • Ctrl+O/Ctrl+E transitions)

Example prompts

  • “/formax-surface-reset-workflow”

Workflow steps

5 steps, taken from the first numbered list in SKILL.md.

  1. Identify the exact path (/resume, /clear, Ctrl+O / Ctrl+E, compact boundary, etc.).
  2. Route it through replaceTranscript / resetTranscriptSurface instead of local clear / remount sequencing.
  3. Treat reset as one transaction, not scattered side effects.
  4. Add or extend regression tests for ordering and surface reset ownership.
  5. Run the minimum regression set below and at least one real surface smoke path.

What it can do on your machine

Read from SKILL.md and the folder at commit 1b0c3f3. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • bun

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Formax Surface Reset Workflow loads about 861 tokens when it runs. Until then it costs about 69 tokens; SKILL.md has 266 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~69
When it runs · the whole SKILL.md, loaded when a task matches
~861

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from yusifeng/formax at commit 1b0c3f3, republished under its MIT licence (© yusifeng). 266 words, ~861 tokens.

Download SKILL.mdSave it as .claude/skills/formax-surface-reset-workflow/SKILL.md (or your agent's skills folder).
name
formax-surface-reset-workflow
description
Use when changing REPL clear/reset/resume/surface behavior (onClearTerminal, transcriptSeq remount, Ink Static paths, Ctrl+O/Ctrl+E transitions). Enforces single-owner reset transaction and prevents black-screen/flicker/duplicate-row regressions.

Formax Surface Reset Workflow

Goal

Use this skill when changing REPL clear/reset/resume behavior or any transcript surface transition that can remount Static.

Read First

  • docs/contracts/transcript-surface-contract.md
  • docs/runbooks/repl-surface-debugging.md
  • docs/contracts/invariants.md when ownership or sequencing is unclear

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

Code Map

  • Reset helpers / queue owner:
    • replaceTranscript
    • queueTranscriptSurfaceReplace
    • resetTranscriptSurface
    • queueTranscriptSurfaceReset
    • surfaceOpQueueRef
  • High-risk flows:
    • packages/core/src/features/repl/controller/ui/
    • packages/core/src/features/repl/controller/session/
    • packages/core/src/features/repl/useReplController.ts
    • packages/core/src/screens/repl/
    • packages/core/src/runtime/bootstrap/runLegacyCli.tsx
  • Call sites to watch:
    • onClearTerminal
    • clearTerminal
    • resetInkStaticOutputForStdout
    • transcriptSeq remount behavior in ReplTranscript / ExpandedReplTranscript

Trigger Conditions

Use this skill whenever the change touches any of:

  • /resume, /clear, compact boundary transitions
  • Ctrl+O / Ctrl+E transcript view switches
  • onClearTerminal, clearTerminal, or resetInkStaticOutputForStdout
  • replaceTranscript, queueTranscriptSurfaceReplace, resetTranscriptSurface, queueTranscriptSurfaceReset, or surfaceOpQueueRef
  • files under packages/core/src/features/repl/controller/ui/, packages/core/src/features/repl/controller/session/, packages/core/src/features/repl/useReplController.ts, packages/core/src/screens/repl/, or packages/core/src/runtime/bootstrap/runLegacyCli.tsx

Minimal Workflow

  1. Identify the exact path (/resume, /clear, Ctrl+O / Ctrl+E, compact boundary, etc.).
  2. Route it through replaceTranscript / resetTranscriptSurface instead of local clear / remount sequencing.
  3. Treat reset as one transaction, not scattered side effects.
  4. Add or extend regression tests for ordering and surface reset ownership.
  5. Run the minimum regression set below and at least one real surface smoke path.

Minimum Regression

  • bun run test -- packages/core/src/features/repl/controller/ui/surfaceReset.test.ts
  • bun run test -- packages/core/src/features/repl/useReplController.test.tsx -t "resume|clear|compact"
  • bun run test -- packages/core/src/screens/repl/surfaceSmoke.test.tsx
  • bun run type-check
  • If change touches compact / expanded toggles broadly: bun run test:surface-screen-model

Guardrails

  • Keep one surface owner; do not add a second independent clear / remount path.
  • Do not stack replInstance.clear() and ANSI clear in legacy paths unless ownership is explicit and serialized.
  • Do not accept a Vitest-only fix without running a real surface smoke path.

References

  • docs/pitfalls/summary.md sections covering /clear, compact + Ctrl+O, and resume black-screen regressions
  • docs/pitfalls/repl-transcript-surface-handoff-pitfall.md
  • docs/pitfalls/repl-transcript-static-rootcause.md

© yusifeng, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in .codex/skills/formax-surface-reset-workflow of yusifeng/formax.

Open the folder on GitHubat commit 1b0c3f3

Compare with similar skills

Formax Surface Reset Workflow next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Formax Surface Reset Workflow compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Formax Surface Reset Workflow this skillyusifeng/formax195—~861Automated safety check: PassMIT
Reactive Resume Builderreactive-resume/reactive-resume44k—~1.5kAutomated safety check: PassMIT
Nanoclaw Replaffaan-m/ECC276k4 repos~286Automated safety check: PassMIT
Resume Version Managerdavila7/claude-code-templates32k2 repos~2.1kAutomated safety check: PassMIT
Resume Modernnexu-io/open-design100k—~398Automated safety check: PassApache-2.0
Make Changesremix-run/remix33k—~2.4kAutomated safety check: PassMIT

Similar skills

  • Reactive Resume Builder

    reactive-resume/reactive-resume

    Builds resumes as valid JSON for the open-source Reactive Resume app by interviewing you, and can track job applications through its MCP tools.

    44k GitHub stars~1.5k tokensUpdated today
    Business, Finance & HRAuto-check passed

  • Nanoclaw Repl

    affaan-m/ECC

    Operate and extend NanoClaw, ECC's zero-dependency session-aware REPL, with persistent markdown-backed sessions and slash commands for model switching, skill loading, session branching…

    276k GitHub starsUsed in 4 repos~286 tokens
    Agent WorkflowsAuto-check passed

  • Resume Version Manager

    davila7/claude-code-templates

    Track different resume versions, maintain a master resume, and manage tailored variants.

    32k GitHub starsUsed in 2 repos~2.1k tokens
    Business, Finance & HRAuto-check passed

  • Resume Modern

    nexu-io/open-design

    Modern minimal resume, single A4 page, ready for print or PDF export.

    100k GitHub stars~398 tokensUpdated today
    Documents & OfficeAuto-check passed

  • Make Changes

    remix-run/remix

    Create or update Remix repo change files under packages//.changes.

    33k GitHub stars~2.4k tokensUpdated today
    DevelopmentAuto-check passed

  • Tech Resume Optimizer

    davila7/claude-code-templates

    Optimize resumes for software engineering, product management, and technical roles.

    32k GitHub starsUsed in 1 repo~2.7k tokens
    Business, Finance & HRAuto-check passed

More from yusifeng/formax

All 21 skills in this repo

  • Formax Repomix Handoff Workflow

    yusifeng/formax

    A skill your agent uses when preparing a Formax code handoff: selecting files, generating repomix bundles, and writing a high-quality prompt for WebGPT or another coding agent with clear constraints…

    195 GitHub stars~1.2k tokensUpdated 2 mo ago
    Auto-check passed

  • Formax Skill Capture

    yusifeng/formax

    A skill your agent uses when we want to turn a just-finished Formax workflow (e.g.

    195 GitHub stars~530 tokensUpdated 2 mo ago
    Auto-check passed

  • Analyze Task

    yusifeng/formax

    A skill your agent uses when a Formax repository task is non-trivial and you should analyze goals, non-goals, boundaries, data/type/interface impact, contract impact, test strategy, and whether an…

    195 GitHub stars~1.2k tokensUpdated 2 mo ago
    Auto-check passed

  • Formax Dev Loop Workflow

    yusifeng/formax

    A skill your agent uses when working on Formax code changes and you need a disciplined dev loop: keep a single mainline task, avoid scope drift, run only targeted tests (no coverage), avoid partial…

    195 GitHub stars~686 tokensUpdated 2 mo ago
    Auto-check passed

  • Formax Tool UI Blocks Workflow

    yusifeng/formax

    Implement or refactor Formax tool transcript UI using the Tool UI Blocks (C-lite) pattern (ToolUiBlocks renderer + blocks presenters) to avoid touching many tool presenter files; use when adjusting…

    195 GitHub stars~1.3k tokensUpdated 2 mo ago
    Auto-check passed

  • Formax Semantics Parity Workflow

    yusifeng/formax

    A skill your agent uses when implementing or modifying behavior that must stay consistent across TUI and Web (mode/input/tool/replay/order).

    195 GitHub stars~1.1k tokensUpdated 2 mo ago
    Auto-check passed

Questions about Formax Surface Reset Workflow

What does Formax Surface Reset Workflow do?

A skill your agent uses when changing REPL clear/reset/resume/surface behavior (onClearTerminal, transcriptSeq remount, Ink Static paths, Ctrl+O/Ctrl+E transitions). Formax Surface Reset Workflow is an agent skill from yusifeng/formax. Use when changing REPL clear/reset/resume/surface behavior (onClearTerminal, transcriptSeq remount, Ink Static paths, Ctrl+O/Ctrl+E transitions).

When should I use Formax Surface Reset Workflow?

Formax Surface Reset Workflow fits situations like: changing REPL clear/reset/resume/surface behavior (onClearTerminal; transcriptSeq remount; ink Static paths; ctrl+O/Ctrl+E transitions).

How do I install Formax Surface Reset Workflow in Claude Code?

Run `npx skills add yusifeng/formax --skill formax-surface-reset-workflow -a claude-code`. Or copy the skill folder (.codex/skills/formax-surface-reset-workflow in yusifeng/formax) into .claude/skills/formax-surface-reset-workflow in your project. Claude Code loads it when a task matches its description.

How do I install Formax Surface Reset Workflow in Codex?

Run `npx skills add yusifeng/formax --skill formax-surface-reset-workflow -a codex`. Or copy the skill folder (.codex/skills/formax-surface-reset-workflow in yusifeng/formax) into .agents/skills/formax-surface-reset-workflow in your project. Codex loads it when a task matches its description.

Can I use Formax Surface Reset Workflow in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add yusifeng/formax --skill formax-surface-reset-workflow -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/formax-surface-reset-workflow, .gemini/skills/formax-surface-reset-workflow, .github/skills/formax-surface-reset-workflow and .opencode/skills/formax-surface-reset-workflow in your project.

What does Formax Surface Reset Workflow need to run?

Going by SKILL.md and its folder, Formax Surface Reset Workflow needs the command-line tools its instructions call (bun).

Does Formax Surface Reset Workflow access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Formax Surface Reset Workflow safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Formax Surface Reset Workflow use?

Formax Surface Reset Workflow is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Formax Surface Reset Workflow use?

About 861 tokens (SKILL.md is roughly 3.4k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Formax Surface Reset Workflow?

Skills that share tags, products or a category with Formax Surface Reset Workflow: Reactive Resume Builder (reactive-resume/reactive-resume, 44k stars), Nanoclaw Repl (affaan-m/ECC, 276k stars), Resume Version Manager (davila7/claude-code-templates, 32k stars) and Resume Modern (nexu-io/open-design, 100k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Formax Surface Reset Workflow?

yusifeng (a GitHub user) maintains it in yusifeng/formax, which has 195 GitHub stars. The repository holds 21 skills in this directory. The repository was last updated on July 24, 2026.

Source: yusifeng/formax on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.