Agent skill

Formax Rework Convergence Workflow

by yusifeng in yusifeng/formax

A skill your agent uses when code has gone through repeated rework and may contain redundant logic, style drift, or tangled structure.

MITAuto-check passed

Install Formax Rework Convergence Workflow

skills CLI
$ npx skills add yusifeng/formax --skill formax-rework-convergence-workflow -a claude-code

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

GitHub CLI
$ gh skill install yusifeng/formax formax-rework-convergence-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-rework-convergence-workflow .claude/skills/formax-rework-convergence-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-rework-convergence-workflow
GitHub stars
194
Token cost
~638 tokens
SKILL.md length
298 words
Files
1
Skills in repo
21
Repo updated
First seen
Licence
MIT

At a glance

A skill your agent uses when code has gone through repeated rework and may contain redundant logic, style drift, or tangled structure.

  • Works in 4 steps: No feature expansion during convergence. → No broad redesign unless user explicitly… → Prefer local cleanup in touched files… → …
  • Code has gone through repeated rework and may contain redundant logic
  • SKILL.md covers Purpose, Trigger Phrases, Scope Rules and Workflow, plus 2 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Formax Rework Convergence Workflow is an agent skill from yusifeng/formax. Use when code has gone through repeated rework and may contain redundant logic, style drift, or tangled structure. Trigger when user asks for "返工收敛", "cleanup-pass", or requests a focused cleanup pass that reduces churn without changing behavior.

Its SKILL.md is about 640 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

  • Code has gone through repeated rework and may contain redundant logic
  • Tangled structure
  • User asks for 返工收敛
  • Requests a focused cleanup pass that reduces churn without changing behavior

Example prompts

  • “cleanup-pass”
  • “/formax-rework-convergence-workflow”

Workflow steps

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

  1. No feature expansion during convergence.
  2. No broad redesign unless user explicitly asks.
  3. Prefer local cleanup in touched files first.
  4. Preserve existing runtime behavior and UI semantics.

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

    No scripts in the folder and no shell commands in SKILL.md.

    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 Rework Convergence Workflow loads about 638 tokens when it runs. Until then it costs about 70 tokens; SKILL.md has 298 words of instructions outside code blocks.

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

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). 298 words, ~638 tokens.

