step-gate skill
step-gate turns an ordinary skill into a stepwise one: a program blocks the agent from the next step until the artifact exists.
- 946 ★ on the repository
- Last commit
- Apache-2.0
Extended access
Why this level
- Runs prebuilt binaries from the repository on your machine.
- Rewrites other skills, so the result needs review.
Install
- Works in
In your terminal, with SkillFoxx CLI
npx skillfoxx add skills/step-gateDetects the agents on your machine, shows the access level and pins the version.
Other ways to install
Access and checks
How we reviewExtended accessThe tool runs code or makes network calls and only reads external data.
- Runs prebuilt binaries from the repository on your machine.
- Rewrites other skills, so the result needs review.
This is third-party code. Review the repository files before installing.
What it does
The agent-skill-gate repository contains the `step-gate` skill. It takes an existing skill and breaks it into steps declared in `flow.yaml`, with per-step guides and checks. A step completes only if the program finds the artifact and a record that the instructions were delivered. A skipped step or broken order is rejected with exit code 1. Step state lives in a file that only the program changes: pending, current, done, skipped and failed. Checks can test that a file exists and is non-empty, and branching with "if, else" is supported. Several skills can be chained and the order between them is checked too. Binaries for five platforms are bundled.
Who it is for. Skill authors and teams whose agent skips instruction steps yet reports completion. For those who need a program-level check rather than a plea not to skip.
Good fit when
- A long eight-step skill where the agent jumps to the result.
- Before publishing, a skill is to be turned into a version with mandatory artifacts.
- Two instructions run in sequence and the order between them must hold.
- A missing result file should stop work rather than remain a remark.
Not a fit when
- A two-line skill with no artifacts: there is nothing to split.
- The environment forbids running prebuilt binaries from a repository.
- You want content quality checked: the validators look at files, not meaning.
Example request
Use step-gate to convert my release-notes skill into a stepwise one, describing steps in flow.yaml with artifact checks.Limitations
The skill ships prebuilt executables for macOS, Linux and Windows that run on your machine, so inspect them before enabling. Validators check that files exist, are non-empty and contain given text, but do not judge the meaning of a result. Bypass protection relies on a launcher command whitelist, and admin commands are guarded by an operator token. Documentation is in Chinese. The last commit was in September 2026.
How to disable. Delete the `step-gate` folder from the agent skills directory. Remove `flow.yaml`, step state and chains created in projects by hand.
FAQ
How do I install it?
Copy the `skills/step-gate/` folder into the agent skills directory, for example `~/.claude/skills/step-gate/`. The folder name must not change.
What do I say to the agent afterwards?
The phrase "用 step-gate 改造我的 <skill>". The agent goes through three steps: understand the skill, convert it and verify.
Can a step be skipped?
No. Only the current step can complete, and completion is rejected without a record that the instructions were delivered.
Which platforms are supported?
Binaries exist for windows-x64, linux-x64, linux-arm64, macos-x64 and macos-arm64.
What is the license?
Apache-2.0. The package carries its own `LICENSE.txt` inside `skills/step-gate/`.
Discussion
No questions or reviews yet.
Related
SkillsA skill that keeps an agent off its own hashes, locks and receipts: ship the output first, then verify
A completion-discipline skill for large agent tasks: write the acceptance ledger with runnable checks first, then do the work, then reverify against evidence
A meta-skill that folds rules scattered across AGENTS.md, CLAUDE.md and Cursor files into one project skill with task routes.
A meta-skill that turns a workflow into an agent skill: prior-art search, trigger evaluation and publication to GitHub
Self-learning
self-learning-skills
A meta-skill that saves a hard-won working procedure as a new skill or rule, so the next session starts already knowing it
Skill Flow groups skills from many sources and deploys them to many agents, including Claude Code, Cursor and Codex.
README in short
The README explains how the program enforces step order, shows installation, the conversion command and the directory layout. Test results and the principle of placing content where it is used are given.