Agent skill

Formax Dev Loop Workflow

by yusifeng in 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…

MITAuto-check passed

Install Formax Dev Loop Workflow

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

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

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

At a glance

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…

  • Works in 7 steps: Pick one mainline item and finish it… → Write/adjust tests first to lock… → Implement the smallest change that… → …
  • Working on Formax code changes and you need a disciplined dev loop: keep a single mainline task
  • SKILL.md covers Default loop (repeat per TODO…, Guardrails (Formax-specific) and Quick commands
  • Calls bun

What it does

Formax Dev Loop Workflow is an agent skill from yusifeng/formax. Use 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 staging (MM), run mandatory review before commit, include an incremental optimization check, and keep commits small and reviewable.

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

  • 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 staging (MM)

Example prompts

  • “/formax-dev-loop-workflow”

Workflow steps

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

  1. Pick one mainline item and finish it end-to-end before starting another.
  2. Write/adjust tests first to lock behavior (when feasible).
  3. Implement the smallest change that satisfies the item.
  4. Incremental optimization check (required)
  5. Run only targeted tests (never bun run test:coverage unless explicitly asked).
  6. Pre-commit hygiene
  7. Commit

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 Dev Loop Workflow loads about 686 tokens when it runs. Until then it costs about 84 tokens; SKILL.md has 264 words of instructions outside code blocks.

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

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). 264 words, ~686 tokens.

