CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

nodejs-package-management

Manage Node.js package managers, dependencies, lockfiles, workspaces, scripts, and module ecosystems across npm, pnpm, yarn, and bun. Use when selecting or migrating package managers, diagnosing dependency conflicts or phantom dependencies, configuring monorepos and Turborepo, hardening package.json, resolving lockfile drift, auditing vulnerabilities, configuring ESM/CJS compatibility, or publishing packages.

67

Quality

84%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

63%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

The body is exceptionally actionable — every section carries copy-paste-ready commands and complete configuration files, and it closes with a concrete verification checklist. Its main weaknesses are token efficiency (substantial space re-teaching SemVer, ESM/CJS, and .env basics Claude already knows, plus time-sensitive version pins) and the absence of progressive disclosure: a ~680-line monolith with no reference files.

Suggestions

Cut explanations of Claude-known concepts (SemVer level definitions, phantom-dependency definition, ESM/CJS basics, dotenv usage) down to one-line reminders, keeping only the decision rules and command tables.

Move stable-but-deep reference material (SemVer operator table, tsconfig/tsup configs, ESM interop guide, .npmrc options) into references/ files (e.g., references/semver.md, references/monorepos.md) linked one level deep from SKILL.md, leaving the main file an overview with decision rules and verification steps.

Replace hard-pinned, time-sensitive versions ('pnpm@9.12.0', 'Node 20.18.0', 'npm v10+') with the pinning pattern itself plus a note to check current LTS, so the skill does not drift out of date.

DimensionReasoningScore

Conciseness

The ~680-line body repeatedly explains concepts Claude already knows — SemVer level definitions ('MAJOR: Incompatible API changes'), a phantom-dependency definition, ESM/CJS basics and the __dirname/import.meta.url pattern, and dotenv/.env practices — and pins time-sensitive versions ('pnpm@9.12.0', 'Node 20.18.0', 'npm (v10+)'). The padding is pervasive across several sections, matching anchor 2 rather than the 'mostly efficient' anchor 3, though it stops short of the tutorial-prose anchor 1.

2 / 5

Actionability

Guidance is fully executable throughout: 'npm ci', 'pnpm install --frozen-lockfile', 'corepack use pnpm@9.12.0', lockfile-conflict recovery via 'git checkout --theirs' plus regeneration, complete overrides/resolutions JSON, turbo.json, tsup.config.ts, and 'npx audit-ci --high --critical'. Copy-paste-ready commands and complete config files cover the common cases, matching anchor 5 rather than anchor 4 where minor gaps would exist.

5 / 5

Workflow Clarity

Steps 1–15 are clearly labeled with a dedicated Verification section giving explicit checkpoints ('exit code 0', 'no EBADENGINE warnings', '0 vulnerabilities found'), and the lockfile merge-conflict procedure is a precise 1-2-3 sequence. It falls short of anchor 5 because the 15 steps read as a topic catalog rather than one coherent process, and there are no error-recovery feedback loops telling Claude what to do when a verification check fails; it exceeds anchor 3 because checkpoints are explicit rather than implicit.

4 / 5

Progressive Disclosure

No references/, scripts/, or assets/ files exist, and the single SKILL.md inlines content that clearly belongs in separate reference files (the SemVer operator table, tsconfig.json reference, ESM interop guide, .npmrc reference) at roughly 680 lines. Section headers do provide real structure — matching anchor 3's 'some structure but content that should be separate is inline' — rather than anchor 2's 'minimal structure', but it cannot reach anchor 4 since no offloaded references exist at all for a document this size.

3 / 5

Total

14

/

20

Passed

Description

100%Weight 40%Scale 1-5

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 an exemplary skill description: it uses third person, names the domain and tools concretely, enumerates specific capabilities, and provides an explicit 'Use when…' clause rich with natural trigger phrases. Both 'what' and 'when' are answered clearly and with minimal conflict risk against other skills.

DimensionReasoningScore

Specificity

The description lists multiple concrete actions — 'selecting or migrating package managers, diagnosing dependency conflicts or phantom dependencies, configuring monorepos and Turborepo, hardening package.json, resolving lockfile drift, auditing vulnerabilities, configuring ESM/CJS compatibility, or publishing packages' — giving comprehensive coverage with no notable gaps, matching the anchor 5 example's breadth.

5 / 5

Completeness

It explicitly answers both 'what' ('Manage Node.js package managers, dependencies, lockfiles, workspaces, scripts, and module ecosystems…') and 'when' ('Use when selecting or migrating…, diagnosing…, hardening…, or publishing packages') with concrete trigger phrases, exactly matching the anchor 5 pattern. A score of 4 would require a vaguer 'when' clause, which is not the case here.

5 / 5

Trigger Term Quality

It covers natural terms users would actually say: tool names ('npm, pnpm, yarn, and bun'), artifacts ('package.json', 'lockfiles'), and problem phrases ('phantom dependencies', 'lockfile drift', 'dependency conflicts'). The only marginal omissions (e.g., 'node_modules', 'semver') are minor enough that it fits the comprehensive anchor 5 better than anchor 4.

5 / 5

Distinctiveness Conflict Risk

The skill occupies a clear niche (Node.js package management) with distinct triggers like 'phantom dependencies', 'lockfile drift', and 'publishing packages' that are unlikely to fire for unrelated skills. It does not fall to anchor 4 because no closely related skill would plausibly collide on these specific triggers.

5 / 5

Total

20

/

20

Passed

Validation

93%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

skill_md_line_count

SKILL.md is long (695 lines); consider splitting into references/ and linking

Warning

Total

15

/

16

Passed

Repository

administrakt0r/pro-skills-repo-administraktor

Path

skills/development-skills/nodejs-package-management/SKILL.md

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.