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, specific task with explicit 'Use when' triggers. It covers natural user language well and is highly distinctive. The only minor weakness is that it could list more concrete actions (e.g., listing file sizes, comparing against .npmignore) to score higher on specificity.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Describes a specific action ('list the contents of an npm package tarball') but only names one concrete action rather than multiple specific capabilities. It mentions verifying and debugging but these are more like use cases than distinct actions. | 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') with explicit trigger guidance. | 3 / 3 |
Trigger Term Quality | Includes strong natural keywords users would say: 'npm package tarball', 'npm bundle', 'package contents', 'npm publish', 'files included'. These cover common variations of how users would phrase this need. | 3 / 3 |
Distinctiveness Conflict Risk | Very specific niche — npm package tarball inspection before publishing. Unlikely to conflict with other skills due to the narrow, well-defined scope around npm packaging and tarball contents. | 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 straightforward skill that provides a clear command to run but falls short in two areas: it explains npm packaging concepts Claude already knows, and it references a script without showing its contents, making it less actionable. Adding the script content or expected output would significantly improve it.
Suggestions
Remove or drastically shorten the 'Understanding Package Contents' section — Claude already knows how npm determines package contents.
Include the actual contents of `scripts/list-package-files.sh` or at minimum show expected output so Claude can verify correctness and debug issues.
Add an example of what the output looks like (e.g., a sample tarball listing) so Claude knows what success looks like.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The 'Understanding Package Contents' section explains npm packaging rules that Claude already knows well. The introductory sentence is also somewhat 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. The skill delegates all real work to an unseen script without showing its contents. | 2 / 3 |
Workflow Clarity | The workflow is simple (run one script), but there's no guidance on what to do if the script fails, no validation steps, and no example output showing what success looks like. For a single-command skill this is acceptable but could benefit from expected output. | 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. The structure is appropriate for the scope. | 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.