Agent skill

Formax Config Settings Workflow

by yusifeng in yusifeng/formax

A skill your agent uses when implementing or extending /config (storage, prompt injection, request params, UI-only toggles) with tests and strict UI parity.

MITAuto-check passedSecurity

Install Formax Config Settings Workflow

skills CLI
$ npx skills add yusifeng/formax --skill formax-config-settings-workflow -a claude-code

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

GitHub CLI
$ gh skill install yusifeng/formax formax-config-settings-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-config-settings-workflow .claude/skills/formax-config-settings-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-config-settings-workflow
GitHub stars
194
Token cost
~1.2k tokens
SKILL.md length
410 words
Files
1
Skills in repo
21
Repo updated
First seen
Licence
MIT

At a glance

A skill your agent uses when implementing or extending /config (storage, prompt injection, request params, UI-only toggles) with tests and strict UI parity.

  • Works in 6 steps: Classify the setting first:… → Update the config settings contract… → Change schema / resolve / persist before… → …
  • Extending /config (storage
  • SKILL.md covers Goal, Read First, Code Map and Current Behavior Checkpoints, plus 3 more sections
  • Calls bun

What it does

Formax Config Settings Workflow is an agent skill from yusifeng/formax. Use when implementing or extending /config (storage, prompt injection, request params, UI-only toggles) with tests and strict UI parity.

Its SKILL.md is about 1.2k 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 Security, covering Prompt injection and agent security. 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

  • Extending /config (storage
  • Prompt injection
  • UI-only toggles) with tests and strict UI parity

Example prompts

  • “/formax-config-settings-workflow”

Workflow steps

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

  1. Classify the setting first: prompt-affecting, request-parameter, or UI-only.
  2. Update the config settings contract first; if env names or classification changed, also update docs/environment-variables.md.
  3. Change schema / resolve / persist before changing dialog wiring or runtime effects.
  4. Preserve sparse writes and immediate in-process reload behavior.
  5. Only output-style style changes may inject next-turn local command blocks; non prompt-affecting settings must stay out of model context.
  6. Run the minimum regression set below before review.

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 Config Settings Workflow loads about 1.2k tokens when it runs. Until then it costs about 42 tokens; SKILL.md has 410 words of instructions outside code blocks.

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

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). 410 words, ~1,202 tokens.

