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 with a clear 'Use when' clause, good trigger terms covering natural user language, and a distinct niche. The only minor weakness is that the capability description could list more specific actions (e.g., listing file sizes, showing directory structure) to score higher on specificity.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Describes one concrete action ('List the contents of an npm package tarball') but doesn't enumerate multiple specific actions beyond that single capability. The additional phrases like 'verify package contents' and 'debug npm publish issues' add some breadth but are somewhat vague. | 2 / 3 |
Completeness | Clearly answers both 'what' (list contents of an npm package tarball before publishing) and 'when' (explicit 'Use when' clause covering seeing included files, verifying package contents, and debugging publish issues). | 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 the common ways a user would phrase this need. | 3 / 3 |
Distinctiveness Conflict Risk | Very specific niche focused on npm package tarball inspection. Unlikely to conflict with general npm skills or other file-listing skills due to the precise domain of pre-publish package content verification. | 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.
The skill is reasonably structured and concise for a simple task, but has two key weaknesses: it references a script (`scripts/list-package-files.sh`) without providing its contents, making it not fully actionable, and it includes an explanatory section about npm packaging rules that Claude already knows. The skill would benefit from either including the script contents or showing the equivalent inline commands.
Suggestions
Include the actual contents of `scripts/list-package-files.sh` or provide equivalent inline commands (e.g., `npm pack --dry-run` or `npm pack && tar tzf *.tgz`) so the skill is fully executable without external dependencies.
Remove or significantly trim the 'Understanding Package Contents' section — Claude already knows how npm determines package contents.
Add an example of expected output so Claude knows what a successful run looks like.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The 'Understanding Package Contents' section explains npm packaging rules that Claude already knows well. The core actionable content is just the bash command, which is lean, but the explanatory section adds unnecessary tokens. | 2 / 3 |
Actionability | It provides a concrete bash command to run, but the script itself (`scripts/list-package-files.sh`) is not shown or defined — Claude cannot execute or create it from this skill alone. The skill references a script without providing its contents. | 2 / 3 |
Workflow Clarity | This is a relatively simple single-step task (run a script), and the description mentions the script builds, creates a tarball, lists contents, and cleans up. However, there's no guidance on what to do if the script fails, no validation steps, and no example output shown. | 2 / 3 |
Progressive Disclosure | For a simple, short skill under 50 lines with a single task, the content is well-organized into clear sections (Usage, Understanding Package Contents) without unnecessary nesting or external references. | 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.