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.
83
81%
Does it follow best practices?
Impact
Pending
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 clearly defines its scope (Go CLI development), lists comprehensive specific capabilities, and provides explicit trigger conditions including both task-based triggers and library-based triggers. It uses proper third-person voice and is concise yet thorough, making it easy for Claude to distinguish from both general Go development skills and general CLI skills.
| 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. This is highly specific and comprehensive. | 3 / 3 |
Completeness | Clearly answers both what ('Golang CLI application development' with enumerated capabilities) and when ('Use when building, modifying, or reviewing a Go CLI tool' plus 'Also triggers when code uses cobra, viper, or urfave/cli'). The explicit 'Use when' and 'Also triggers when' clauses are well-formed. | 3 / 3 |
Trigger Term Quality | Excellent coverage of natural terms users would say: 'Go CLI tool', 'Golang', 'cobra', 'viper', 'urfave/cli', 'flag handling', 'shell completion', 'exit codes'. These are terms developers naturally use when working on CLI applications in Go. | 3 / 3 |
Distinctiveness Conflict Risk | Highly distinctive — narrowed to Go language + CLI application domain with specific library triggers (cobra, viper, urfave/cli). Unlikely to conflict with general Go skills or general CLI skills due to the intersection of both domains plus named frameworks. | 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 and comprehensive CLI development skill with clear organization, useful tables, and good workflow modes. Its main weakness is that actionability depends heavily on external example files that aren't provided in the bundle, making the skill more of a reference guide than an executable playbook. The content is moderately concise but could trim some explanatory text that Claude would already know.
Suggestions
Include at least the most critical code examples inline (root.go setup with SilenceUsage/SilenceErrors, basic flag binding to Viper) rather than relying entirely on external files that may not be available.
Provide the bundle files referenced throughout (assets/examples/*.go) so the progressive disclosure structure actually delivers on its promises.
Trim explanatory phrases like 'This combination powers kubectl, docker, gh, hugo, and most production Go CLIs' and 'Cobra provides the command/subcommand/flag structure and Viper handles configuration...' — Claude knows these libraries.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Generally efficient with good use of tables and structured sections, but includes some unnecessary explanation (e.g., explaining what Cobra and Viper are, listing tools that use them, explaining what persistent vs local flags mean). The Common Mistakes table has explanations that are slightly verbose but mostly earn their place. Some sections like 'Always Bind Flags to Viper' explain why rather than just instructing. | 2 / 3 |
Actionability | The skill references external example files extensively (assets/examples/root.go, assets/examples/serve.go, etc.) but since no bundle files are provided, none of the concrete code examples are actually available. The inline content is mostly descriptive guidance and tables rather than executable code. The one inline code block is a YAML config example, not executable Go code. Without the bundle files, this skill provides direction but not copy-paste-ready implementation. | 2 / 3 |
Workflow Clarity | The three modes (Build, Extend, Review) at the top provide clear workflow guidance. The Build mode explicitly sequences the sections to follow. The Review mode provides a concrete checklist of things to verify. The configuration precedence order is clearly numbered. The Common Mistakes table serves as an effective validation checklist for review workflows. | 3 / 3 |
Progressive Disclosure | The skill makes excellent use of references to external example files (assets/examples/*.go) which is good progressive disclosure design. However, since no bundle files are provided, we cannot verify these references resolve to actual content. The SKILL.md itself is quite long (~200 lines) and some sections could be more concise inline with details pushed to referenced files. The structure is well-organized with clear headers but the body contains substantial detail that could be in referenced files. | 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 | |
e9761db
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.