review

Reviews Go change sets or modules against gokit's eight-pass engineering baseline.

Updated Feb 15, 2026
One-click install
npx skills add https://github.com/kbukum/gokit --skill review-kbukum
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: review
Source: https://github.com/kbukum/gokit/tree/main/.github/skills/review
Command: npx skills add https://github.com/kbukum/gokit --skill review-kbukum

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Code reviews of fast or AI-assisted Go changes often miss structural violations, duplicated concerns, concurrency leaks, and untested behavior. This Skill enforces gokit's standing engineering baseline as a repeatable, independent review so defects in shared foundation code are caught before merge or release. ## Core Features & Use Cases - Eight focused review passes: structure & placement, canonical reuse, principles, security & privacy, quality, tests/TDD, docs & supply chain, and comments & godoc, each with detection commands and severity rules. - Three orchestration drivers: review a change set (branch, commit range, or HEAD~1), audit a whole module or tree, or fan the review into parallel subagent passes that plan and apply fixes. - Severity-classified findings: every issue is reported as blocker, should-fix, or nit with file:line, the violated principle, and a suggested fix. - Use Case: Before merging a branch that touches gokit's resilience package, dispatch this Skill to a fresh reviewer agent to verify layering, canonical reuse, race-clean tests, and coverage gates, then receive a consolidated findings report. ## Quick Start Ask the AI to run the review skill on the current branch diff against origin/main and report all blocker and should-fix findings.

Frequently Asked Questions about review

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

FAQPage Schema
How do I review a Go change set before merging?▼

Dispatch the review skill to a fresh agent with the diff (branch, commit range, or HEAD~1) and the references folder. It runs eight passes in order, stopping at structure or reuse failures, and reports findings as blocker, should-fix, or nit with suggested fixes.

How do I audit a whole Go module instead of a diff?▼

Use the review-project driver, which sweeps an entire module, domain, or tree with the same eight passes in project mode. It runs the full validation gates like make check and govulncheck, and is intended for periodic audits or pre-release sign-off.

Why must the review run in a separate clean-context agent?▼

A reviewer that shares session context with the code's author tends to rationalize the change instead of judging it. An independent agent re-derives every judgment from the code and the baseline principles, which is the core requirement of this skill.

What counts as a blocker finding in a Go code review?▼

Blockers are hard-principle violations: upward or cyclic imports, reimplemented canonical concerns, panic or log.Fatal on runtime paths, goroutines without cancellation, unbounded channels, global mutable registries, unvalidated trust boundaries, public any types, or behavior changes without tests.

Can the review skill also apply the fixes it finds?▼

Yes, the review-details driver fans the review into parallel subagent passes by Go concern, consolidates findings, proposes a fix plan, waits for user confirmation, then applies fixes per commit and re-runs scoped validation after each change.

Does a green lint and test run mean the review passes?▼

No. A green scoped run is necessary but not sufficient. It does not catch goroutine leaks, missing timeouts, unbounded channels, global-registry composition smells, duplicated owners, or boundary-validation gaps, which remain the reviewer's responsibility.