CtrlK
BlogDocsLog inGet started
Tessl Logo

list-npm-package-content

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

1.47x
Quality

73%

Does it follow best practices?

Impact

100%

1.47x

Average score across 3 eval scenarios

SecuritybySnyk

Passed

No known issues

Optimize this skill with Tessl

npx tessl skill review --optimize ./skills/list-npm-package-content/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

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.

DimensionReasoningScore

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.

DimensionReasoningScore

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.

Validation9 / 11 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_version

'metadata.version' is missing

Warning

metadata_field

'metadata' should map string keys to string values

Warning

Total

9

/

11

Passed

Repository
vercel/ai
Reviewed

Table of Contents

Is this your skill?

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.