golang-spf13-cobra

1**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.
2 
3**Modes:**
4 
5- **Build** — creating a new CLI from scratch: follow command tree setup, hook wiring, and flag sections sequentially.
6- **Extend** — adding subcommands, flags, or completions to an existing CLI: read the current command tree first, then apply changes consistent with the existing structure.
7- **Review** — auditing an existing CLI: check the Common Mistakes table, verify `RunE` usage, `OutOrStdout()`, hook chain ordering, and args validation.
8 
9# Using spf13/cobra for CLI command trees in Go
10 
11Cobra 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.
12 
13**Official Resources:**
14 
15- [pkg.go.dev/github.com/spf13/cobra](https://pkg.go.dev/github.com/spf13/cobra)
16- [github.com/spf13/cobra](https://github.com/spf13/cobra)
17- [cobra.dev](https://cobra.dev)
18 
19This skill is not exhaustive — refer to library documentation and code examples for more information:
20 
21- For Go package docs, symbols, versions, importers, and known vulnerabilities, → See `samber/cc-skills-golang@golang-pkg-go-dev` skill (`godig`), preferred over Context7 for Go package facts.
22…