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.