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 System Prompt Workflow

by yusifeng in yusifeng/formax

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…

MITAuto-check passedAI & LLM Engineering

Install Formax System Prompt Workflow

skills CLI
$ npx skills add yusifeng/formax --skill formax-system-prompt-workflow -a claude-code

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

GitHub CLI
$ gh skill install yusifeng/formax formax-system-prompt-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-system-prompt-workflow .claude/skills/formax-system-prompt-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-system-prompt-workflow
GitHub stars
194
Token cost
~1k tokens
SKILL.md length
383 words
Files
4 (incl. references)
Skills in repo
21
Repo updated
First seen
Licence
MIT

At a glance

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…

  • Works in 4 steps: Keep a single prompt-profile path. → Treat FORMAX_DEFERRED_TOOL_EXPOSURE as a… → Keep helper blocks request-scoped and… → …
  • Debugging Formax system prompt assembly
  • SKILL.md covers Goal, Read First, Invariants and Code Map, plus 4 more sections
  • Calls bun

What it does

Formax System Prompt Workflow is an agent skill from yusifeng/formax. Use when designing, refactoring, or debugging Formax system prompt assembly, system-reminder injection, or skills/deferred-tool prompt exposure semantics; mandatory for any change involving FORMAXDEFERREDTOOLEXPOSURE and request-payload parity checks.

Its SKILL.md is about 1k tokens, which your agent loads only when the skill is triggered. The skill folder holds 5 other files, including reference files (for example `agents/openai.yaml`, `references/parity-checklist.md` and `references/parity-evidence-template.md`).

It sits in AI & LLM Engineering, covering Prompt engineering. 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

  • Debugging Formax system prompt assembly
  • System-reminder injection
  • Skills/deferred-tool prompt exposure semantics
  • Mandatory for any change involving FORMAXDEFERREDTOOLEXPOSURE and request-payload parity checks

Example prompts

  • “/formax-system-prompt-workflow”

Workflow steps

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

  1. Keep a single prompt-profile path.
  2. Treat FORMAX_DEFERRED_TOOL_EXPOSURE as a linked behavior bundle.
  3. Keep helper blocks request-scoped and ephemeral.
  4. Only claim capabilities that Formax runtime actually implements.

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 System Prompt Workflow loads about 1k tokens when it runs, and up to ~2.3k if it reads all its reference files. Until then it costs about 71 tokens; SKILL.md has 383 words of instructions outside code blocks.

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

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). 383 words, ~1,048 tokens.

