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 Web CSS Convergence Workflow

by yusifeng in yusifeng/formax

A skill your agent uses when changing web CSS/UI styling so requirements, state ownership, and acceptance checks are locked before edits to prevent rework churn.

MITAuto-check passedFrontend & Design

Install Formax Web CSS Convergence Workflow

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

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

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

At a glance

A skill your agent uses when changing web CSS/UI styling so requirements, state ownership, and acceptance checks are locked before edits to prevent rework churn.

  • Works in 8 steps: Target model in one sentence (final… → Non-goals / do-not-touch list. → State model (if any) and single source… → …
  • Changing web CSS/UI styling so requirements
  • SKILL.md covers Goal, Intake Contract (Run Before…, Where to change what and Patterns, plus 2 more sections
  • Calls bun, npm and codex

What it does

Formax Web CSS Convergence Workflow is an agent skill from yusifeng/formax. Use when changing web CSS/UI styling so requirements, state ownership, and acceptance checks are locked before edits to prevent rework churn.

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

It sits in Frontend & Design. 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

  • Changing web CSS/UI styling so requirements
  • State ownership
  • Acceptance checks are locked before edits to prevent rework churn

Example prompts

  • “/formax-web-css-convergence-workflow”

Workflow steps

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

  1. Target model in one sentence (final visual geometry).
  2. Non-goals / do-not-touch list.
  3. State model (if any) and single source of truth.
  4. Ownership boundary (main process vs renderer).
  5. Acceptance criteria (what must be true, what must never appear).
  6. Runtime matrix (command, platform, light/dark).
  7. Iteration policy (single-axis change per pass).
  8. Rollback point (which commit/file set is safe fallback).

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

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

  • Network

    No URLs in SKILL.md. Its commands use npm, which can reach the network depending on how they are called.

    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 Web CSS Convergence Workflow loads about 988 tokens when it runs. Until then it costs about 44 tokens; SKILL.md has 404 words of instructions outside code blocks.

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

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). 404 words, ~988 tokens.

Download SKILL.mdSave it as .claude/skills/formax-web-css-convergence-workflow/SKILL.md (or your agent's skills folder).
name
formax-web-css-convergence-workflow
description
Use when changing web CSS/UI styling so requirements, state ownership, and acceptance checks are locked before edits to prevent rework churn.

formax-web-css-convergence-workflow

Goal

  • Prevent repeated CSS rework by locking requirements before any style edits.
  • Convert ambiguous visual requests into a concrete edit contract with explicit acceptance checks.
  • Keep behavior stable while converging structure, naming, and styling.

Use this skill when the task involves:

  • component styling or layout adjustments
  • cross-file CSS + TSX class changes
  • interaction visual states (hover/active/focus/selected)
  • repeated back-and-forth UI tuning that needs convergence

Intake Contract (Run Before Editing)

  • Require this 8-line input contract (fill missing items by explicit assumptions, not guesswork):
  1. Target model in one sentence (final visual geometry).
  2. Non-goals / do-not-touch list.
  3. State model (if any) and single source of truth.
  4. Ownership boundary (main process vs renderer).
  5. Acceptance criteria (what must be true, what must never appear).
  6. Runtime matrix (command, platform, light/dark).
  7. Iteration policy (single-axis change per pass).
  8. Rollback point (which commit/file set is safe fallback).

Where to change what

  • Core styling surfaces:
    • packages/web-reference-react/src/styles.css
    • packages/web-reference-react/src/css/theme.css
  • Core UI wiring:
    • packages/web-reference-react/src/app/ui/AppShell.tsx
    • packages/web-reference-react/src/components/LeftRail.tsx
    • packages/web-reference-react/src/components/left-rail/SidebarItem.tsx
  • Browser bridge typing surface (when needed):
    • packages/web-reference-react/src/vite-env.d.ts
  • Desktop main/preload ownership (only for stateful window-level visuals):
    • packages/desktop-electron/src/main.ts
    • packages/desktop-electron/src/preload.ts
    • packages/desktop-electron/src/windowAppearanceState.ts
  • Scenario-specific construct (read only if task touches transparency):
    • docs/contracts/web/window-transparency-construct.md

Patterns

  1. Freeze-Then-Edit Pattern
  • Restate final model first.
  • Freeze non-goals (do not touch drag region, menu entries, unrelated text/copy).
  • Only then open code.
  1. Single-Axis Convergence Pattern
  • Pass A: geometry/layers only.
  • Pass B: color/opacity tokens only.
  • Pass C: interaction/focus/hover only.
  • Never mix all three in one pass.
  1. State Ownership Lock Pattern
  • If the task has window/app state coupling:
    • renderer does not invent business states
    • canonical state lives in the owner layer
    • pending UI must converge to canonical state
  1. Evidence-Driven Pattern
  • Use deterministic checks instead of eye-balling:
    • explicit before/after acceptance list
    • “must-not-see” artifact list
    • screenshot evidence when visual regressions are likely
Show full SKILL.md (116 more words)Show less

Tests to update

  • Required baseline for CSS changes in web-reference:
    • bun run test -- src/App.test.tsx (in packages/web-reference-react)
  • Required for desktop bridge/state shape changes:
    • npm --prefix packages/desktop-electron run build:main
  • Required only for transparency scenario:
    • bun run test:e2e -- e2e/window-transparency.evidence.spec.js --project=chromium (in packages/web-reference-react)
  • Required before commit in this repo:
    • codex review --uncommitted -c model="gpt-5.4" -c model_reasoning_effort="medium" -c service_tier="fast"

Guardrails

  • Do not change unrelated UI behavior while “just tuning CSS”.
  • Do not rely on one environment result; verify against the declared runtime matrix.
  • If acceptance criteria are unclear, ask for clarification before directional edits.
  • Avoid speculative visual “patch layers” that do not belong to the target model.
  • If user requests cleanup-pass/返工收敛, reduce churn only:
    • remove redundancy
    • unify naming/state shape
    • preserve behavior

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

Open the folder on GitHubat commit 1b0c3f3

Compare with similar skills

Formax Web CSS 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 Web CSS Convergence Workflow compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Formax Web CSS Convergence Workflow this skillyusifeng/formax195—~988Automated safety check: PassMIT
Web Artifacts Builderanthropics/skills180k41 repos~769Automated safety check: PassApache-2.0
React Doctormakeplane/plane61k12 repos~657Automated safety check: PassAGPL-3.0
React Router Developmentremix-run/react-router57k1 repos~1.5kAutomated safety check: PassMIT
React UI State PatternsChrisWiles/claude-code-showcase6.1k8 repos~1.6kAutomated safety check: PassNone
GSAP Core Animationgreensock/gsap-skills16k4 repos~3.7kAutomated safety check: PassMIT

Similar skills

  • Web Artifacts Builder

    anthropics/skills

    Official

    Builds multi-component claude.ai HTML artifacts as a small React, TypeScript and Tailwind project, then bundles it into one shareable HTML file.

    180k GitHub starsUsed in 41 repos~769 tokens
    Frontend & DesignAuto-check passed

  • React Doctor

    makeplane/plane

    Scans React code for lint, accessibility, bundle size and architecture issues, reports a health score and checks that changes do not lower it.

    61k GitHub starsUsed in 12 repos~657 tokens
    Frontend & DesignAuto-check passed

  • React Router Development

    remix-run/react-router

    Guides work on React Router apps by first identifying whether the app uses Framework, Data or Declarative mode, then loading the matching reference and the installed package docs.

    57k GitHub starsUsed in 1 repo~1.5k tokens
    Frontend & DesignAuto-check passed

  • React UI State Patterns

    ChrisWiles/claude-code-showcase

    Sets patterns for React interfaces: when to show loading spinners or skeletons, how to surface errors, how to disable buttons during async work and how to handle empty lists.

    6.1k GitHub starsUsed in 8 repos~1.6k tokens
    Frontend & DesignAuto-check passed

  • GSAP Core Animation

    greensock/gsap-skills

    Covers the GSAP core API for tweens, easing, staggers, defaults and matchMedia, and when to choose GSAP over CSS animations or other JavaScript animation libraries.

    16k GitHub starsUsed in 4 repos~3.7k tokens
    Frontend & DesignAuto-check passed

  • LobeHub Interactive Prototype

    lobehub/lobehub

    Builds single-file interactive HTML prototypes rendered with the real LobeHub UI components and written as production-style React, so they can later be split into files.

    83k GitHub stars~1.6k tokensUpdated yesterday
    Frontend & DesignAuto-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

Works with

Categories

Questions about Formax Web CSS Convergence Workflow

What does Formax Web CSS Convergence Workflow do?

A skill your agent uses when changing web CSS/UI styling so requirements, state ownership, and acceptance checks are locked before edits to prevent rework churn. Formax Web CSS Convergence Workflow is an agent skill from yusifeng/formax. Use when changing web CSS/UI styling so requirements, state ownership, and acceptance checks are locked before edits to prevent rework churn.

When should I use Formax Web CSS Convergence Workflow?

Formax Web CSS Convergence Workflow fits situations like: changing web CSS/UI styling so requirements; state ownership; acceptance checks are locked before edits to prevent rework churn.

How do I install Formax Web CSS Convergence Workflow in Claude Code?

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

How do I install Formax Web CSS Convergence Workflow in Codex?

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

Can I use Formax Web CSS 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-web-css-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-web-css-convergence-workflow, .gemini/skills/formax-web-css-convergence-workflow, .github/skills/formax-web-css-convergence-workflow and .opencode/skills/formax-web-css-convergence-workflow in your project.

What does Formax Web CSS Convergence Workflow need to run?

Going by SKILL.md and its folder, Formax Web CSS Convergence Workflow needs the command-line tools its instructions call (bun, npm and codex).

Does Formax Web CSS Convergence Workflow access the network?

SKILL.md contains no URLs. Its commands use npm, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Formax Web CSS 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 Web CSS Convergence Workflow use?

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

About 988 tokens (SKILL.md is roughly 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 Web CSS Convergence Workflow?

Skills that share tags, products or a category with Formax Web CSS Convergence Workflow: Web Artifacts Builder (anthropics/skills, 180k stars), React Doctor (makeplane/plane, 61k stars), React Router Development (remix-run/react-router, 57k stars) and React UI State Patterns (ChrisWiles/claude-code-showcase, 6.1k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Formax Web CSS Convergence 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.