Agent skill

Formax Repomix Handoff Workflow

by yusifeng in 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…

MITAuto-check passedAgent Workflows

Install Formax Repomix Handoff Workflow

skills CLI
$ npx skills add yusifeng/formax --skill formax-repomix-handoff-workflow -a claude-code

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

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

At a glance

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…

  • Preparing a Formax code handoff: selecting files
  • SKILL.md covers Goal, Where to change what, Pack tiers (default taxonomy) and Patterns, plus 2 more sections
  • Runs Shell scripts from its folder; calls bash, bunx and bun
  • Generating repomix bundles

What it does

Formax Repomix Handoff Workflow is an agent skill from yusifeng/formax. Use 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 and validation scope.

Its SKILL.md is about 1.2k tokens, which your agent loads only when the skill is triggered. The skill folder holds 5 other files, including scripts and reference files (for example `references/prompt-templates.md`, `scripts/build-repomix.sh` and `scripts/check-handoff-artifacts.sh`).

It sits in Agent Workflows, covering Codebase knowledge for agents. 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

  • Preparing a Formax code handoff: selecting files
  • Generating repomix bundles
  • Writing a high-quality prompt for WebGPT
  • Another coding agent with clear constraints and validation scope

Example prompts

  • “/formax-repomix-handoff-workflow”

Requirements

  • A Bash shell

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 2 files in scripts/ (Shell), which the agent can run.

    Shell commands in SKILL.md call:

    • bash
    • bunx
    • bun

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use bunx, which can reach the network depending on how they are called.

    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 Repomix Handoff Workflow loads about 1.2k tokens when it runs, and up to ~1.7k if it reads all its reference files. Until then it costs about 58 tokens; SKILL.md has 468 words of instructions outside code blocks.

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

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). 468 words, ~1,154 tokens.

