Guide and audit Node.js CLI application development against 37 established best practices covering UX, distribution, interoperability, accessibility, testing, error handling, development setup, analytics, versioning, and security. Use this skill when building, extending, reviewing, or scaffolding a Node.js CLI — including when someone says "audit my CLI", "review my CLI code", "I'm building a CLI tool", or asks about adding argument parsing, error handling, color output, STDIN, --json flags, exit codes, --version flags, or npm publishing. Applies even when best practices are not explicitly mentioned. Also trigger for "how should I implement X in my CLI" or "what's the right way to do Y in a Node.js CLI". Do NOT use for Node.js backend or API development with no CLI entry point.
94
94%
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 hits all the marks. It provides specific capabilities, comprehensive natural trigger terms, explicit 'Use when' and 'Do NOT use' clauses, and a clearly defined niche that distinguishes it from general Node.js skills. The description is thorough without being unnecessarily verbose, and uses proper third-person voice throughout.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Lists multiple specific concrete actions ('guide and audit', 'building, extending, reviewing, scaffolding') and enumerates specific domains covered (UX, distribution, interoperability, accessibility, testing, error handling, etc.). Also mentions concrete features like argument parsing, color output, STDIN, --json flags, exit codes, --version flags, npm publishing. | 3 / 3 |
Completeness | Clearly answers both 'what' (guide and audit Node.js CLI development against 37 best practices across 10 categories) and 'when' (explicit 'Use this skill when...' clause with detailed trigger scenarios, plus a 'Do NOT use' exclusion clause for additional clarity). | 3 / 3 |
Trigger Term Quality | Excellent coverage of natural trigger terms users would say: 'audit my CLI', 'review my CLI code', 'I'm building a CLI tool', 'argument parsing', 'error handling', 'color output', 'STDIN', '--json flags', 'exit codes', '--version flags', 'npm publishing', 'how should I implement X in my CLI'. These are highly natural phrases a user would actually type. | 3 / 3 |
Distinctiveness Conflict Risk | Very clearly scoped to Node.js CLI applications specifically, with an explicit exclusion ('Do NOT use for Node.js backend or API development with no CLI entry point') that prevents overlap with general Node.js development skills. The niche of CLI best practices auditing is distinct. | 3 / 3 |
Total | 12 / 12 Passed |
Implementation
70%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 skill that clearly defines two operational modes with distinct triggers, workflows, and output formats. Its main strength is the clear progressive disclosure pattern — keeping the overview lean while delegating detailed practices to a reference file. The primary weakness is that the skill body itself lacks concrete, executable code examples, relying almost entirely on the external reference for actionable implementation details, and some content (examples section, common mistakes) is somewhat redundant with the mode descriptions.
Suggestions
Add at least one fully concrete, copy-pasteable code example directly in the skill body (e.g., a complete minimal error handling wrapper or a yargs setup) rather than relying entirely on the external reference file for all code.
Consolidate the Examples section — the three examples mostly restate the mode-determination table and mode descriptions; replace them with a single compact example showing actual output (e.g., a partial audit report with real findings) to demonstrate quality expectations.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill is mostly efficient and well-structured, but includes some redundancy — the examples section largely restates what the mode descriptions already cover, and the common mistakes table partially overlaps with inline guidance. The quick reference table is useful but adds length. Overall it's reasonably lean for a complex skill but could be tightened. | 2 / 3 |
Actionability | The skill provides clear structural templates (audit report format, development guidance format) and references an external best-practices file for concrete code. However, the skill itself contains no executable code examples — the code snippets shown are template placeholders (e.g., `process.exit(1)` in the audit example). The actual actionability depends heavily on the referenced file, and the skill body itself is more structural/procedural than directly executable. | 2 / 3 |
Workflow Clarity | The two modes (audit and development guide) are clearly defined with explicit triggers, sequenced steps, and structured output formats. The audit mode includes a clear prioritization framework (High/Medium/Low) and the development guide mode has a phased approach. The mode-determination table provides an unambiguous decision process. Validation is implicit through the structured report format and priority grouping. | 3 / 3 |
Progressive Disclosure | The skill correctly delegates all 37 detailed practices to `references/best-practices.md` and makes this reference prominent and mandatory ('Critical' section). The SKILL.md itself serves as a clear overview with mode descriptions, output templates, and a quick-reference lookup table. References are one level deep and clearly signaled. | 3 / 3 |
Total | 10 / 12 Passed |
Validation
90%Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.
Validation — 10 / 11 Passed
Validation for skill structure
| Criteria | Description | Result |
|---|---|---|
metadata_field | 'metadata' should map string keys to string values | Warning |
Total | 10 / 11 Passed | |
Reviewed
Table of Contents