Download SKILL.mdSave it as .claude/skills/formax-rework-convergence-workflow/SKILL.md (or your agent's skills folder).
name
formax-rework-convergence-workflow
description
Use when code has gone through repeated rework and may contain redundant logic, style drift, or tangled structure. Trigger when user asks for "返工收敛", "cleanup-pass", or requests a focused cleanup pass that reduces churn without changing behavior.

Formax Rework Convergence Workflow

Purpose

Use this workflow to clean up code after multiple back-and-forth edits.

Primary goal:

  • Reduce redundancy
  • Restore structure clarity
  • Keep behavior unchanged unless user explicitly asks for behavior changes

Trigger Phrases

Run this skill when the user says:

  • 返工收敛 (recommended keyword)
  • cleanup-pass
  • "帮我收敛一下这波改动"
  • "把返工后冗余代码清掉"

Scope Rules

  1. No feature expansion during convergence.
  2. No broad redesign unless user explicitly asks.
  3. Prefer local cleanup in touched files first.
  4. Preserve existing runtime behavior and UI semantics.

Workflow

  1. Freeze Intent
  • Restate the target in one sentence.
  • Identify "must keep" behavior before editing.
  1. Build Cleanup Map
  • Inspect current diff and touched files.
  • Group issues into:
    • duplicate logic
    • dead code / unreachable branches
    • conflicting style patterns
    • state ownership confusion
    • temporary patches that became permanent
  1. Rank by Risk and Value
  • High priority:
    • behavior-risky duplication
    • conflicting state sources
    • repeated conditional branches causing drift
  • Medium priority:
    • naming inconsistencies
    • repeated style tokens/classes
  • Low priority:
    • cosmetic micro-cleanups
  1. Apply Minimal Convergence Edits
  • Collapse duplicated branches into one shared path.
  • Remove dead paths only when replacement path is verified.
  • Keep interfaces stable.
  • Keep patch size small and reviewable.
  1. Validate
  • Run targeted type-check/tests for changed scope.
  • If UI is touched, do a quick manual visual sanity check path.
  • If validation is blocked, report the exact blocker and impact.
  1. Report Back in Convergence Format
  • what was removed
  • what was unified
  • what behavior stayed the same
  • residual risks

Guardrails

  • Do not hide uncertainty: explicitly call out assumptions.
  • Do not ship "temporary fixes" silently.
  • If a temporary mitigation is unavoidable, mark it and define removal conditions.
  • Never mix unrelated cleanup in the same pass.

Output Template

Use this structure in responses:

  1. Convergence summary (2-4 lines)
  2. Redundancy removed
  3. Structure unified
  4. Behavior parity check
  5. Risks and next small pass (optional)

© 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-rework-convergence-workflow of yusifeng/formax.

Open the folder on GitHubat commit 1b0c3f3

Compare with similar skills

Formax Rework Convergence 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 Rework Convergence Workflow compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Formax Rework Convergence Workflow this skillyusifeng/formax194—~638Automated safety check: PassMIT
Convergenceparcadei/Continuous-Claude-v33.9k1 repos~316Automated safety check: NotesMIT
Convergence StudyFreedomIntelligence/OpenClaw-Medical-Skills3.1k1 repos~1.1kAutomated safety check: NotesNone
Gsd Plan Review Convergenceopen-gsd/gsd-core10k1 repos~1kAutomated safety check: NotesMIT
Convergence Monitoringhashgraph-online/awesome-codex-plugins1.3k—~4.2kAutomated safety check: PassApache-2.0
Clean Gone Branchesfcakyon/claude-codex-settings1.2k—~237Automated safety check: PassApache-2.0

Similar skills

  • Convergence

    parcadei/Continuous-Claude-v3

    Problem-solving strategies for convergence in real analysis. An agent skill from parcadei/Continuous-Claude-v3.

    3.9k GitHub starsUsed in 1 repo~316 tokens
    Research & ScienceAuto-check: notes
  • Convergence Study

    FreedomIntelligence/OpenClaw-Medical-Skills

    Spatial and temporal convergence analysis with Richardson extrapolation and Grid Convergence Index (GCI) for solution verification

    3.1k GitHub starsUsed in 1 repo~1.1k tokens
    Auto-check: notes
  • Cross-AI plan convergence - replan until review concerns are resolved.

    10k GitHub starsUsed in 1 repo~1k tokens
    Auto-check: notes
  • Convergence Monitoring

    hashgraph-online/awesome-codex-plugins

    Detecting whether agent iterations are converging toward a stable solution or hitting a ceiling.

    1.3k GitHub stars~4.2k tokensUpdated yesterday
    Auto-check passed
  • Clean Gone Branches

    fcakyon/claude-codex-settings

    This skill should be used when user asks to "clean gone branches", "remove deleted local branches", "prune branches removed from remote", or explicitly invokes "clean-gone-branches".

    1.2k GitHub stars~237 tokensUpdated 2 days ago
    DevelopmentAuto-check passed
  • Repeat

    softspark/ai-toolkit

    Runs prompt/slash command on recurring interval until done or limit.

    179 GitHub stars~1.2k tokensUpdated 3 days ago
    Agent WorkflowsAuto-check: notes

More from yusifeng/formax

All 21 skills in this repo
  • 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…

    194 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.

    194 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…

    194 GitHub stars~1.2k tokensUpdated 2 mo ago
    Auto-check passed
  • 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…

    194 GitHub stars~686 tokensUpdated 2 mo ago
    Auto-check passed
  • 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…

    194 GitHub stars~1.3k tokensUpdated 2 mo ago
    Auto-check passed
  • A skill your agent uses when implementing or modifying behavior that must stay consistent across TUI and Web (mode/input/tool/replay/order).

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

Questions about Formax Rework Convergence Workflow

What does Formax Rework Convergence Workflow do?

A skill your agent uses when code has gone through repeated rework and may contain redundant logic, style drift, or tangled structure. Formax Rework Convergence Workflow is an agent skill from yusifeng/formax. Use when code has gone through repeated rework and may contain redundant logic, style drift, or tangled structure.

When should I use Formax Rework Convergence Workflow?

Formax Rework Convergence Workflow fits situations like: code has gone through repeated rework and may contain redundant logic; tangled structure; user asks for 返工收敛; requests a focused cleanup pass that reduces churn without changing behavior.

How do I install Formax Rework Convergence Workflow in Claude Code?

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

How do I install Formax Rework Convergence Workflow in Codex?

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

Can I use Formax Rework Convergence 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-rework-convergence-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-rework-convergence-workflow, .gemini/skills/formax-rework-convergence-workflow, .github/skills/formax-rework-convergence-workflow and .opencode/skills/formax-rework-convergence-workflow in your project.

What does Formax Rework Convergence Workflow need to run?

SKILL.md names no scripts, command-line tools or credentials: Formax Rework Convergence Workflow is instructions for the agent only.

Does Formax Rework Convergence 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 Rework Convergence 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 Rework Convergence Workflow use?

Formax Rework Convergence 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 Rework Convergence Workflow use?

About 638 tokens (SKILL.md is roughly 2.6k 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 Rework Convergence Workflow?

Skills that share tags, products or a category with Formax Rework Convergence Workflow: Convergence (parcadei/Continuous-Claude-v3, 3.9k stars), Convergence Study (FreedomIntelligence/OpenClaw-Medical-Skills, 3.1k stars), Gsd Plan Review Convergence (open-gsd/gsd-core, 10k stars) and Convergence Monitoring (hashgraph-online/awesome-codex-plugins, 1.3k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Formax Rework Convergence Workflow?

yusifeng (a GitHub user) maintains it in yusifeng/formax, which has 194 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.