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

DimensionReasoningScore

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.

DimensionReasoningScore

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.

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.