CtrlK
BlogDocsLog inGet started
Tessl Logo

nemoclaw-contributor-update-dependencies

Audit and implement a NemoClaw dependency version upgrade, including Hermes and base images. Use when the dependency itself is changing.

60

Quality

75%

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

Fix and improve this skill with Tessl

tessl review fix ./.agents/skills/nemoclaw-contributor-update-dependencies/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

73%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 well-gated, clearly sequenced upgrade workflow with strong progressive disclosure and explicit validation checkpoints, security controls, and an untrusted-evidence stance. The main gap is actionability: many steps are stated as abstract imperatives rather than executable or example-backed guidance, which forces the reader to reinvent mechanics the skill could have shown. A minor conciseness defect (a duplicated policy sentence) and an unresolvable shared-reference link keep it just below the top band.

Suggestions

Ground the abstract steps with one concrete worked example each — e.g. a sample command pair for resolving a source identity, or a filled-in one-line concern record (upstream old/new contract, consumer, failure mode, migration) so the format is unambiguous.

Deduplicate "Preserve historical executable fixtures only when they still support a current test" (appears in both the records section and Resolve concerns) and move the long point-in-time-records paragraph into a reference file.

Fix or inline the "../_shared/implementation-discovery.md" dependency so the Discover-current-contracts step is self-contained within the skill bundle.

DimensionReasoningScore

Conciseness

The body is dense, assumes Claude's competence, and contains no tutorial padding or explanations of known concepts — every section is project-specific policy. It falls short of anchor 5 only through minor redundancy: "Preserve historical executable fixtures only when they still support a current test" appears verbatim in two sections, and the point-in-time records paragraph is a long inline policy block that could be tightened.

4 / 5

Actionability

The workflow is concrete at the procedure level — numbered audit steps, references to real checked-in tools ("[release ledger collector](scripts/collect-release-ledger.py)", "Inspect the collector's current help and source before use"), and explicit security controls ("mode 0600", "byte and record ceilings"). But most steps are abstract directives with no executable form ("Resolve immutable source identities and publication status", "Compare resolved dependency graphs and distributed artifacts") — anchor 3: some concrete guidance but missing the specific steps to execute, short of anchor 4's mostly-executable guidance.

3 / 5

Workflow Clarity

The sequence is explicit and gated: plan outcomes → discover contracts → audit upstream ranges → resolve concerns → verify, with concrete checkpoints ("An unresolved high-impact concern blocks the upgrade", "Implement migrations in upstream release order", a "Before handoff" checklist, and the rule that expected version output does not establish contract execution). This matches anchor 5 — clear sequence, explicit validation steps, and a checklist for a complex process.

5 / 5

Progressive Disclosure

Good split: the ~105-line body stays at overview level while detail lives in one-level-deep, clearly linked references (release-ledger.md, contract-audit.md, hermes.md) and checked-in scripts, with exemplary conditional loading ("load the conditional Hermes upgrade variant... only when the dependency target is Hermes" — hermes.md itself is marked "Load this reference only when..."). It misses anchor 5 because the core workflow reference "[Discover the Current Implementation](../_shared/implementation-discovery.md)" points outside the skill bundle and does not resolve in this checkout, leaving the entry-point step unverifiable.

4 / 5

Total

16

/

20

Passed

Description

66%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 tight, third-person description that clearly answers what and when for a well-scoped niche. Its weaknesses are mid-level keyword coverage and thin action detail — it names the two headline actions but not the sub-tasks (audit release ranges, map consumers, migrate selectors) that would make triggers and capabilities more concrete. Voice is correctly third-person; no fluff or over-claims.

Suggestions

Add natural trigger variations users would actually say, e.g. "Use when asked to update, bump, or upgrade a dependency (including Hermes or base images)".

Enumerate one or two more concrete actions in the what-clause, e.g. "Audit upstream release ranges, map changed contracts to NemoClaw consumers, and implement the migrations".

Keep the existing 'when the dependency itself is changing' disambiguator but pair it with an observable user cue (a version-change issue or dependency diff) to sharpen the trigger.

DimensionReasoningScore

Specificity

The description names the domain ("NemoClaw dependency version upgrade") and two concrete actions ("Audit and implement"), plus scope items ("including Hermes and base images"), but stops short of listing several specific actions. It fits anchor 3 — domain plus 1–2 concrete actions, not comprehensive — rather than anchor 4, which expects several specific operations.

3 / 5

Completeness

The "what" is clear ("Audit and implement a NemoClaw dependency version upgrade, including Hermes and base images") and a "when" clause is explicit ("Use when the dependency itself is changing"). It sits at anchor 4: both present, but the "when" is a terse disambiguator without concrete trigger phrases or user scenarios, short of anchor 5's "concrete trigger phrases".

4 / 5

Trigger Term Quality

Relevant keywords are present ("dependency version upgrade", "Hermes", "base images") but common natural variations a user would say — "update dependencies", "bump a version", "upgrade a package", file names like requirements/pyproject — are missing. This matches anchor 3 (some relevant keywords, missing common variations) rather than anchor 4's fuller coverage.

3 / 5

Distinctiveness Conflict Risk

The combination of "NemoClaw", "Hermes", and "base images" carves out a clear niche with distinct triggers, and the "when the dependency itself is changing" clause explicitly separates it from adjacent workflows (e.g. generic issue implementation). Minimal conflict risk — anchor 5.

5 / 5

Total

15

/

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

relative_links

Relative link issues: 1 suspicious

Warning

Total

15

/

16

Passed

Repository
NVIDIA/NemoClaw
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.