Stage Review Skill | Agent Skills

Stage Review

Overview

Use this as the finished-feature workflow: inspect changes, verify locally, stage explicit files, create a Conventional Commit, push through no-mistakes, attach to the run, fix findings, rerun, and let no-mistakes perform the real upstream push/PR only after the gate passes.

Core Rules

Never use git push origin in this workflow.
Never force-push.
Do not stage with git add .; use explicit paths or the bundled script's --all only after the user explicitly wants all current changes included.
Stop before committing on protected or detached branches.
Ask before any remote-affecting command, including git push no-mistakes.
Use Conventional Commits: feat|fix|refactor|build|ci|chore|docs|style|perf|test.
Prefer repo-local check commands from .no-mistakes.yaml, justfile, package.json, Makefile, go.mod, Cargo.toml, or equivalent project config.
Quote exact local check and pipeline errors before diagnosing.

Workflow

1. Preflight

Resolve scripts/stage_review.py relative to this skill folder, then run:

python3 <skill-dir>/scripts/stage_review.py --cwd . plan
python <skill-dir>/scripts/stage_review.py --cwd . plan

Also run:

git status --short --branch
git diff --stat

Stop and ask if:

branch is protected or detached
merge/rebase/cherry-pick is in progress
changed files include unrelated work
no origin exists
no no-mistakes remote exists and no-mistakes init has not been approved

2. Local Checks

Run the repo's real local checks before staging. Prefer explicit commands from .no-mistakes.yaml:

commands:
  test: "..."
  lint: "..."
  format: "..."

If no config exists, inspect repo-local command surfaces and choose the canonical one. Examples:

just test, just lint, just fmt
make test, make lint, make fmt
pnpm test, pnpm lint, pnpm typecheck
go test ./..., go vet ./...
cargo test, cargo clippy --all-targets -- -D warnings

Do not commit if relevant local checks fail unless the user explicitly wants a broken checkpoint.

3. Stage And Commit

Pick the Conventional Commit subject from the actual diff:

feat(scope): concise summary
fix(scope): concise summary
refactor(scope): concise summary

Stage explicit files:

python3 <skill-dir>/scripts/stage_review.py --cwd . commit \
  -m "feat(scope): concise summary" \
  --body "Tests: <commands run>" \
  path/to/file1 path/to/file2

Use all changed files only when the user explicitly confirms all changes belong in the feature:

python3 <skill-dir>/scripts/stage_review.py --cwd . commit \
  -m "feat(scope): concise summary" \
  --body "Tests: <commands run>" \
  --all

4. Push Through no-mistakes

Confirm the exact command first:

Ready to push <branch> through no-mistakes:
git push no-mistakes <branch>

After confirmation:

git push no-mistakes <branch>
no-mistakes

5. Review/Verify/Fix Loop

For each no-mistakes finding:

identify the step: rebase, review, test, document, lint, push, pr, or ci
quote the exact finding/error
fix code/config only when the user wants you to fix it
run targeted local verification after fixing
commit follow-up fixes with the same script
run no-mistakes rerun or continue/attach as appropriate

Useful commands:

no-mistakes status
no-mistakes runs --limit 10
no-mistakes attach
no-mistakes rerun

6. Done Criteria

Finish only when you can report:

local checks run and result
commit SHA and Conventional Commit subject
no-mistakes run state
PR URL if created/updated
CI state if available
remaining blockers, if any

Agent Skills: Stage Review

Install this agent skill to your local

Skill Files