Agent skill

Formax Skill Capture

by yusifeng in yusifeng/formax

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

MITAuto-check passedAI & LLM Engineering

Install Formax Skill Capture

skills CLI
$ npx skills add yusifeng/formax --skill formax-skill-capture -a claude-code

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

GitHub CLI
$ gh skill install yusifeng/formax formax-skill-capture --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-skill-capture .claude/skills/formax-skill-capture && 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-skill-capture
GitHub stars
195
Token cost
~530 tokens
SKILL.md length
228 words
Files
2 (incl. scripts)
Skills in repo
21
Repo updated
First seen
Licence
MIT

At a glance

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

  • Works in 4 steps: Skill name (kebab-case), e.g.… → 1–2 sentence description: when should… → Scope: which subsystem? (pick one) → …
  • We want to turn a just-finished Formax workflow (e.g
  • SKILL.md covers What this is, When to use, Minimal questions to ask (do… and Output requirements, plus 2 more sections
  • Runs Shell scripts from its folder; calls bash

What it does

Formax Skill Capture is an agent skill from yusifeng/formax. Use when we want to turn a just-finished Formax workflow (e.g. commands, overlays, tools, hooks, permissions, UI parity) into a reusable Codex Skill under .codex/skills, including scaffolding, guardrails, and the minimum test checklist.

Its SKILL.md is about 530 tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files, including scripts (for example `scripts/new-skill.sh`).

It sits in AI & LLM Engineering, covering Project scaffolding and LLM guardrails. 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

  • We want to turn a just-finished Formax workflow (e.g
  • Tasks that involve Project scaffolding
  • Tasks that involve LLM guardrails

Example prompts

  • “/formax-skill-capture”

Requirements

  • A Bash shell

Workflow steps

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

  1. Skill name (kebab-case), e.g. formax-slash-command-workflow
  2. 1–2 sentence description: when should Codex use it?
  3. Scope: which subsystem? (pick one)
  4. Any explicit “don’t change” constraints? (UI copy/spacing/colors, contracts, etc.)

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

    Ships 1 file in scripts/ (Shell), which the agent can run.

    Shell commands in SKILL.md call:

    • bash

    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 Skill Capture loads about 530 tokens when it runs. Until then it costs about 64 tokens; SKILL.md has 228 words of instructions outside code blocks.

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

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); the scripts in this folder are not scanned.

SKILL.md

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

Download SKILL.mdSave it as .claude/skills/formax-skill-capture/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
formax-skill-capture
description
Use when we want to turn a just-finished Formax workflow (e.g. commands, overlays, tools, hooks, permissions, UI parity) into a reusable Codex Skill under .codex/skills, including scaffolding, guardrails, and the minimum test checklist.

Formax skill capture (create skills from our workflow)

What this is

This skill is a Formax-specific wrapper around skill authoring: it helps us reliably convert “we just figured out how to do X” into a repo-local skill under .codex/skills/<skill-name>/.

It complements the built-in skill-creator (system skill) by adding Formax conventions:

  • repo-local skills (checked into git)
  • “where to change what” file map
  • invariants (UI parity, model injection orthogonality, etc.)
  • minimum regression tests to lock behavior

When to use

Trigger this when the user says:

  • “把这个流程沉淀成 skill”
  • “以后别再忘了怎么改 /xxx”
  • “给我一个复用的修改清单/固定套路”

Minimal questions to ask (do not proceed until answered)

  1. Skill name (kebab-case), e.g. formax-slash-command-workflow
  2. 1–2 sentence description: when should Codex use it?
  3. Scope: which subsystem? (pick one)
    • slash commands / overlays
    • tools (spec/handler/presenter)
    • hooks
    • permissions/policy
    • stability/input routing
  4. Any explicit “don’t change” constraints? (UI copy/spacing/colors, contracts, etc.)

Output requirements

The resulting skill must include:

  • a short “Goal” section
  • “Where to change what” (file list)
  • “Patterns” (2–4 common patterns)
  • “Tests to update” (minimum regression set)
  • “Guardrails” (what must not regress)

Avoid long prose; prefer checklists.

Create a new skill (scaffold)

Use the scaffold script:

sh
bash .codex/skills/formax-skill-capture/scripts/new-skill.sh <skill-name> "<description>"

Then fill SKILL.md body with the content above.

Refactor policy for skills

When a skill is created from a workflow we already shipped:

  • Do not broaden scope (no extra features)
  • Do not rewrite UI (unless explicitly requested)
  • Write/extend tests first if behavior has regressed before

© 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 1 other file (scripts) in .codex/skills/formax-skill-capture of yusifeng/formax.

  • SKILL.md
  • scripts/new-skill.sh

Open the folder on GitHubat commit 1b0c3f3

Compare with similar skills

Formax Skill Capture 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 Skill Capture compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Formax Skill Capture this skillyusifeng/formax195—~530Automated safety check: PassMIT
Git Guardrails Claude Codefossasia/eventyay-interpretation1.6k12 repos~578Automated safety check: PassApache-2.0
Git Guardrails Claude Codevinvcn/mattpocock-skills-zh-CN4.7k—~461Automated safety check: PassMIT
Aisafetyhotwuyoscar/AISafetyHot-Hub641—~1.4kAutomated safety check: PassCustom licence
Google Agents CLI Adk Codepifferologo/cloud-agents-cli1291 repos~768Automated safety check: PassApache-2.0
Fable Modemrtooher/fable-mode872—~1kAutomated safety check: PassNone

Similar skills

  • Git Guardrails Claude Code

    fossasia/eventyay-interpretation

    Set up Claude Code hooks to block dangerous git commands (push, reset --hard, clean, branch -D, etc.) before they execute.

    1.6k GitHub starsUsed in 12 repos~578 tokens
    AI & LLM EngineeringAuto-check passed
  • Git Guardrails Claude Code

    vinvcn/mattpocock-skills-zh-CN

    设置 Claude Code hooks,在危险 git commands(push、reset --hard、clean、branch -D 等)执行前阻止它们。适用于用户想防止破坏性 git 操作、添加 git safety hooks,或在 Claude Code 中阻止 git push/reset 时。

    4.7k GitHub stars~461 tokensUpdated yesterday
    AI & LLM EngineeringAuto-check passed
  • Aisafetyhot

    wuyoscar/AISafetyHot-Hub

    Query AI Safety HOT news, research papers, incidents, hot topics, and daily/weekly/monthly reports through its public read-only MCP service.

    641 GitHub stars~1.4k tokensUpdated today
    AI & LLM EngineeringAuto-check passed
  • Google Agents CLI Adk Code

    pifferologo/cloud-agents-cli

    This skill should be used when the user wants to "write agent code", "build an agent with ADK", "add a tool", "create a callback", "define an agent", "use state management", or needs ADK (Agent…

    129 GitHub starsUsed in 1 repo~768 tokens
    AI & LLM EngineeringAuto-check passed
  • Fable Mode

    mrtooher/fable-mode

    Enforces staged execution discipline on large tasks: a written stage plan, delegation to named fable agents where the runtime supports it, a failable verification check at each stage, and a…

    872 GitHub stars~1k tokensUpdated 1 mo ago
    AI & LLM EngineeringAuto-check passed
  • Build Dashclaw

    ucsandman/DashClaw

    Contribute to the DashClaw codebase — architecture, scaffolding, tests, CI

    310 GitHub stars~1.3k tokensUpdated 3 days ago
    AI & LLM EngineeringAuto-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
  • 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
  • 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 Skill Capture

What does Formax Skill Capture do?

A skill your agent uses when we want to turn a just-finished Formax workflow (e.g. Formax Skill Capture is an agent skill from yusifeng/formax.g.

When should I use Formax Skill Capture?

Formax Skill Capture fits situations like: we want to turn a just-finished Formax workflow (e.g; tasks that involve Project scaffolding; tasks that involve LLM guardrails.

How do I install Formax Skill Capture in Claude Code?

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

How do I install Formax Skill Capture in Codex?

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

Can I use Formax Skill Capture 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-skill-capture -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-skill-capture, .gemini/skills/formax-skill-capture, .github/skills/formax-skill-capture and .opencode/skills/formax-skill-capture in your project.

What does Formax Skill Capture need to run?

Going by SKILL.md and its folder, Formax Skill Capture needs a shell for the scripts in its folder and the command-line tools its instructions call (bash). Our summary lists: A Bash shell.

Does Formax Skill Capture 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 Skill Capture 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. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Formax Skill Capture use?

Formax Skill Capture 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 Skill Capture use?

About 530 tokens (SKILL.md is roughly 2.1k 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 Skill Capture?

Skills that share tags, products or a category with Formax Skill Capture: Git Guardrails Claude Code (fossasia/eventyay-interpretation, 1.6k stars), Git Guardrails Claude Code (vinvcn/mattpocock-skills-zh-CN, 4.7k stars), Aisafetyhot (wuyoscar/AISafetyHot-Hub, 641 stars) and Google Agents CLI Adk Code (pifferologo/cloud-agents-cli, 129 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Formax Skill Capture?

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.