Agent skill

Formax Rolling Plan Loop Workflow

by yusifeng in yusifeng/formax

A skill your agent uses when the user wants a reusable rolling execution pattern (README + TODO-INDEX) like plans/web-reference-react-refactor, and wants to run delivery in small validated loops.

MITAuto-check passedDevelopment

Install Formax Rolling Plan Loop Workflow

skills CLI
$ npx skills add yusifeng/formax --skill formax-rolling-plan-loop-workflow -a claude-code

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

GitHub CLI
$ gh skill install yusifeng/formax formax-rolling-plan-loop-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-rolling-plan-loop-workflow .claude/skills/formax-rolling-plan-loop-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-rolling-plan-loop-workflow
GitHub stars
195
Token cost
~309 tokens
SKILL.md length
85 words
Files
3 (incl. references)
Skills in repo
21
Repo updated
First seen
Licence
MIT

At a glance

A skill your agent uses when the user wants a reusable rolling execution pattern (README + TODO-INDEX) like plans/web-reference-react-refactor, and wants to run delivery in small validated loops.

  • Works in 2 steps: README.md → TODO-INDEX.md
  • The user wants a reusable rolling execution pattern (README + TODO-INDEX) like plans/web-reference-react-refactor
  • SKILL.md covers Goal, When to use, Output contract and Default loop template, plus 3 more sections
  • Calls codex

What it does

Formax Rolling Plan Loop Workflow is an agent skill from yusifeng/formax. Use when the user wants a reusable rolling execution pattern (README + TODO-INDEX) like plans/web-reference-react-refactor, and wants to run delivery in small validated loops.

Its SKILL.md is about 310 tokens, which your agent loads only when the skill is triggered. The skill folder holds 3 other files, including reference files (for example `references/README.template.md` and `references/TODO-INDEX.template.md`).

It sits in Development, covering Refactoring and Technical documentation. It works with React. 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

  • The user wants a reusable rolling execution pattern (README + TODO-INDEX) like plans/web-reference-react-refactor
  • Wants to run delivery in small validated loops

Example prompts

  • “/formax-rolling-plan-loop-workflow”

Workflow steps

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

  1. README.md
  2. TODO-INDEX.md

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:

    • codex

    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 Rolling Plan Loop Workflow loads about 309 tokens when it runs, and up to ~651 if it reads all its reference files. Until then it costs about 52 tokens; SKILL.md has 85 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~52
When it runs · the whole SKILL.md, loaded when a task matches
~309
With references · SKILL.md plus every file in references/, read only if the agent opens them
~651

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). 85 words, ~309 tokens.

