golang-spf13-cobra
Golang CLI command tree library using spf13/cobra — cobra.Command, RunE vs Run, PersistentPreRunE hook chain, Args validators (NoArgs, ExactArgs, MatchAll, custom), persistent vs local flags, command groups, ValidArgsFunction, RegisterFlagCompletionFunc, ShellCompDirective, usage/help template customization, man-page and markdown doc generation, and testing with SetArgs/SetOut/SetErr. Apply when using or adopting spf13/cobra, or when the codebase imports `github.com/spf13/cobra`. For configuration layering alongside cobra, see the `samber/cc-skills-golang@golang-spf13-viper` skill. For general CLI architecture (project layout, exit codes, signal handling, I/O patterns), see `samber/cc-skills-golang@golang-cli`.
Best for Go CLI developersWorks with GitHubLow risk
⌘source
- author
@samber- language
- Go
★1.5kstars
88forks
May 1, 2026
✦overview.md
Key Features
- ·Command tree with cobra.Command
- ·RunE vs Run for error handling
- ·PersistentPreRunE hook chains
- ·Args validators: NoArgs, ExactArgs, MatchAll, custom
- ·Persistent and local flags
- ·Command groups and autocompletion
Use Cases
- →Building a new CLI tool with nested subcommands
- →Adding argument validation and error handling to existing cobra commands
- →Generating man pages and markdown docs from command trees
Best for
- ✓Go CLI developers
- ✓Cobra adopters
- ✓Tooling teams
Not ideal for
- !Non-Go projects
- !Simple scripts
FAQs
name
golang-spf13-cobra
description
Golang CLI command tree library using spf13/cobra — cobra.Command, RunE vs Run, PersistentPreRunE hook chain, Args validators (NoArgs, ExactArgs, MatchAll, custom), persistent vs local flags, command groups, ValidArgsFunction, RegisterFlagCompletionFunc, ShellCompDirective, usage/help template customization, man-page and markdown doc generation, and testing with SetArgs/SetOut/SetErr. Apply when using or adopting spf13/cobra, or when the codebase imports `github.com/spf13/cobra`. For configuration layering alongside cobra, see the `samber/cc-skills-golang@golang-spf13-viper` skill. For general CLI architecture (project layout, exit codes, signal handling, I/O patterns), see `samber/cc-skills-golang@golang-cli`.
license
MIT
user-invocable:true
compatibility:Designed for Claude Code or similar AI coding agents, and for projects using Golang.
metadata:{"author":"samber","version":"1.0.0","openclaw":{"emoji":"🐍","homepage":"https://github.com/samber/cc-skills-golang","requires":{"bins":["go"]},"install":[],"skill-library-version":"1.10.2"}}
allowed-tools:Read Edit Write Glob Grep Bash(go:*) Bash(golangci-lint:*) Bash(git:*) Agent WebFetch mcp__context7__resolve-library-id mcp__context7__query-docs
Persona: You are a Go CLI engineer building command trees that feel native to the Unix shell. You design the user-facing surface first, then wire behavior into the right hook.
Modes:
- Build — creating a new CLI from scratch: follow command tree setup, hook wiring, and flag sections sequentially.
- Extend — adding subcommands, flags, or completions to an existing CLI: read the current command tree first, then apply changes consistent with the existing structure.
- Review — auditing an existing CLI: check the Common Mistakes table, verify
RunEusage,OutOrStdout(), hook chain ordering, and args validation.
Using spf13/cobra for CLI command trees in Go
Cobra is the de facto standard for Go CLI applications. It provides the command/subcommand tree, flag parsing (via pflag), args validation, shell completion generation, and documentation generation. It does not handle configuration layering — that's viper's job.
Official Resources:
$install
1-click copynpx skills add samber/cc-skills-golang --skill golang-spf13-cobraSafety assessment
★
Clarity score
How clear and easy to understand the SKILL.md instructions are, rated from 1 to 5.
5/ 5
excellentVery clear and well structured, with almost no room for misunderstanding.
◎
Actionability score
How directly an agent can act on the SKILL.md instructions, rated from 1 to 5.
5/ 5
very highHighly actionable with clear, concrete steps that an agent can follow directly.