Golang CLI application development. Use when building, modifying, or reviewing a Go CLI tool — especially for command structure, flag handling, configuration layering, version embedding, exit codes, I/O patterns, signal handling, shell completion, argument validation, and CLI unit testing. Also triggers when code uses cobra, viper, or urfave/cli. For cobra-specific APIs → See `samber/cc-skills-golang@golang-spf13-cobra` skill; for viper configuration layering → See `samber/cc-skills-golang@golang-spf13-viper` skill.
66
81%
Does it follow best practices?
Impact
—
No eval scenarios have been run
Passed
No known issues
Quality
Discovery
100%Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.
This is an excellent skill description that covers all dimensions well. It provides comprehensive specificity with a detailed list of CLI-related concerns, includes strong natural trigger terms that developers would use, explicitly states both what the skill does and when to use it, and even includes cross-references to related skills to reduce overlap and conflict.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Lists multiple specific concrete actions and concepts: command structure, flag handling, configuration layering, version embedding, exit codes, I/O patterns, signal handling, shell completion, argument validation, and CLI unit testing. | 3 / 3 |
Completeness | Clearly answers both what ('Golang CLI application development' with extensive list of capabilities) and when ('Use when building, modifying, or reviewing a Go CLI tool' plus 'Also triggers when code uses cobra, viper, or urfave/cli'). Explicit trigger guidance is provided. | 3 / 3 |
Trigger Term Quality | Excellent coverage of natural terms users would say: 'Go CLI tool', 'command structure', 'flag handling', 'exit codes', 'shell completion', 'cobra', 'viper', 'urfave/cli', 'Golang', 'CLI application'. These are terms developers naturally use when working on CLI tools in Go. | 3 / 3 |
Distinctiveness Conflict Risk | Highly distinctive — scoped specifically to Go CLI development with clear boundaries. Cross-references to related cobra and viper skills help disambiguate and reduce conflict risk. The combination of 'Golang' + 'CLI' creates a clear niche. | 3 / 3 |
Total | 12 / 12 Passed |
Implementation
62%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is a well-structured CLI development skill with clear organization, good use of tables for quick reference, and thoughtful workflow modes. However, its heavy reliance on external example files (assets/examples/*.go) that are not present in the bundle severely undermines its actionability — the skill body becomes a table of contents pointing to missing content. The Common Mistakes table and configuration precedence documentation are strong standalone sections.
Suggestions
Include the bundle files (assets/examples/*.go) or inline the most critical code examples (root.go setup with SilenceUsage/SilenceErrors, flag binding to Viper, and exit code pattern) directly in the SKILL.md to ensure actionability even without the bundle.
Add at least one complete, minimal executable example inline (e.g., a root command with one subcommand) so the skill is self-contained for the Build mode workflow.
Trim the explanatory text that accompanies references to external files — lines like 'Key points' lists that summarize what the referenced file shows add tokens without adding value if the file is available, and don't substitute for the file if it's missing.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill is generally well-organized and avoids explaining basic Go concepts, but includes some unnecessary elaboration (e.g., explaining what Cobra and Viper do, listing tools like kubectl/docker/gh that use them, and the 'Fix' column in Common Mistakes often restates what's already covered). The tables and reference sections are efficient, but the overall document could be tightened. | 2 / 3 |
Actionability | The skill references external example files extensively (e.g., assets/examples/root.go, assets/examples/serve.go) for all concrete code, but no bundle files were provided, meaning none of those examples are actually available. The inline content is descriptive guidance and tables rather than executable code. Without the referenced assets, Claude cannot copy-paste or execute anything directly from this skill. | 2 / 3 |
Workflow Clarity | The three modes (Build, Extend, Review) provide clear workflows with sequenced steps. The Build mode explicitly says 'follow the project structure, root command setup, flag binding, and version embedding sections sequentially.' The Review mode provides a concrete checklist. The Common Mistakes table serves as a validation checklist. Configuration precedence is clearly ordered. | 3 / 3 |
Progressive Disclosure | The skill makes excellent use of references to assets/examples/ files and related skills, which is good progressive disclosure design. However, since no bundle files were provided, all those references are broken — the actual content Claude needs is inaccessible. The SKILL.md itself is well-structured with clear sections and tables, but the heavy reliance on missing external files significantly undermines the progressive disclosure strategy. | 2 / 3 |
Total | 9 / 12 Passed |
Validation
81%Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.
Validation — 9 / 11 Passed
Validation for skill structure
| Criteria | Description | Result |
|---|---|---|
metadata_field | 'metadata' should map string keys to string values | Warning |
frontmatter_unknown_keys | Unknown frontmatter key(s) found; consider removing or moving to metadata | Warning |
Total | 9 / 11 Passed | |
8c7e016
Table of Contents
If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.