Download SKILL.mdSave it as .claude/skills/formax-repomix-handoff-workflow/SKILL.md (or your agent's skills folder). This skill also uses 3 other files; get the full folder from GitHub.
name
formax-repomix-handoff-workflow
description
Use 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 and validation scope.

formax-repomix-handoff-workflow

Goal

Create a clean handoff package for another AI with:

  • the smallest correct repomix bundle
  • a prompt that matches the target environment
  • explicit acceptance criteria and non-goals
  • predictable artifact naming + validation (so uploads stay consistent)

Where to change what

  • All handoff artifacts live in one folder: repomix-output/
  • Bundle output: repomix-output/repomix-<topic>-<tier>.txt
  • Handoff prompt: repomix-output/<topic>-handoff-prompt.md
  • File manifest notes: repomix-output/repomix-<topic>-files.md
  • Template references: references/prompt-templates.md

Required hygiene: each new pack run must clear previous files in repomix-output/ first, so users can upload that folder as-is without manual file picking.

Pack tiers (default taxonomy)

Use exactly one tier label in bundle filename:

  • minimal: changed runtime files + direct dependencies + adjacent tests.
  • core: minimal + only critical contract/design docs needed for intent.
  • full: broad context pack for deep investigations (cross-subsystem docs/tests).

Example names:

  • repomix-topic-minimal.txt
  • repomix-topic-core.txt
  • repomix-topic-full.txt

Patterns

  1. Classify target runtime first
  • Static consumer (e.g., WebGPT): cannot run local commands or tests.
  • Executable agent (repo access): can run local commands/tests.
  1. Pick a pack tier first (minimal / core / full)
  • Default to minimal.
  • Upgrade to core only when architecture/contracts matter.
  • Use full only when root cause plausibly spans multiple subsystems.
  1. Build the include set for that tier
  • Include changed runtime files + direct dependencies + adjacent tests.
  • Include only docs needed for intent/constraints at the chosen tier.
  • Avoid unrelated folders to keep context small.
  1. Pack with deterministic command (single folder, auto-clean)
sh
bunx repomix . \
  --style plain \
  --no-git-sort-by-changes \
  -o repomix-output/repomix-<topic>-<tier>.txt \
  --include "<comma-separated-file-list>"

Or use the helper script:

sh
bash .codex/skills/formax-repomix-handoff-workflow/scripts/build-repomix.sh \
  repomix-<topic>-<tier>.txt \
  "<comma-separated-file-list>"

The helper script will:

  • create repomix-output/ if missing
  • delete previous files under repomix-output/ (except .gitkeep)
  • write the new bundle into repomix-output/
  1. Write prompt + file manifest with naming convention
  • Prompt: repomix-output/<topic>-handoff-prompt.md
  • Manifest: repomix-output/repomix-<topic>-files.md
  • Always use repo-relative paths in prompt + manifest (no machine absolute paths).
  1. Write prompt with explicit boundaries
  • State known symptoms.
  • State hard constraints (what must not change).
  • Define deliverables (root cause model, options, recommended plan, test/validation matrix).
  • Include acceptance criteria with observable assertions.
Show full SKILL.md (165 more words)Show less
  1. Run artifact validation (required)
sh
bash .codex/skills/formax-repomix-handoff-workflow/scripts/check-handoff-artifacts.sh \
  repomix-<topic>-<tier>.txt \
  <topic>

This check enforces:

  • Bundle/prompt/manifest files all exist.
  • Prompt and manifest reference the current bundle name.
  • Manifest references the prompt filename.
  • Prompt + manifest do not contain local absolute paths.
  1. Sanity-check before handoff
  • repomix-output/ only contains current-round artifacts.
  • Bundle exists and includes the expected files.
  • Prompt has no impossible instructions for the target runtime.
  • Prompt does not ask static consumers to run commands.
  • Naming is topic-driven and consistent across all three artifacts.

See references/prompt-templates.md for copy-ready templates.

Tests to update

  • No repository tests required for creating the handoff itself.
  • If target is executable, include a suggested minimal test list in the handoff prompt.

Guardrails

  • Never include bun run test:coverage in a static-consumer prompt.
  • Never assume the other AI can read files outside the provided bundle unless explicitly attached.
  • Keep asks decision-oriented first (root cause/options) before patch implementation.
  • Prefer concrete acceptance checks over vague goals.
  • Avoid mixing unrelated bugfixes into one handoff package.
  • Never leak machine absolute paths (e.g., /Users/...) in prompt/manifest.

© 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 (scripts, references) in .codex/skills/formax-repomix-handoff-workflow of yusifeng/formax.

  • SKILL.md
  • references/prompt-templates.md
  • scripts/build-repomix.sh
  • scripts/check-handoff-artifacts.sh

Open the folder on GitHubat commit 1b0c3f3

Compare with similar skills

Formax Repomix Handoff 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 Repomix Handoff Workflow compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Formax Repomix Handoff Workflow this skillyusifeng/formax194—~1.2kAutomated safety check: PassMIT
ccc Semantic Code Searchcocoindex-io/cocoindex-code2.8k—~938Automated safety check: PassApache-2.0
Context Engineeringabashev/vfs-s31069 repos~2.6kAutomated safety check: NotesApache-2.0
Repomix Codebase Packeryamadashy/repomix29k—~1.3kAutomated safety check: NotesMIT
Codebase Handbook BuilderRuhan-Wang/Harness_Handbook334—~2.2kAutomated safety check: PassApache-2.0
CodemapJordanCoin/codemap703—~1.8kAutomated safety check: PassMIT

Similar skills

  • ccc Semantic Code Search

    cocoindex-io/cocoindex-code

    Semantic code search and index management with the ccc CLI: the agent initializes, indexes and queries the project by concept, filtering by language or path.

    2.8k GitHub stars~938 tokensUpdated 3 days ago
    Agent WorkflowsAuto-check passed
  • Context Engineering

    abashev/vfs-s3

    Optimizes agent context setup. An agent skill from abashev/vfs-s3.

    106 GitHub starsUsed in 9 repos~2.6k tokens
    Agent WorkflowsAuto-check: notes
  • Repomix Codebase Packer

    yamadashy/repomix

    Packs a local directory or remote GitHub repository into one AI-friendly file with Repomix, then searches it to explore structure, find patterns and count tokens.

    29k GitHub stars~1.3k tokensUpdated today
    Agent WorkflowsAuto-check: notes
  • Codebase Handbook Builder

    Ruhan-Wang/Harness_Handbook

    Generates, refreshes, validates and uses a compact handbook that maps where a change touches in a repository, using the active Codex session and no external LLM API.

    334 GitHub stars~2.2k tokensUpdated 1 mo ago
    Agent WorkflowsAuto-check passed
  • Codemap

    JordanCoin/codemap

    Gives an agent a quick map of a codebase's structure, dependencies, changes and handoffs, and tunes per-project config so the output stays code-first.

    703 GitHub stars~1.8k tokensUpdated 2 days ago
    Agent WorkflowsAuto-check passed
  • Repomix Context Skill

    sopaco/deepwiki-rs

    A skill your agent uses when an agent needs source code from the local repomix index under .terrain/agent/repomix.md (not committed; regenerate via Terrain scan).

    3.1k GitHub stars~671 tokensUpdated 26 days ago
    Agent WorkflowsAuto-check passed

More from yusifeng/formax

All 21 skills in this repo
  • 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
  • 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…

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

Categories

Questions about Formax Repomix Handoff Workflow

What does Formax Repomix Handoff Workflow do?

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…. Formax Repomix Handoff Workflow is an agent skill from yusifeng/formax. Use 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 and validation scope.

When should I use Formax Repomix Handoff Workflow?

Formax Repomix Handoff Workflow fits situations like: preparing a Formax code handoff: selecting files; generating repomix bundles; writing a high-quality prompt for WebGPT; another coding agent with clear constraints and validation scope.

How do I install Formax Repomix Handoff Workflow in Claude Code?

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

How do I install Formax Repomix Handoff Workflow in Codex?

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

Can I use Formax Repomix Handoff 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-repomix-handoff-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-repomix-handoff-workflow, .gemini/skills/formax-repomix-handoff-workflow, .github/skills/formax-repomix-handoff-workflow and .opencode/skills/formax-repomix-handoff-workflow in your project.

What does Formax Repomix Handoff Workflow need to run?

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

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

What licence does Formax Repomix Handoff Workflow use?

Formax Repomix Handoff 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 Repomix Handoff Workflow use?

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

What are the alternatives to Formax Repomix Handoff Workflow?

Skills that share tags, products or a category with Formax Repomix Handoff Workflow: ccc Semantic Code Search (cocoindex-io/cocoindex-code, 2.8k stars), Context Engineering (abashev/vfs-s3, 106 stars), Repomix Codebase Packer (yamadashy/repomix, 29k stars) and Codebase Handbook Builder (Ruhan-Wang/Harness_Handbook, 334 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Formax Repomix Handoff 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.