CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

dependency-upgrade

Secure dependency upgrades with supply chain protection, cooldowns, and staged rollout. Use when upgrading deps, configuring security policies, or preventing supply chain attacks.

66

Quality

83%

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

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

A highly actionable, well-sequenced skill body with excellent executable guidance and strong reference signaling for the references/ files. Its weaknesses are length that could be tightened (duplicated Socket content, inline rollback script) and a progressive-disclosure defect: every referenced `templates/` file is missing from the bundle, breaking the documented navigation for that entire section.

Suggestions

Progressive disclosure: create the `templates/` directory with the nine advertised `.tmpl` files (or remove the Template Files table and every inline `templates/...` pointer), and either fix or delete the placeholder `scripts/generate-dependency-upgrades.sh` (currently '404: Not Found' and never referenced from the body).

Conciseness: consolidate the Socket CLI material that currently appears in three places (Socket CLI Integration, Dependency Analysis, Staged Upgrade Strategy) into the Socket CLI section with a single pointer to `references/socket-cli-guide.md`, and move the full rollback bash script into `references/staged-upgrades.md`.

Conciseness: merge the 'Two Modes of Operation' section into the Interactive Setup Flow intro — the defaults it lists are already encoded in the Tier 1 tables (7-day cooldown, block all scripts, Dependabot).

DimensionReasoningScore

Conciseness

The body is dense with genuinely useful commands and config snippets rather than explanations of known concepts, but at ~580 lines it could be tightened: Socket CLI commands appear in three separate sections (Socket CLI Integration, Dependency Analysis, Staged Upgrade Strategy), the full rollback bash script and the 9-entry Template Files table duplicate material that belongs in references, and the "Two Modes of Operation" section re-states defaults that Tier 1 tables already encode. This fits 'mostly efficient but includes some unnecessary content or could be tightened', and it is noticeably better than the 'noticeably verbose' 2 anchor since almost no conceptual padding exists.

3 / 5

Actionability

Nearly every section delivers copy-paste-ready, executable material: exact per-PM config snippets ("min-release-age=7", "minimumReleaseAge: 10080"), exact commands ("socket fix --minimum-release-age 7d --no-major-updates", "npm profile enable-2fa auth-and-writes"), and answer-to-config mapping tables. This matches the 'fully executable; copy-paste ready; specific examples cover the common cases' anchor with no pseudocode anywhere.

5 / 5

Workflow Clarity

The Staged Upgrade Strategy is a numbered 7-step sequence with an explicit test checkpoint ("bun test && bunx tsc --noEmit && bun run build"), the Rollback Plan contains a genuine failure-feedback loop (test → commit, else checkout main and reinstall), and the Upgrade Checklist spans pre/during/post with validation items. This matches 'clear sequence with explicit validation steps; feedback loops for error recovery; checklists for complex processes', and the destructive/batch cap does not apply because validation is present.

5 / 5

Progressive Disclosure

Reference signaling is genuinely good — one-level-deep "Load `references/...` for..." lines, a dedicated "When to Load References" table, and all 8 cited reference files exist. However, scoring against the actual bundle reveals a significant navigation defect: the `templates/` directory cited repeatedly ("Use `templates/<pm>-security.tmpl`", `templates/socket-fix-ci.tmpl`, plus a 9-row Template Files table) does not exist in the bundle at all, so a major class of advertised navigation paths dead-ends. The structure matches anchor 4, but the broken template paths pull it to 'some structure but could be better organized' since following the documented pointers fails for every template entry.

3 / 5

Total

16

/

20

Passed

Description

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

A strong description with a clear what-and-when structure, third-person voice, and concrete trigger phrases. Main gaps are slightly abstract capability wording and omission of natural trigger terms (tool names like Renovate/Dependabot, 'package manager', 'vulnerabilities') that the body demonstrably covers.

DimensionReasoningScore

Specificity

Phrases like "Secure dependency upgrades with supply chain protection, cooldowns, and staged rollout" name the domain plus several concrete capabilities (supply chain protection, cooldowns, staged rollout), matching the 'several specific actions; minor gaps' anchor. It falls short of 5 because capabilities like per-package-manager config generation and CI/CD automation setup are only compressed into 'configuring security policies', and 'supply chain protection' is itself somewhat abstract.

4 / 5

Completeness

It explicitly answers both: the 'what' ("Secure dependency upgrades with supply chain protection, cooldowns, and staged rollout") and the 'when' ("Use when upgrading deps, configuring security policies, or preventing supply chain attacks") with three concrete trigger phrases, matching the top anchor. It is not a 4 because the 'when' clause is already explicit and specific rather than 'could be more explicit'.

5 / 5

Trigger Term Quality

"upgrading deps", "configuring security policies", and "preventing supply chain attacks" are natural phrases a user would say, giving good keyword coverage. Not a 5 because common variations the body clearly supports — 'Renovate', 'Dependabot', 'Snyk', 'npm', 'package manager', 'vulnerabilities/audit', 'outdated' — are absent, so a few natural trigger terms are missing.

4 / 5

Distinctiveness Conflict Risk

The dependency-upgrade/supply-chain niche is clear and distinct from most skills, matching 'mostly distinct; minor overlap risk'. Not a 5 because the trigger "configuring security policies" is broad enough to overlap with generic security-hardening or CI/CD skills.

4 / 5

Total

17

/

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 (584 lines); consider splitting into references/ and linking

Warning

Total

15

/

16

Passed

Repository

secondsky/claude-skills

Path

plugins/dependency-upgrade/skills/dependency-upgrade/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.