Download SKILL.mdSave it as .claude/skills/formax-dev-loop-workflow/SKILL.md (or your agent's skills folder).
name
formax-dev-loop-workflow
description
Use 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 staging (MM), run mandatory review before commit, include an incremental optimization check, and keep commits small and reviewable.

Formax Dev Loop (Mainline Discipline)

Default loop (repeat per TODO item)

  1. Pick one mainline item and finish it end-to-end before starting another.

    • If a new idea appears mid-flight, write it down in a backlog note and continue the mainline.
  2. Write/adjust tests first to lock behavior (when feasible).

  3. Implement the smallest change that satisfies the item.

  4. Incremental optimization check (required)

    • After implementation, do a quick pass:
      • Is there newly-dead/unused logic introduced by this increment?
      • Is there a low-risk simplification that reduces branching/duplication?
    • If yes, include a small optimization in the same item (no scope drift, no behavior change).
    • If no, explicitly proceed without optimization.
  5. Run only targeted tests (never bun run test:coverage unless explicitly asked).

    • Preferred: bun run test -- <changed-test-files...>
    • Helper (repo): bun run test:changed
      • Use default (staged only) for the commit you are about to make.
      • Use bun run test:changed -- --all only when you intentionally want staged + unstaged + untracked.
  6. Pre-commit hygiene

    • Avoid partial staging (“MM” state). If needed, check with:
      • bun run check:partial-stage
    • Run review before every commit using AGENTS.md -> Review Profile (Single Source of Truth).
    • If review returns findings: fix -> re-run targeted tests -> re-run review.
  7. Commit

    • Keep it small (2–4 files ideally, unless refactor forces more).
    • Prefer one concern per commit (tests + implementation together for that concern).

Guardrails (Formax-specific)

  • Do not fix unrelated failures mid-loop unless they block the mainline.
  • If a command would usually be run with pipes/redirections for convenience, prefer running it plain and rely on Formax’s own output truncation/Expand UI.
  • Don’t “clean up” formatting/copy/colors/spacing unless explicitly requested or required for parity.

Quick commands

bash
# Detect partial staging (“MM”)
bun run check:partial-stage

# Run related tests for staged changes
bun run test:changed -- --dry-run
bun run test:changed

# Include unstaged + untracked (when explicitly intended)
bun run test:changed -- --all

# Required before commit (review profile)
# See AGENTS.md -> "Review Profile (Single Source of Truth)"

© 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-dev-loop-workflow of yusifeng/formax.

Open the folder on GitHubat commit 1b0c3f3

Compare with similar skills

Formax Dev 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 Dev Loop Workflow compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Formax Dev Loop Workflow this skillyusifeng/formax195—~686Automated safety check: PassMIT
Counterparty Channel Disciplineaffaan-m/ECC274k—~2.3kAutomated safety check: PassMIT
Agent Memory Disciplinesickn33/agentic-awesome-skills47k1 repos~2.9kAutomated safety check: PassCC0-1.0
Agent Doc DisciplineYeachan-Heo/oh-my-claudecode40k—~1.5kAutomated safety check: PassMIT
Minimal Code DisciplineYeachan-Heo/oh-my-claudecode40k—~746Automated safety check: PassMIT
Minimal Prose DisciplineYeachan-Heo/oh-my-claudecode40k—~2.1kAutomated safety check: PassMIT

Similar skills

  • Per-channel strict prompts, mention gating, silent observation, and a communication autonomy policy for agents that sit in shared channels with external counterparties.

    274k GitHub stars~2.3k tokensUpdated 2 days ago
    Productivity & AutomationAuto-check passed
  • Agent Memory Discipline

    sickn33/agentic-awesome-skills

    Rules for when an agent should recall from long-term memory before acting and when it should save decisions, corrections and failures afterwards.

    47k GitHub starsUsed in 1 repo~2.9k tokens
    Agent WorkflowsAuto-check passed
  • Agent Doc Discipline

    Yeachan-Heo/oh-my-claudecode

    Writing standards for documents that agents read in order to act, such as CLAUDE.md, specs and tickets, so a fresh session can follow them without chat history.

    40k GitHub stars~1.5k tokensUpdated today
    Agent WorkflowsAuto-check passed
  • Minimal Code Discipline

    Yeachan-Heo/oh-my-claudecode

    A YAGNI-style checklist for planning and writing code changes: skip what is not needed, reuse what exists and ship the shortest correct diff.

    40k GitHub stars~746 tokensUpdated today
    DevelopmentAuto-check passed
  • Minimal Prose Discipline

    Yeachan-Heo/oh-my-claudecode

    Keeps an agent's chat replies and reports short by cutting filler and narration while leaving code, commands, paths, errors and numbers untouched.

    40k GitHub stars~2.1k tokensUpdated today
    Writing & ContentAuto-check passed
  • Intel Discipline Advisor

    deanpeters/Product-Manager-Skills

    Triage a competitive or market question into the right intelligence disciplines, cadence, and executing skill.

    7.2k GitHub stars~3.1k tokensUpdated 1 mo ago
    Auto-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
  • 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
  • A skill your agent uses when designing, refactoring, or debugging Formax system prompt assembly, system-reminder injection, or skills/deferred-tool prompt exposure semantics; mandatory for any…

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

Questions about Formax Dev Loop Workflow

What does Formax Dev Loop Workflow do?

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…. Formax Dev Loop Workflow is an agent skill from yusifeng/formax. Use 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 staging (MM), run mandatory review before commit, include an incremental optimization check, and keep commits small and reviewable.

When should I use Formax Dev Loop Workflow?

Formax Dev Loop Workflow fits situations like: 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 staging (MM).

How do I install Formax Dev Loop Workflow in Claude Code?

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

How do I install Formax Dev Loop Workflow in Codex?

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

Can I use Formax Dev 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-dev-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-dev-loop-workflow, .gemini/skills/formax-dev-loop-workflow, .github/skills/formax-dev-loop-workflow and .opencode/skills/formax-dev-loop-workflow in your project.

What does Formax Dev Loop Workflow need to run?

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

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

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

About 686 tokens (SKILL.md is roughly 2.7k 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 Dev Loop Workflow?

Skills that share tags, products or a category with Formax Dev Loop Workflow: Counterparty Channel Discipline (affaan-m/ECC, 274k stars), Agent Memory Discipline (sickn33/agentic-awesome-skills, 47k stars), Agent Doc Discipline (Yeachan-Heo/oh-my-claudecode, 40k stars) and Minimal Code Discipline (Yeachan-Heo/oh-my-claudecode, 40k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Formax Dev 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.