Critical: Security issues, crashes, data loss - must fix
Warning: Bugs, anti-patterns, maintenance concerns - should fix
Suggestion: Style, optimization, minor improvements - nice to have
Positive: Good practices worth highlighting
Converted and distributed by TomeVault — claim your Tome and manage your conversions.
1---2name: asteroid-belt-skulto-golang-cli-review3description: Go CLI Code Review4---56# Go CLI Code Review78Review Go CLI applications and produce an actionable checklist of findings.910## Review Workflow11121. **Gather code** - Read all Go files in the CLI project132. **Analyze** - Evaluate against review categories (see below)143. **Produce checklist** - Use template from [references/review-checklist.md](references/review-checklist.md)1516## Review Categories1718Evaluate each area systematically:1920### CLI Structure & Framework21- Framework usage (prefer Cobra for complex CLIs)22- Command hierarchy and discoverability23- Help text quality with examples24- Version command following semver2526### Error Handling27- RunE vs Run (must return errors)28- Error wrapping with `%w` and context29- User-facing error actionability30- Meaningful exit codes (0=success, 1=error, 2=usage)31- No panics in normal paths3233### Flag & Argument Design34- Lowercase-kebab-case naming35- Short flags for common options (`-v`, `-o`, `-q`)36- Required flags marked and validated early37- Sensible defaults38- Clear descriptions3940### Input/Output41- stderr for errors/progress, stdout for data42- Machine-readable output support (`--json`, `--format`)43- Quiet and verbose mode support44- Non-TTY mode handling (no prompts)4546### Security47- Secrets via env vars or files, never flags48- Path traversal prevention49- No shell injection50- URL scheme validation51- No sensitive data in logs5253### Testing54- Command-level unit tests55- Error path coverage56- Integration tests for critical flows5758### Performance & Resources59- Context-based cancellation60- Signal handling (SIGINT/SIGTERM)61- Proper resource cleanup (defer)62- No goroutine leaks6364### Go Idioms65- Effective Go style compliance66- Immediate error handling67- Package naming conventions68- Interface/struct patterns6970## Reference Material7172For patterns and examples, see [references/cli-patterns.md](references/cli-patterns.md).7374## Output Format7576Use the checklist template from [references/review-checklist.md](references/review-checklist.md):7778```79## Critical Issues80- [ ] **[C1]** `file.go:123` - Description81 - **Impact:** ...82 - **Fix:** ...8384## Warnings85- [ ] **[W1]** `file.go:45` - Description86 - **Why:** ...87 - **Fix:** ...8889## Suggestions90- [ ] **[S1]** `file.go:78` - Description91 - **Consider:** ...9293## Positive Patterns94- **[P1]** `file.go:90` - What was done well95```9697Severity levels:98- **Critical**: Security issues, crashes, data loss - must fix99- **Warning**: Bugs, anti-patterns, maintenance concerns - should fix100- **Suggestion**: Style, optimization, minor improvements - nice to have101- **Positive**: Good practices worth highlighting102103---104> Converted and distributed by [TomeVault](https://tomevault.io/claim/asteroid-belt) — claim your Tome and manage your conversions.105<!-- tomevault:4.0:skill_md:2026-04-11 -->
Run npx skillmds@latest add tomevault-io/asteroid-belt-skulto-golang-cli-review in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.
Go CLI Code Review It is listed under Coding & Dev Tools on SkillMD.
This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.
This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.
Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.
tomevault-io (@tomevault-io) published this skill. Their other Agent Skills are listed on their SkillMD profile.