go-spec-reviewer

Review Go design specifications for completeness and idiomatic implementation readiness.

356|26|Updated Mar 23, 2026
One-click install
npx skills add https://github.com/spf13/go-skills --skill go-spec-reviewer
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: go-spec-reviewer
Source: https://github.com/spf13/go-skills/tree/main/go-spec-reviewer
Command: npx skills add https://github.com/spf13/go-skills --skill go-spec-reviewer

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps teams review Go design specifications before implementation so they can catch missing requirements, contradictions, and overengineered ideas early.

Core Features & Use Cases

  • Pre-implementation review: Checks whether a Go spec is complete, consistent, and ready to turn into code.
  • Idiomatic Go guidance: Evaluates simplicity, small interfaces, explicit errors, context propagation, concurrency choices, and package design through a Go-first lens.
  • CLI-aware review: Applies Cobra and Viper conventions when the spec touches command-line tools, including command registration and flag design.
  • Use case: A developer shares a feature design doc and wants a fast verdict on whether it is safe and practical to build.

Quick Start

Ask for a Go spec review of the attached design document and request approval or blocking issues before implementation begins.

Frequently Asked Questions about go-spec-reviewer

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

FAQPage Schema
How do I review a Go design specification for completeness before coding?▼

To review a Go design specification for completeness, you can submit your pre-build design doc to validate requirements, check for contradictions, and ensure the spec is ready for idiomatic implementation.

What is idiomatic Go design validation for a feature spec?▼

Idiomatic Go design validation evaluates your specification through a Go-first lens, verifying simplicity, small interfaces, explicit errors, context use, concurrency choices, and package design before development starts.

Can I validate Cobra and Viper conventions in a CLI tool design doc?▼

Yes, you can validate Cobra and Viper conventions in a CLI tool design doc. The review applies specific checks for command registration and flag design when the specification touches command-line tools.

Does Go spec review check context propagation and concurrency choices?▼

Yes, Go spec review explicitly checks context propagation and concurrency choices. It evaluates these architectural elements against idiomatic Go practices to ensure your design is safe and practical to build.

When do I need a pre-implementation review for a Go service?▼

You need a pre-implementation review for a Go service when you want to catch missing requirements and architectural flaws early. It provides a fast verdict on whether your design doc is ready to turn into code.

What are the limitations of automated Go spec review?▼

Automated Go spec review focuses on architectural readiness and idiomatic practices like package boundaries and error handling, but cannot verify business logic correctness or replace actual code execution testing.