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.
97
97%
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 hits all the marks. It provides specific capabilities, comprehensive natural trigger terms, explicit 'Use when' and 'Do NOT use' clauses, and a clearly distinct niche. The description is thorough without being padded, 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
85%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 concrete output templates, good decision logic for mode selection, and appropriate delegation of detailed reference content to a separate file. Its main weakness is mild verbosity — the examples section and some table content could be trimmed since they restate what the mode descriptions already establish. Overall, it's a strong skill that would effectively guide Claude in both auditing and building Node.js CLIs.
| 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 quick reference table duplicates information available in the referenced best-practices.md. The common mistakes table adds value but could be slightly tighter. | 2 / 3 |
Actionability | The skill provides concrete, structured output formats for both audit and development guide modes, with specific section references (§X.Y), exact report templates, checklists, and clear instructions on what code to produce. The audit report format and development guidance format are copy-paste ready templates that Claude can directly follow. | 3 / 3 |
Workflow Clarity | Both modes have clearly sequenced workflows with explicit decision logic (the trigger table for mode selection), ordered steps for each mode, and the development guide mode has a clear phased approach. The audit mode includes priority grouping (High/Medium/Low) which serves as a validation checkpoint for output quality. The 'always read references/best-practices.md first' instruction is a clear prerequisite gate. | 3 / 3 |
Progressive Disclosure | The skill cleanly separates concerns: the SKILL.md provides the operational framework and templates, while the detailed 37 practices with code examples are properly delegated to `references/best-practices.md`. The quick reference table serves as effective navigation to specific sections. References are one level deep and clearly signaled. | 3 / 3 |
Total | 11 / 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