gormes-review-scorecard

Score production readiness of changes lacking external review tooling.

9|Updated Apr 19, 2026
One-click install
npx skills add https://github.com/TrebuchetDynamics/gormes-agent --skill gormes-review-scorecard
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gormes-review-scorecard
Source: https://github.com/TrebuchetDynamics/gormes-agent/tree/main/development-skills/gormes-review-scorecard
Command: npx skills add https://github.com/TrebuchetDynamics/gormes-agent --skill gormes-review-scorecard

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Quantifies the production-readiness of changes when external review tooling is unavailable.

Core Features & Use Cases

  • Local, conservative quality gate that indicates whether a change warrants external review
  • Structured scoring with deductions for missing evidence, bugs, or documentation drift
  • Use Case: preflight before gormes-greptile-loop or gormes-release, or when Greptile/CI is not accessible

Quick Start

Run the scorecard against your uncommitted changes or PR to obtain a 1–5 readiness score and required actions.

Frequently Asked Questions about gormes-review-scorecard

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I assess code review readiness when CI or external tooling is unavailable?

A local code review scorecard quantifies production-readiness by applying structured scoring deductions for missing evidence, bugs, or documentation drift. It generates a 1–5 readiness score and required actions, serving as a conservative quality gate when external review tools are inaccessible.

What is a local quality gate for uncommitted Go code changes?

A local quality gate evaluates uncommitted Go changes using a structured scorecard that deducts points for missing required evidence and safety concerns. It outputs a 1–5 readiness score to indicate whether a change warrants further external review before release.

How do I run a preflight check on a Go PR before requesting a Greptile review?

Run the scorecard against your uncommitted changes or PR to obtain a 1–5 readiness score and required actions. This preflight check identifies potential UX, scope, or safety concerns before routing the change to a Greptile loop or release workflow.

Can I use a local code scorecard for changes that have green tests but potential UX concerns?

Yes, the scorecard applies specifically to changes with green tests but potential UX, scope, or safety concerns. It satisfies requirements for required evidence checks and structured scoring deductions, ensuring production-readiness is verified beyond just passing tests.

When should I use a local review scorecard instead of waiting for CI review?

Use a local review scorecard when external review tooling is unavailable, as a preflight check before a release, or when a change has green tests but potential safety concerns. It provides a conservative quality gate to determine if changes warrant external review routing.

Does the code review scorecard require any external dependencies to run?

No, the scorecard runs locally as a standalone quality gate without external dependencies. It quantifies production-readiness by applying structured scoring deductions and required evidence checks directly to your uncommitted changes or PR.