mcpField
V
validator-commit

validator-commit

github.com/codagent-aiTesting & quality3064 installsUpdated 1d ago
Repository

About validator-commit

validator-commit is a skill for commits that explicitly include an Agent Validator decision. It detects applicable gates, runs full validation or checks only, skips validation when requested, and proceeds to commit according to the result.

Key features

  1. 01Detects applicable validation gates
  2. 02Supports full or checks-only runs
  3. 03Allows explicit validation skip
  4. 04Commits after validation flow

Use cases

  1. 01Committing after all validation gates pass
  2. 02Running checks only before a commit
  3. 03Skipping validator state as part of a commit

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/codagent-ai/agent-validator --skill validator-commit

After installing, type/validator-commitin Claude Code to confirm it loaded.

Details

From the project README

/validator-commit $ARGUMENTS

Commit with explicit validator validation intent. Runs agent-validate detect first, validates based on intent (full run, checks only, or skip), handles failures, then commits.

Invocation Policy

Use this skill only when the user explicitly asks to involve Agent Validator in the commit flow, including full validation, checks-only validation, or intentionally skipping validator state as part of the commit.

Do not choose this skill for a plain "commit", "make a commit", or "commit these changes" request that does not mention validator, gauntlet, checks, validation, or skip.

Step 1 - Detect Changes

Run agent-validate detect using Bash:

agent-validate detect 2>&1; echo "DETECT_EXIT:$?"

Check the exit code from the DETECT_EXIT: line:

  • Exit 0 → gates would run, continue to Step 2
  • Exit 2 → no gates would run (no changes or no applicable gates), skip to Step 4 (commit directly)
  • Exit 1 → error, report the error to the user and stop
  • Any other exit code → treat as error, report output to the user, and stop

Step 2 - Determine Validation Intent

Parse $ARGUMENTS for a validation intent. Do not prompt the user if a clear intent is found.

ARGUMENTS patternAction
Contains "check" or "checks"Invoke /validator-check (Step 3b)
Contains "run", "full", or "all gates"Invoke /validator-run (Step 3a)
Contains "skip"Run agent-validate skip 2>&1 (Step 3c), then go to Step 4
Empty or no clear intentPresent the three choices below to the user, wait for selection

Evaluate the "check" or "checks" pattern before the generic "run" pattern, so phrases like "run checks before commit" select /validator-check.

When prompting the user, present these choices:

  1. Run all gates — full validation (checks + reviews)
  2. Run checks only — checks without AI reviews
  3. Skip validator — advance baseline without running any gates

Then proceed to the step matching the user's selection.

Step 3a - Full Validation (validator-run)

Invoke /validator-run.

  • If it passes → go to Step 4
  • If it fails → the /validator-run skill handles fixing and re-running. After that skill completes, ask the user: "Ready to commit?". Proceed to Step 4 only on confirmation.

Step 3b - Checks-Only Validation (validator-check)

Invoke /validator-check.

  • If it passes → go to Step 4
  • If it fails → the /validator-check skill handles fixing and re-running. After that skill completes, ask the user: "Ready to commit?". Proceed to Step 4 only on confirmation.

Step 3c - Skip Validation

Run:

agent-validate skip 2>&1

Report the command output to the user, then go to Step 4.

Step 4 - Commit

Check whether you have a skill for committing git changes available (excluding validator-commit itself to avoid self-invocation).

  • If a commit skill is found → invoke that skill to perform the commit
  • If no commit skill is found → stage all tracked changes, propose a commit message following the conventional commits format (<type>: <description>), then run git commit -m "<message>"

Comments

Markdown supported