Download SKILL.mdSave it as .claude/skills/formax-config-settings-workflow/SKILL.md (or your agent's skills folder).
name
formax-config-settings-workflow
description
Use when implementing or extending /config (storage, prompt injection, request params, UI-only toggles) with tests and strict UI parity.

formax-config-settings-workflow

Goal

Use this skill when changing runtime config merge semantics, /config persistence, or the current settings exposed by the config dialog.

Read First

  • docs/contracts/config-settings-contract.md
  • docs/environment-variables.md
  • docs/contracts/prompt-tool-exposure-contract.md when a setting affects prompt injection or request composition

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

Code Map

  • Config schema + merge semantics
    • packages/core/src/config/settings/schema.ts (add fields + defaults; validate values)
    • packages/core/src/config/settings/resolve.ts (merge precedence + sources mapping)
    • packages/core/src/config/settings/persist.ts (patch read/write + stripDefaultsFromPatch)
  • Disk locations
    • packages/core/src/adapters/fs/configPaths.ts (project/global config dirs)
    • packages/core/src/adapters/fs/configFiles.ts (load config.json patches)
    • packages/core/src/config/config.ts (final RuntimeConfig shape used by UI/runtime)
  • /config UI overlay
    • packages/core/src/tui/config/ConfigDialog.tsx (reads effective config + writes patches)
    • packages/core/src/tui/config/constants.ts / packages/core/src/tui/config/reducer.ts / packages/core/src/tui/config/ui.tsx
    • packages/core/src/screens/REPL.tsx (mount overlay + reload runtime config on exit)
  • Runtime wiring (effects)
    • Prompt injection: packages/core/src/features/repl/controller/send/sendMainTurn.ts + packages/core/src/features/repl/controller/session/localCommandInjection.ts + packages/core/src/prompts/reminders/*
    • Request parameters: packages/core/src/chat/engine.ts → packages/core/src/streaming/**
    • UI-only flags: packages/core/src/screens/REPL.tsx and small helpers under packages/core/src/screens/repl/*
  • Current /config subset
    • packages/core/src/features/commands/configDialogService.ts currently owns outputStyle, thinkingMode, verboseOutput

Current Behavior Checkpoints

  • Classify each setting before coding:
    • prompt-affecting
    • request-parameter
    • UI-only
  • Storage rule:
    • User scope -> $FORMAX_CONFIG_DIR/config.json
    • Project scope -> <repo>/.formax/config.json
    • Prefer sparse writes; do not persist defaults just because a dialog touched them
  • Immediate effect:
    • /config saves are expected to reload effective runtime config in-process
    • avoid "restart required" behavior unless that is an explicit change
  • Exit-message contract:
    • unchanged dialog -> Status dialog dismissed
    • changed setting -> Set <field> to <value> style subline

Minimal Workflow

  1. Classify the setting first: prompt-affecting, request-parameter, or UI-only.
  2. Update the config settings contract first; if env names or classification changed, also update docs/environment-variables.md.
  3. Change schema / resolve / persist before changing dialog wiring or runtime effects.
  4. Preserve sparse writes and immediate in-process reload behavior.
  5. Only output-style style changes may inject next-turn local command blocks; non prompt-affecting settings must stay out of model context.
  6. Run the minimum regression set below before review.
Show full SKILL.md (127 more words)Show less

Minimum Regression

  • bun run test -- packages/core/src/config/settings/schema.test.ts packages/core/src/config/settings/resolve.test.ts packages/core/src/config/settings/persist.test.ts
  • bun run test -- packages/core/src/features/commands/configDialogService.test.ts
  • bun run test -- packages/core/src/tui/config/ConfigDialog.test.tsx when dialog UI changes
  • bun run test -- packages/core/src/features/repl/controller/session/localCommandInjection.test.ts packages/core/src/features/repl/controller/send/sendMainTurn.test.ts when prompt-affecting config changes
  • bun run test -- packages/core/src/screens/repl/thinkingBlock.test.tsx when UI-only thinking visibility changes
  • bun run type-check when config shape or runtime wiring changes

Guardrails

  • Do not add new config scopes or extra config files (cache.json, runtime.json, etc.) without an explicit decision.
  • Do not inject next-turn prompt blocks for UI-only or request-only settings.
  • Do not let docs/environment-variables.md and config behavior drift into two separate truths; names live there, merge/persist semantics live in the contract.
  • Do not change dialog copy/spacing/colors unless explicitly requested.
  • Add/extend targeted tests before refactoring config wiring; tests are not the whole spec, but they should lock current persistence semantics first.

© 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-config-settings-workflow of yusifeng/formax.

Open the folder on GitHubat commit 1b0c3f3

Compare with similar skills

Formax Config Settings 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 Config Settings Workflow compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Formax Config Settings Workflow this skillyusifeng/formax194—~1.2kAutomated safety check: PassMIT
Skill Scannergetsentry/skills1k4 repos~2.5kAutomated safety check: WarnApache-2.0
Forensifyalexgreensh/repo-forensics190—~2.5kAutomated safety check: NotesCustom licence
Hol Guardhashgraph-online/hol-guard838—~542Automated safety check: PassApache-2.0
Kesekit Checkcdppcorp/KESE-KIT360—~1.3kAutomated safety check: PassMIT
Setuphashgraph-online/hol-guard838—~443Automated safety check: PassApache-2.0

Similar skills

  • Skill Scanner

    getsentry/skills

    Official

    Scan agent skills for security issues. An agent skill from getsentry/skills.

    1k GitHub starsUsed in 4 repos~2.5k tokens
    SecurityAuto-check: warnings
  • Forensify

    alexgreensh/repo-forensics

    Cross-agent self-inspection of your AI-agent stack. An agent skill from alexgreensh/repo-forensics.

    190 GitHub stars~2.5k tokensUpdated 13 days ago
    SecurityAuto-check: notes
  • Hol Guard

    hashgraph-online/hol-guard

    Run HOL Guard scanner and guard operations via uv run hol-guard.

    838 GitHub stars~542 tokensUpdated today
    SecurityAuto-check passed
  • Kesekit Check

    cdppcorp/KESE-KIT

    Run a pre-deployment security compliance checklist based on KISA guidelines.

    360 GitHub stars~1.3k tokensUpdated 6 mo ago
    SecurityAuto-check passed
  • Setup

    hashgraph-online/hol-guard

    Install or initialize HOL Guard local runtime protection for Claude Code.

    838 GitHub stars~443 tokensUpdated today
    SecurityAuto-check passed
  • Clawscan CLI

    openclaw/clawscan

    A skill your agent uses when running or explaining the ClawScan CLI, including one-off agent-skill scans, benchmark runs, scanner fixtures, judge harness commands, env var validation, and…

    143 GitHub stars~3k tokensUpdated 2 days ago
    SecurityAuto-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…

    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
  • 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
  • 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
  • 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 Config Settings Workflow

What does Formax Config Settings Workflow do?

A skill your agent uses when implementing or extending /config (storage, prompt injection, request params, UI-only toggles) with tests and strict UI parity. Formax Config Settings Workflow is an agent skill from yusifeng/formax. Use when implementing or extending /config (storage, prompt injection, request params, UI-only toggles) with tests and strict UI parity.

When should I use Formax Config Settings Workflow?

Formax Config Settings Workflow fits situations like: extending /config (storage; prompt injection; UI-only toggles) with tests and strict UI parity.

How do I install Formax Config Settings Workflow in Claude Code?

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

How do I install Formax Config Settings Workflow in Codex?

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

Can I use Formax Config Settings 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-config-settings-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-config-settings-workflow, .gemini/skills/formax-config-settings-workflow, .github/skills/formax-config-settings-workflow and .opencode/skills/formax-config-settings-workflow in your project.

What does Formax Config Settings Workflow need to run?

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

Does Formax Config Settings 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 Config Settings 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 Config Settings Workflow use?

Formax Config Settings 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 Config Settings Workflow use?

About 1.2k tokens (SKILL.md is roughly 4.8k 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 Config Settings Workflow?

Skills that share tags, products or a category with Formax Config Settings Workflow: Skill Scanner (getsentry/skills, 1k stars), Forensify (alexgreensh/repo-forensics, 190 stars), Hol Guard (hashgraph-online/hol-guard, 838 stars) and Kesekit Check (cdppcorp/KESE-KIT, 360 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

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