mcpField
C
check

check

github.com/jsmastery-proTesting & quality1.6k4.4k installsUpdated 12w ago
Repository

About check

check is an Agent Skill that helps engineers verify a change at runtime, review a diff, or do both before merging. Its two modes keep execution checks separate from read-only code review.

Key features

  1. 01Run the application to verify behavior against its spec
  2. 02Review diffs with a different model
  3. 03Rank review findings by severity
  4. 04Keep verification and review as separate modes

Use cases

  1. 01Check a feature against its acceptance criteria
  2. 02Review a diff before opening a PR
  3. 03Run verification before requesting a code review

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/jsmastery-pro/skills --skill check

After installing, type/checkin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

review-agent-prompt.md
review-guide.md
agents/
openai.yaml
modes/
review.md
verify.md

Details

From the project README

Output style (plain words, no dashes, no hyphens)

Write everything this skill produces, files and messages alike, in plain simple language. Talk to the reader as you, warm and direct like a colleague, and present every step as a recommendation they may run or skip, never an order. Keep technical terms that carry real meaning; explain each in plain words. Never use a dash or a hyphen as punctuation: no em dash, no en dash, and no hyphenated compounds. Write read only, not read-only. Say it in simple words, or reword the sentence. Code, file paths, command flags, and values other skills match on keep their hyphens. Use short sentences, commas, or parentheses. Clear beats clever.

What this skill does

/check is the gate before merge. Two modes, separate jobs, usually both, verify first:

  • verify (runtime proof): run the real app and watch the change behave. Proves it works and conforms to the spec (every acceptance criterion met, every specced surface built), which green tests never reveal. Read only on code, no durable files, main thread. Typically after /develop.
  • review (fresh model code review): a senior read of the diff on a different model than wrote the code (a model reviewing its own output shares its blind spots). Writes findings ranked by severity to docs/reviews/. Read only. Typically before a PR.

Neither mode edits code. verify points failures at /debug or /develop; review reports findings to fix.

Pick the mode (route before doing anything else)

First step, before reading any mode file or touching the repo. Look at what followed /check:

  • Starts with verify (or run) → read modes/verify.md, follow it fully. Pass remaining arguments (feature name, scope) through.
  • Starts with review → read modes/review.md, follow it fully. Pass the steering through unchanged (e.g. /check review with opus, /check review uncommitted).
  • No mode word, or ambiguous (bare /check, or a feature name with no mode like /check auth) → do NOT guess, do NOT default. Show the two options as a plain text panel and stop and wait for the engineer's choice.

How to present the choice (plain text, works on every agent, no interactive modal):

Print exactly this, then stop and wait. Do not assume verify until they answer. Route on their typed word (verify / review / both).

Which check do you want to run? Type one:
  • verify  run the real app and prove the change works against its spec (usually right after /develop)
  • review  a fresh model senior read of the diff, ranked findings (usually right before a PR)
  • both    verify first, then review

No interactive picker or modal: a typed choice shown inline behaves the same in every AI tool. (The argument-hint frontmatter also surfaces verify | review in Claude Code autocomplete; other tools ignore it, which is why this inline panel is the portable path.)

If a feature name came with no mode (/check auth), carry it as the target once they pick; still ask the mode.

Do not mix modes in one run. On both, do verify first, then offer review next.

Portability (any OS, any agent)

Any Agent Skills client on macOS, Linux, or Windows. git is the only required CLI. Other shell snippets are POSIX reference, not literal scripts: use your agent's own cross platform file, process, and browser tools. Each mode file adds its own portability notes. No subagent support falls back to inline, noted per mode.

Bundled files: modes/verify.md, modes/review.md, plus review-agent-prompt.md and review-guide.md for review. Read only the mode file you routed to; resolve the review bundled files to absolute paths when spawning the reviewer.

Comments

Markdown supported