Download SKILL.mdSave it as .claude/skills/formax-system-prompt-workflow/SKILL.md (or your agent's skills folder). This skill also uses 3 other files; get the full folder from GitHub.
name
formax-system-prompt-workflow
description
Use when designing, refactoring, or debugging Formax system prompt assembly, system-reminder injection, or skills/deferred-tool prompt exposure semantics; mandatory for any change involving FORMAX_DEFERRED_TOOL_EXPOSURE and request-payload parity checks.

formax-system-prompt-workflow

Goal

Use this skill when changing system prompt assembly, reminder injection, deferred tool exposure, or skills prompt presentation.

Read First

  • docs/contracts/prompt-tool-exposure-contract.md
  • docs/contracts/skills-contract.md
  • docs/contracts/semantics-contract.md when request-scoped helper blocks affect replay or transcript semantics

Optional working notes:

  • references/parity-checklist.md
  • references/parity-evidence-template.md

These docs are canonical. If stable behavior changes, update them before or with code.

Invariants

  1. Keep a single prompt-profile path.
    • do not reintroduce promptProfile, lite, or similar profile branches
  2. Treat FORMAX_DEFERRED_TOOL_EXPOSURE as a linked behavior bundle.
    • prompt variant, tools exposure style, and skills presentation must stay aligned
  3. Keep helper blocks request-scoped and ephemeral.
    • injected <system-reminder> blocks and deferred helper blocks must not pollute persisted long-term history
  4. Only claim capabilities that Formax runtime actually implements.
    • do not add CC-like capability prose before the runtime supports it

Code Map

  • packages/core/src/prompts/system.ts: system prompt text, variant selection, capability gates
  • packages/core/src/features/repl/controller/send/sendMainTurn.ts: per-turn injected block order and REPL assembly
  • packages/core/src/tools/runtime/deferredToolExposureResolver.ts: deferred tools exposure and helper-block content
  • packages/core/src/tools/modules/skill/index.ts: skill tool description shaping and skills reminder text
  • packages/core/src/chat/engine.ts: request assembly and injected-block persistence boundaries
  • Cross-entrypoint mirrors when semantics move:
    • packages/core/src/app-server/turnRunner.ts
    • packages/core/src/sdk/query/runner.ts
  • scripts/repl-request-preview.ts: quick dry-run payload preview without live network calls

Deferred Exposure Checklist (FORMAX_DEFERRED_TOOL_EXPOSURE=1)

  • system prompt variant resolves to deferred_aligned
  • request contains <available-deferred-tools> helper content
  • skills availability is delivered as a skills system-reminder helper block
  • tool list starts from deferred exposure resolver output (ToolSearch first)
  • tool-call chain remains valid: ToolSearch(select:<tool>) -> <tool>
Show full SKILL.md (158 more words)Show less

Minimal Workflow

  1. Classify the change first: all-mode or deferred-only (FORMAX_DEFERRED_TOOL_EXPOSURE=1).
  2. Update the canonical contract and prompt text first, then change resolver / wiring code.
  3. Keep helper blocks request-scoped and ephemeral; do not let them leak into persisted history.
  4. If semantics move, check REPL, app-server, and SDK paths together before calling the change done.
  5. Run the minimum regression set below, then use request preview only as evidence, not as the only validation.

Minimum Regression

  • bun run test -- packages/core/src/prompts/system.test.ts packages/core/src/tools/runtime/deferredToolExposureResolver.test.ts packages/core/src/features/repl/controller/send/sendMainTurn.test.ts
  • bun run test -- packages/core/src/chat/engine.test.ts packages/core/src/config/settings/resolve.test.ts packages/core/src/sdk/query.test.ts packages/core/src/sdk/query.options-alignment.test.ts
  • bun run test -- packages/core/src/app-server/turnRunner.test.ts when app-server request assembly changes
  • bun run type-check
  • bun run request:preview -- --text "执行下 pwd" --deferred for quick payload inspection when deferred exposure is involved

Guardrails

  • Do not reintroduce prompt-profile branches (lite, full, promptProfile, or equivalents).
  • Do not add new environment toggles for prompt capability sections; use code-level capability switches in system.ts.
  • Do not loosen permissions or allow-list behavior just to make parity demos pass.

© 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 3 other files (references) in .codex/skills/formax-system-prompt-workflow of yusifeng/formax.

  • SKILL.md
  • agents/openai.yaml
  • references/parity-checklist.md
  • references/parity-evidence-template.md

Open the folder on GitHubat commit 1b0c3f3

Compare with similar skills

Formax System Prompt 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 System Prompt Workflow compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Formax System Prompt Workflow this skillyusifeng/formax194—~1kAutomated safety check: PassMIT
Prompt Improverseverity1/claude-code-prompt-improver1.9k1 repos~1.7kAutomated safety check: PassMIT
Prompt Engineering Patternsynulihao/AgentSkillOS61814 repos~1.7kAutomated safety check: PassNone
Patch CreationPiebald-AI/tweakcc2.5k—~1.6kAutomated safety check: PassMIT
Senior Prompt Engineermaslennikov-ig/claude-code-orchestrator-kit2603 repos~1.4kAutomated safety check: PassCustom licence
Codex Fable5baskduf/FableCodex437—~1.6kAutomated safety check: PassAGPL-3.0

Similar skills

  • Prompt Improver

    severity1/claude-code-prompt-improver

    This skill enriches vague prompts with targeted research and clarification before execution.

    1.9k GitHub starsUsed in 1 repo~1.7k tokens
    AI & LLM EngineeringAuto-check passed

  • Prompt Engineering Patterns

    ynulihao/AgentSkillOS

    Master advanced prompt engineering techniques to maximize LLM performance, reliability, and controllability in production.

    618 GitHub starsUsed in 14 repos~1.7k tokens
    AI & LLM EngineeringAuto-check passed

  • Patch Creation

    Piebald-AI/tweakcc

    Create and register new patches for tweakcc. An agent skill from Piebald-AI/tweakcc.

    2.5k GitHub stars~1.6k tokensUpdated today
    AI & LLM EngineeringAuto-check passed

  • Senior Prompt Engineer

    maslennikov-ig/claude-code-orchestrator-kit

    Provides reference guides and Python scripts for prompt optimization, RAG evaluation, and agent orchestration when building or tuning LLM systems.

    260 GitHub starsUsed in 3 repos~1.4k tokens
    AI & LLM EngineeringAuto-check passed

  • Codex Fable5

    baskduf/FableCodex

    Apply a Claude Fable 5 inspired operating style inside Codex.

    437 GitHub stars~1.6k tokensUpdated 2 mo ago
    AI & LLM EngineeringAuto-check passed

  • Prompt Engineering Patterns

    wshobson/agents

    Reference for designing and tuning production LLM prompts: few-shot examples, chain-of-thought, structured outputs, templates and system prompts.

    40k GitHub stars~1.3k tokensUpdated 6 days ago
    AI & LLM EngineeringAuto-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…

    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

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

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

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

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

Categories

Questions about Formax System Prompt Workflow

What does Formax System Prompt Workflow do?

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…. Formax System Prompt Workflow is an agent skill from yusifeng/formax. Use when designing, refactoring, or debugging Formax system prompt assembly, system-reminder injection, or skills/deferred-tool prompt exposure semantics; mandatory for any change involving FORMAXDEFERREDTOOLEXPOSURE and request-payload parity checks.

When should I use Formax System Prompt Workflow?

Formax System Prompt Workflow fits situations like: debugging Formax system prompt assembly; system-reminder injection; skills/deferred-tool prompt exposure semantics; mandatory for any change involving FORMAXDEFERREDTOOLEXPOSURE and request-payload parity checks.

How do I install Formax System Prompt Workflow in Claude Code?

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

How do I install Formax System Prompt Workflow in Codex?

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

Can I use Formax System Prompt 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-system-prompt-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-system-prompt-workflow, .gemini/skills/formax-system-prompt-workflow, .github/skills/formax-system-prompt-workflow and .opencode/skills/formax-system-prompt-workflow in your project.

What does Formax System Prompt Workflow need to run?

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

Does Formax System Prompt 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 System Prompt 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 System Prompt Workflow use?

Formax System Prompt 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 System Prompt Workflow use?

About 1k tokens (SKILL.md is roughly 4.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 1.2k tokens, read only when the agent opens those files.

What are the alternatives to Formax System Prompt Workflow?

Skills that share tags, products or a category with Formax System Prompt Workflow: Prompt Improver (severity1/claude-code-prompt-improver, 1.9k stars), Prompt Engineering Patterns (ynulihao/AgentSkillOS, 618 stars), Patch Creation (Piebald-AI/tweakcc, 2.5k stars) and Senior Prompt Engineer (maslennikov-ig/claude-code-orchestrator-kit, 260 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

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