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 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.

DimensionReasoningScore

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.

DimensionReasoningScore

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.

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.