CtrlK
BlogDocsLog inGet started
Tessl Logo

nemoclaw-contributor-update-docs

Update NemoClaw documentation for merged behavior changes. Use for post-merge catch-up or a requested documentation drift audit.

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

Low

Low-risk findings worth noting

SKILL.md
Quality
Evals
Security

Quality

Content

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

This is a disciplined, lean instruction-only skill: a clearly sequenced five-phase workflow with explicit validation and hand-off, concrete path/command specifics where they matter, and deliberate delegation of volatile conventions to shared guidance instead of duplicating them. The residual gaps are minor — the validation feedback loop is implicit rather than spelled out, and the two shared-contract references point outside the bundle where their existence cannot be confirmed.

DimensionReasoningScore

Conciseness

The body is ~65 lines of dense procedural instruction with zero filler: no concept explanations Claude already knows (e.g., what a PR or changelog is), no restated library basics, and every sentence issues a directive like "Read each complete source page before editing. Update the narrowest page that owns the behavior." This matches 'lean and efficient; assumes Claude's competence; every token earns its place'; a 4 would require over-explanation worth trimming, and none is evident.

5 / 5

Actionability

Concrete elements are present — "change only `docs/**`, `fern/docs.yml`, and `fern/assets/**`", "Required PR checks run `npm run docs`", the six-step impact checklist, and explicit prohibitions ("Do not infer a command, default, path, or support claim from historical documentation"). It falls short of the fully-executable 5 anchor because most operational specifics (checks, conventions, skip-file policies) are deliberately deferred to external guidance rather than given as runnable commands, which is a minor gap rather than the missing-key-details of anchor 3.

4 / 5

Workflow Clarity

Five clearly sequenced phases (Establish the range → Load current authority → Find documentation impact → Update the owning content → Validate and hand off) each with concrete sub-steps, and validation is an explicit final phase with a summary-of-evidence requirement. It does not reach anchor 5 because there is no explicit validate→fix→retry feedback loop and the validation command itself is deferred ("run the current documentation checks discovered from repository guidance"); it stays above 3 because checkpoints are present, not merely implicit.

4 / 5

Progressive Disclosure

The body is a well-sectioned overview that delegates detail through clearly signaled, one-level-deep links ("Follow [Discover the Current Implementation](../_shared/implementation-discovery.md)", the shared "[Documentation Writing and Review](../_shared/documentation-writing-review.md) contract") and sibling-skill referrals, with no bulk reference content inlined. It falls between anchors 4 and 5 rather than clearly at 5 because both shared references point outside the skill bundle (../_shared/, not ./references/) and cannot be verified to exist in the provided bundle — a minor organization gap against the 'easy navigation' top anchor.

4 / 5

Total

17

/

20

Passed

Description

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

The description is compact, in third person, and explicitly answers both what it does and when to use it, with a genuinely distinctive post-merge trigger phrase. Its main limitation is that it names only one action, slightly underselling the concrete capabilities (page updates, exclusions, validation, hand-off) the skill actually covers.

DimensionReasoningScore

Specificity

"Update NemoClaw documentation for merged behavior changes" names the domain and one concrete action, matching the 'names domain and 1-2 concrete actions' anchor. It stays at 3 rather than 4 because only a single action (updating documentation) is listed — no mention of the page-level updates, exclusions, or validation the skill actually performs — and it rises above 2 because the action is concrete, not generic.

3 / 5

Completeness

Both halves are explicit: the 'what' is "Update NemoClaw documentation for merged behavior changes" and the 'when' is the concrete trigger clause "Use for post-merge catch-up or a requested documentation drift audit". This clearly matches the top anchor (both what and when with concrete trigger phrases); a 4 would require the 'when' to be less explicit than it is.

5 / 5

Trigger Term Quality

Natural phrases a user would say are present: "documentation", "merged behavior changes", "post-merge catch-up", "documentation drift audit". This matches 'good keyword coverage; a few natural terms missing' rather than 5 because common variations like "update the docs", "docs out of date", or "sync docs after merge" are absent, and it exceeds 3 since it goes beyond a bare domain keyword.

4 / 5

Distinctiveness Conflict Risk

The NemoClaw scoping plus the distinctive "post-merge catch-up" trigger give it a mostly distinct niche, but the description mentions only 'documentation' broadly, so it carries minor overlap risk with closely related sibling doc skills referenced in the body (e.g., nemoclaw-maintainer-refactor-docs, nemoclaw-maintainer-evening). It is more specific than the 'somewhat specific but could still overlap' anchor 3.

4 / 5

Total

16

/

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