List the contents of an npm package tarball before publishing. Use when the user wants to see what files are included in an npm bundle, verify package contents, or debug npm publish issues.
81
73%
Does it follow best practices?
Impact
100%
1.47xAverage score across 3 eval scenarios
Passed
No known issues
Optimize this skill with Tessl
npx tessl skill review --optimize ./skills/list-npm-package-content/SKILL.mdQuality
Discovery
89%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 a well-crafted skill description that clearly defines a narrow task with explicit trigger guidance. It covers the 'what' and 'when' effectively and uses natural keywords. The only minor weakness is that it could list more specific actions (e.g., listing file sizes, checking .npmignore behavior) to score higher on specificity.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Describes one concrete action ('List the contents of an npm package tarball') but doesn't list multiple specific actions. It mentions verifying and debugging but these are more use-case framing than distinct capabilities. | 2 / 3 |
Completeness | Clearly answers both what ('List the contents of an npm package tarball before publishing') and when ('Use when the user wants to see what files are included in an npm bundle, verify package contents, or debug npm publish issues'). | 3 / 3 |
Trigger Term Quality | Includes strong natural keywords users would say: 'npm package tarball', 'npm bundle', 'package contents', 'npm publish'. These cover common variations of how a user would phrase this need. | 3 / 3 |
Distinctiveness Conflict Risk | Very specific niche — npm package tarball listing is a narrow, well-defined task unlikely to conflict with other skills. The triggers are distinct and targeted. | 3 / 3 |
Total | 11 / 12 Passed |
Implementation
57%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is a simple skill that provides a clear command to run but falls short on actionability because the referenced script is not included or shown, and the 'Understanding Package Contents' section explains concepts Claude already knows. Adding the script content or example output would significantly improve it.
Suggestions
Remove or significantly trim the 'Understanding Package Contents' section — Claude already knows how npm determines package contents.
Include the actual content of `scripts/list-package-files.sh` or at minimum show the core command (e.g., `npm pack --dry-run` or `tar tzf`) so the skill is self-contained and executable.
Add an example of expected output so Claude can verify the command worked correctly.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The 'Understanding Package Contents' section explains npm packaging rules that Claude already knows well. The introductory sentence restating the description is also redundant. However, the core usage section is lean. | 2 / 3 |
Actionability | It provides a concrete bash command to run, but the actual script (`scripts/list-package-files.sh`) is not included or shown, so the user/Claude cannot verify what it does or reproduce it. There's no example output shown either. | 2 / 3 |
Workflow Clarity | The skill describes a single-step invocation (run a script), which is clear, but there's no guidance on what to do if the script fails, no validation steps, and no example output to verify correctness. | 2 / 3 |
Progressive Disclosure | For a simple, single-purpose skill under 50 lines with no need for external references, the content is well-organized into clear sections. No bundle files are needed or referenced unnecessarily. | 3 / 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_version | 'metadata.version' is missing | Warning |
metadata_field | 'metadata' should map string keys to string values | Warning |
Total | 9 / 11 Passed | |
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.