Agent skill

Formax Slash Command Workflow

by yusifeng in yusifeng/formax

A skill your agent uses when adding/modifying Formax slash commands (/permissions /agents /hooks /todos etc), especially output rendering (command sublines), overlay dismiss messages, and whether…

MITAuto-check passedAgent Workflows

Install Formax Slash Command Workflow

skills CLI
$ npx skills add yusifeng/formax --skill formax-slash-command-workflow -a claude-code

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

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

At a glance

A skill your agent uses when adding/modifying Formax slash commands (/permissions /agents /hooks /todos etc), especially output rendering (command sublines), overlay dismiss messages, and whether…

  • Works in 4 steps: Command discovery + dispatch → Command result contract (UI vs model) → Overlay dismissal “subline output” → …
  • Adding/modifying Formax slash commands (/permissions /agents /hooks /todos etc)
  • SKILL.md covers Goal, Read First, Code Map and High-Signal Patterns, plus 3 more sections
  • Calls bun

What it does

Formax Slash Command Workflow is an agent skill from yusifeng/formax. Use when adding/modifying Formax slash commands (/permissions /agents /hooks /todos etc), especially output rendering (command sublines), overlay dismiss messages, and whether outputs are injected into the next LLM turn.

Its SKILL.md is about 1k 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 Agent Workflows, covering Hooks and plugins. 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

  • Adding/modifying Formax slash commands (/permissions /agents /hooks /todos etc)
  • Especially output rendering (command sublines)
  • Overlay dismiss messages
  • Whether outputs are injected into the next LLM turn

Example prompts

  • “/formax-slash-command-workflow”

Workflow steps

4 steps, taken from the step headings in SKILL.md.

  1. Command discovery + dispatch
  2. Command result contract (UI vs model)
  3. Overlay dismissal “subline output”
  4. REPL message plumbing + rendering

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 Slash Command Workflow loads about 1k tokens when it runs. Until then it costs about 63 tokens; SKILL.md has 363 words of instructions outside code blocks.

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

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). 363 words, ~1,034 tokens.

Download SKILL.mdSave it as .claude/skills/formax-slash-command-workflow/SKILL.md (or your agent's skills folder).
name
formax-slash-command-workflow
description
Use when adding/modifying Formax slash commands (/permissions /agents /hooks /todos etc), especially output rendering (command sublines), overlay dismiss messages, and whether outputs are injected into the next LLM turn.

Formax slash command workflow

Goal

Use this skill when changing slash command discovery, dispatch, overlay dismissal output, or next-turn injection behavior.

Read First

  • docs/contracts/slash-command-contract.md
  • docs/contracts/semantics-contract.md when command behavior crosses canonical UI messages or routing
  • docs/contracts/config-settings-contract.md when the change touches /config

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

Code Map

1) Command discovery + dispatch
  • packages/core/src/features/commands/registry.ts: command list/suggest/dispatch wiring
  • packages/core/src/features/commands/CommandStore.ts: disk scanning + precedence (project overrides user)
  • packages/core/src/features/semantics/core/commandRouting.ts: exact /clear / /compact and command-dispatch routing boundary
2) Command result contract (UI vs model)
  • packages/core/src/features/commands/contracts.ts: UiEffect / UiMessage / ModelEffect shapes
  • packages/core/src/features/commands/adapter.ts: maps command execution output → CommandResult
  • packages/core/src/features/repl/controller/send/send.ts: consumed slash handling, local_async, and injected-block plumbing
3) Overlay dismissal “subline output”
  • packages/core/src/features/repl/controller/ui/overlays.ts: overlay open/close + append “dismissed” sublines
4) REPL message plumbing + rendering
  • packages/core/src/features/repl/controller/send/send.ts: applies UiEffect.appendMessages to Msg
  • packages/core/src/screens/REPL.tsx: render msg.ui.kind === 'command_subline' as ⎿ ... (no ⏺)
  • packages/core/src/screens/REPL.slashSuggestions.test.tsx: duplicate command selection / preferredSlashSpecId

High-Signal Patterns

  • Pattern A: one-line overlay dismissal
    • append a single assistant Msg with ui.kind='command_subline'
    • keep copy stable unless the user explicitly requests copy changes
  • Pattern B: multi-line local output
    • split output into multiple command_subline rows
    • this is UI only; model injection remains separately controlled
  • Pattern C: inject-but-don't-spam
    • when a command needs to inform the model, keep UI output minimal and preserve recordForNextTurn / injected-block behavior separately
Show full SKILL.md (161 more words)Show less

Minimal Workflow

  1. Classify the change first: discovery / precedence, local UI output, next-turn injection, or overlay dismiss behavior.
  2. Update the slash command contract first.
  3. Preserve “show in UI” vs “inject into model context” as separate concerns; local output alone must not imply injection.
  4. Use command_subline for Claude-style sublines; do not invent new message shapes.
  5. Run the minimum regression set below before review.

Minimum Regression

  • bun run test -- packages/core/src/features/commands/registry.test.ts packages/core/src/features/commands/CommandStore.test.ts packages/core/src/features/commands/adapter.test.ts packages/core/src/features/commands/contracts.test.ts
  • bun run test -- packages/core/src/features/repl/controller/ui/overlays.test.tsx
  • bun run test -- packages/core/src/features/repl/controller/send/send.test.ts packages/core/src/features/repl/useReplController.test.tsx
  • bun run test -- packages/core/src/screens/REPL.slashSuggestions.test.tsx packages/core/src/screens/repl/inputHint.test.ts
  • bun run type-check when command shapes or routing plumbing changes

