---
name: Formax Skill Capture
slug: formax-skill-capture
category: AI Engineering
description: Formax Skill Capture turns a finished Formax workflow into a repo-local Codex skill under .codex/skills. Use it to scaffold the skill, document file changes, guardrails, and the minimum regression tests.
github: "https://github.com/yusifeng/formax/tree/main/.codex/skills/formax-skill-capture"
language: TypeScript
stars: 192
forks: 7
install: "npx degit https://github.com/yusifeng/formax/tree/main/.codex/skills/formax-skill-capture ~/.claude/skills/formax-skill-capture"
installs_to: ~/.claude/skills/formax-skill-capture
source_path: .codex/skills/formax-skill-capture/SKILL.md
collection_size: 22
category_size: 3278
collection_url: "https://dirskills.com/collections/yusifeng/formax"
added: 2026-09-06T05:19:19.584Z
last_synced: 2026-09-06T05:19:19.584Z
canonical_url: "https://dirskills.com/skills/formax-skill-capture"
---

# Formax Skill Capture

Formax Skill Capture turns a finished Formax workflow into a repo-local Codex skill under .codex/skills. Use it to scaffold the skill, document file changes, guardrails, and the minimum regression tests.

**Install:**

```bash
npx degit https://github.com/yusifeng/formax/tree/main/.codex/skills/formax-skill-capture ~/.claude/skills/formax-skill-capture
```

## README

# 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