agentleFS
BSSE23047BSSE23047/nauraiz-dev/skills/gate/SKILL.md

gate

Skill2 starsChanged 14 days agoMITView on GitHub

Run the project's gate (its configured build, test and check commands) and report the real exit codes: before a report, a commit or a PR, or when asked to run the checks. Not for writing or fixing tests, or for one ad-hoc command.

32 other projects use a version of this.

Adopted by

Most recently taken up by

Used with

Projects with it also use new, build and 6 more.

Other files people use alongside this one.

Files found in the same public projects as a version of this one, more often than they turn up anywhere else. Each project counts once, large collections count for less, and this file's own repository is left out.
  • codebycoreySkill

    new

    Start a new change with a proposal. Use when starting a feature, creating a proposal, or beginning planned work.

    Also in 3 projects that use this

  • Microsoft AzureSkill

    build

    Build the TypeSpec Rust emitter from source. Run this after cloning the repo, after pulling changes, or when TypeScript source files have been modified.

    Also in 5 projects that use this

  • genomewalkerSkill

    checkpoint

    Save a checkpoint of task status, decisions, active files, and next steps

    Also in 3 projects that use this

  • VercelSkill

    investigate

    Investigate an issue report, or analyze the constraints of a proposed change, with strict, evidence-driven diagnosis.

    Also in 3 projects that use this

  • BlockSkill

    plan

    Draft a TDD, PRD, or lightweight plan in the conversation without committing it.

    Also in 4 projects that use this

  • GitHubSkill

    refactor

    Surgical code refactoring to improve maintainability without changing behavior. Covers extracting functions, renaming variables, breaking down god functions, improving type safety, eliminating code smells, and applying design patterns. Less drastic than repo-rebuilder; use for gradual improvements.

    Also in 3 projects that use this

The file

We split this skill into the rules it gives an agent

3 rules. 0 are common, 2 are distinctive, and 1 is very specific to this project.

  • 0

    Common

    Most of the 30 edited versions we read keep these.

  • 2

    Distinctive

    This author's own choices. Worth a look.

  • 1

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Very specific:

    Run node "${CLAUDE_PLUGIN_ROOT}/scripts/gate/run.mjs" exactly like that, forward slashes included, once, from any folder in the project.

    line 15
  2. Distinctive:

    Never re-run a gate command by hand, pipe it or grep it, unless the runner reported that command failed.

    line 36
  3. Distinctive:

    Never call anything green that failed or did not run.

    line 39

“Common” is measured: kept by at least 6 in 10 of the 30 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

gate

One call runs every gate command and reads each real exit code. A command that exits 0 but prints failures (Tests 1 failed, # fail 2) is marked failed. Trust the runner, not a summary line.

"Stop" means: end your turn with the report and wait.

  1. Run node "${CLAUDE_PLUGIN_ROOT}/scripts/gate/run.mjs" exactly like that, forward slashes included, once, from any folder in the project; it prints every command's exit code itself, so never append echo $?, pipes or cd. Re-run only after you changed code, or once with --plan <path> when a row says no plan for this branch. Add --plan <path> when you know the task's plan (relative paths are relative to the project root; without it the runner looks for the plan of the current branch). Add --only <name,name> only when asked for some of the commands. The first stderr line, nauraiz-dev gate: project root <dir>, says where it ran.
  2. A nauraiz-dev: line printed before the table names a config problem: quote it in the report whatever the exit code. Read the exit code:
    • 0: every command passed.
    • 1: at least one failed: a non-zero exit, or exit 0 but output reports failures. A row failed with no plan for this branch (pass --plan) was not run: if a plan for this task exists, run again with --plan <path>; otherwise report it failed.
    • 2: quote every nauraiz-dev: line it printed first. If any line other than no gate configured … names a config file, the config failed to load: say the file needs fixing, not that there is no gate, and stop. Otherwise no gate is configured: say so, point to /nauraiz-dev:init (it detects the gate commands), and stop.
    • 3: the runner itself failed (nauraiz-dev: gate runner failed: …). Quote its output and stop. Any other non-zero exit: the same.
  3. Paste the runner's output verbatim (the table and every block), then one line: Gate: pass or Gate: FAIL (<names>).
  4. Never re-run a gate command by hand, pipe it or grep it, unless the runner reported that command failed; then run only that one, only to find the cause. A by-hand run is never the gate result: after a fix, run the runner again.
  5. Never call anything green that failed or did not run. Called on its own: stop after the report. Called from another skill: hand the result back to it.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.