Guardrails

  • Do not add bespoke commandSubLines-style structures; use Msg.ui.kind='command_subline'.
  • Do not change UI copy / spacing / colors as a side-effect of routing changes.
  • Do not patch only overlay output if the real bug is discovery or dispatch precedence.
  • If behavior is unclear, add or extend an Ink test first; tests are not the only spec, but they should lock the visible key path.

© 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-slash-command-workflow of yusifeng/formax.

Open the folder on GitHubat commit 1b0c3f3

Compare with similar skills

Formax Slash Command 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 Slash Command Workflow compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Formax Slash Command Workflow this skillyusifeng/formax195—~1kAutomated safety check: PassMIT
Hook Development for Claude Code Pluginsanthropics/claude-plugins-official38k10 repos~4.1kAutomated safety check: NotesApache-2.0
Claude Code Agent Developmentanthropics/claude-plugins-official38k7 repos~2.8kAutomated safety check: PassApache-2.0
Claude Code Skill Developer Guidediet103/claude-code-infrastructure-showcase10k11 repos~3.5kAutomated safety check: PassMIT
Plugin Settings Patternanthropics/claude-plugins-official38k7 repos~3kAutomated safety check: PassApache-2.0
MCP Integration for Pluginsanthropics/claude-plugins-official38k11 repos~3.1kAutomated safety check: PassApache-2.0

Similar skills

  • Hook Development for Claude Code Plugins

    anthropics/claude-plugins-official

    Official

    Explains how to write Claude Code plugin hooks, both prompt-based checks and bash commands, for events such as PreToolUse, Stop and SessionStart.

    38k GitHub starsUsed in 10 repos~4.1k tokens
    Agent WorkflowsAuto-check: notes
  • Claude Code Agent Development

    anthropics/claude-plugins-official

    Official

    Explains how to write agents for Claude Code plugins: the markdown file with YAML frontmatter, trigger descriptions, model and color settings, and system prompt design.

    38k GitHub starsUsed in 7 repos~2.8k tokens
    Agent WorkflowsAuto-check passed
  • Claude Code Skill Developer Guide

    diet103/claude-code-infrastructure-showcase

    A guide to creating and managing Claude Code skills with auto-activation: skill-rules.json triggers, hooks, enforcement levels, YAML frontmatter and progressive disclosure.

    10k GitHub starsUsed in 11 repos~3.5k tokens
    Agent WorkflowsAuto-check passed
  • Plugin Settings Pattern

    anthropics/claude-plugins-official

    Official

    Shows how Claude Code plugins keep per-project settings and state in .claude/plugin-name.local.md files with YAML frontmatter and a markdown body.

    38k GitHub starsUsed in 7 repos~3k tokens
    Agent WorkflowsAuto-check passed
  • MCP Integration for Plugins

    anthropics/claude-plugins-official

    Official

    Explains how to bundle Model Context Protocol servers in a Claude Code plugin, covering config files, stdio, SSE, HTTP and WebSocket server types, and authentication.

    38k GitHub starsUsed in 11 repos~3.1k tokens
    Agent WorkflowsAuto-check passed
  • Claude Code Command Development

    anthropics/claude-plugins-official

    Official

    Explains how to write Claude Code slash commands: Markdown files with YAML frontmatter, arguments, file references, bash context and interactive prompts.

    38k GitHub starsUsed in 10 repos~4.8k tokens
    Agent WorkflowsAuto-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
  • 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

Categories

Questions about Formax Slash Command Workflow

What does Formax Slash Command Workflow do?

A skill your agent uses when adding/modifying Formax slash commands (/permissions /agents /hooks /todos etc), especially output rendering (command sublines), overlay dismiss messages, and whether…. Formax Slash Command Workflow is an agent skill from yusifeng/formax. Use when adding/modifying Formax slash commands (/permissions /agents /hooks /todos etc), especially output rendering (command sublines), overlay dismiss messages, and whether outputs are injected into the next LLM turn.

When should I use Formax Slash Command Workflow?

Formax Slash Command Workflow fits situations like: adding/modifying Formax slash commands (/permissions /agents /hooks /todos etc); especially output rendering (command sublines); overlay dismiss messages; whether outputs are injected into the next LLM turn.

How do I install Formax Slash Command Workflow in Claude Code?

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

How do I install Formax Slash Command Workflow in Codex?

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

Can I use Formax Slash Command 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-slash-command-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-slash-command-workflow, .gemini/skills/formax-slash-command-workflow, .github/skills/formax-slash-command-workflow and .opencode/skills/formax-slash-command-workflow in your project.

What does Formax Slash Command Workflow need to run?

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

Does Formax Slash Command 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 Slash Command 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 Slash Command Workflow use?

Formax Slash Command 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 Slash Command Workflow use?

About 1k tokens (SKILL.md is roughly 4.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 Slash Command Workflow?

Skills that share tags, products or a category with Formax Slash Command Workflow: Hook Development for Claude Code Plugins (anthropics/claude-plugins-official, 38k stars), Claude Code Agent Development (anthropics/claude-plugins-official, 38k stars), Claude Code Skill Developer Guide (diet103/claude-code-infrastructure-showcase, 10k stars) and Plugin Settings Pattern (anthropics/claude-plugins-official, 38k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

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