Download SKILL.mdSave it as .claude/skills/formax-rolling-plan-loop-workflow/SKILL.md (or your agent's skills folder). This skill also uses 2 other files; get the full folder from GitHub.
name
formax-rolling-plan-loop-workflow
description
Use when the user wants a reusable rolling execution pattern (README + TODO-INDEX) like plans/web-reference-react-refactor, and wants to run delivery in small validated loops.

Formax Rolling Plan Loop Workflow

Goal

快速创建并维护一个“滚动循环执行”计划目录,结构与 plans/web-reference-react-refactor/ 一致:

  • README.md:目标、边界、固定执行循环
  • TODO-INDEX.md:只保留未完成任务

When to use

  • 用户明确要求“模仿 plans/web-reference-react-refactor 的循环方式”。
  • 用户希望以固定循环推进实现:实现 -> 定向测试 -> codex review -> 提交。
  • 用户多次重复同类流程,想固化为可复用模式。

Output contract

在 plans/<topic-slug>/ 下创建(或更新):

  1. README.md
  2. TODO-INDEX.md

可选:

  1. 在 plans/TODO-INDEX.md 增加该计划入口(通常放在“并行参考”)。

Default loop template

每个切片固定流程:

  1. 实现(最小改动)
  2. 定向测试
  3. codex review --uncommitted -c model="gpt-5.4" -c model_reasoning_effort="medium" -c service_tier="fast"
  4. 提交(Conventional Commit)

Required guardrails

  • 不在同一切片混入无关重构。
  • 不做“测试全量覆盖”作为迭代默认命令(除非用户明确要求)。
  • TODO-INDEX.md 只保留未完成项;已完成项不回填,历史以 Git commit 为准。

Regeneration rules

当 TODO-INDEX.md 清空时:

  1. 仅从同目录 README.md 派生下一批。
  2. 按可提交的小切片拆分(建议 2-8 文件)。
  3. 保持固定循环,不跳步。

References

  • 模板:references/README.template.md
  • 模板:references/TODO-INDEX.template.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

SKILL.md and 2 other files (references) in .codex/skills/formax-rolling-plan-loop-workflow of yusifeng/formax.

  • SKILL.md
  • references/README.template.md
  • references/TODO-INDEX.template.md

Open the folder on GitHubat commit 1b0c3f3

Compare with similar skills

Formax Rolling Plan Loop 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 Rolling Plan Loop Workflow compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Formax Rolling Plan Loop Workflow this skillyusifeng/formax195—~309Automated safety check: PassMIT
Nuqstrycompai/crm11k1 repos~1.7kAutomated safety check: PassMIT
Refactor React Effectslangfuse/langfuse36k—~1.7kAutomated safety check: PassCustom licence
No Use Effectmattiacerutti/supernova1872 repos~1.7kAutomated safety check: PassMIT
React Best Practicesshapeshift/web2061 repos~2kAutomated safety check: PassMIT
Nextjs App Architecturejakubwarkusz/themes1231 repos~2.5kAutomated safety check: PassMIT

Similar skills

  • Nuqs

    trycompai/crm

    nuqs (type-safe URL query state) best practices for Next.js and other React frameworks.

    11k GitHub starsUsed in 1 repo~1.7k tokens
    DevelopmentAuto-check passed
  • Refactor React Effects

    langfuse/langfuse

    Refactor avoidable React useEffect usage in Langfuse frontend code.

    36k GitHub stars~1.7k tokensUpdated today
    DevelopmentAuto-check passed
  • No Use Effect

    mattiacerutti/supernova

    Enforce the no-useEffect rule when writing or reviewing React code.

    187 GitHub starsUsed in 2 repos~1.7k tokens
    DevelopmentAuto-check passed
  • React Best Practices

    shapeshift/web

    Comprehensive React and Next.js performance optimization guide with 40+ rules for eliminating waterfalls, optimizing bundles, and improving rendering.

    206 GitHub starsUsed in 1 repo~2k tokens
    DevelopmentAuto-check passed
  • Nextjs App Architecture

    jakubwarkusz/themes

    Build or audit Next.js 16 App Router apps using a next-beats-style React Server Components architecture.

    123 GitHub starsUsed in 1 repo~2.5k tokens
    DevelopmentAuto-check passed
  • Migrate Component

    asyncapi/generator

    Promote a duplicated React/JSX template-local component into the shared @asyncapi/generator-components package.

    1.1k GitHub stars~3k tokensUpdated 2 days ago
    DevelopmentAuto-check passed

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…

    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
  • 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
  • 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
  • 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

Works with

Categories

Questions about Formax Rolling Plan Loop Workflow

What does Formax Rolling Plan Loop Workflow do?

A skill your agent uses when the user wants a reusable rolling execution pattern (README + TODO-INDEX) like plans/web-reference-react-refactor, and wants to run delivery in small validated loops. Formax Rolling Plan Loop Workflow is an agent skill from yusifeng/formax. Use when the user wants a reusable rolling execution pattern (README + TODO-INDEX) like plans/web-reference-react-refactor, and wants to run delivery in small validated loops.

When should I use Formax Rolling Plan Loop Workflow?

Formax Rolling Plan Loop Workflow fits situations like: the user wants a reusable rolling execution pattern (README + TODO-INDEX) like plans/web-reference-react-refactor; wants to run delivery in small validated loops.

How do I install Formax Rolling Plan Loop Workflow in Claude Code?

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

How do I install Formax Rolling Plan Loop Workflow in Codex?

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

Can I use Formax Rolling Plan Loop 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-rolling-plan-loop-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-rolling-plan-loop-workflow, .gemini/skills/formax-rolling-plan-loop-workflow, .github/skills/formax-rolling-plan-loop-workflow and .opencode/skills/formax-rolling-plan-loop-workflow in your project.

What does Formax Rolling Plan Loop Workflow need to run?

Going by SKILL.md and its folder, Formax Rolling Plan Loop Workflow needs the command-line tools its instructions call (codex).

Does Formax Rolling Plan Loop 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 Rolling Plan Loop 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 Rolling Plan Loop Workflow use?

Formax Rolling Plan Loop 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 Rolling Plan Loop Workflow use?

About 309 tokens (SKILL.md is roughly 1.2k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 342 tokens, read only when the agent opens those files.

What are the alternatives to Formax Rolling Plan Loop Workflow?

Skills that share tags, products or a category with Formax Rolling Plan Loop Workflow: Nuqs (trycompai/crm, 11k stars), Refactor React Effects (langfuse/langfuse, 36k stars), No Use Effect (mattiacerutti/supernova, 187 stars) and React Best Practices (shapeshift/web, 206 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Formax Rolling Plan Loop 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.