CtrlK
BlogDocsLog inGet started
Tessl Logo

nemoclaw-maintainer-evening

Complete the NemoClaw end-of-day documentation and release handoff. Cut a release tag only when requested.

53

Quality

67%

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

Fix and improve this skill with Tessl

tessl review fix ./.agents/skills/nemoclaw-maintainer-evening/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

67%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 a lean, well-sequenced instruction skill with explicit gates around the destructive tag operation and clearly signaled one-level-deep references. Its main weakness is actionability: beyond the version-target scripts in Step 1, later steps describe required outputs without the commands or tools needed to produce them.

Suggestions

Add the concrete commands (or tool invocations) for Step 3's outputs — how to list merged work in vX.Y.Z, open PRs/issues carrying the label, and the newest full E2E run — mirroring the executable style of Step 1's version-target scripts.

Specify how to "Inspect the current Docs / Author Post-Merge Catch-Up state" (e.g., a gh query or workflow-run check) so the instruction is executable rather than directional.

Trim the repeated tagging-optional and no-separate-PR statements (intro, Section 2, Hard Rules) to a single authoritative location, cross-referenced from the others.

DimensionReasoningScore

Conciseness

The body is dense, imperative, and assumes competence — e.g., "Do not silently convert the answer into a patch, minor, or major bump", with no explanation of concepts Claude already knows. Minor redundancy keeps it below anchor 5: "Tagging is optional" in the intro repeats "Cut a release tag only when requested" semantics, and Section 2 states the no-separate-PR rule twice ("Do not create a separate release-entry PR when the active cumulative docs PR can carry it" vs. the merge-before-selection guidance).

4 / 5

Actionability

Concrete artifacts exist — the exact commands ("node --no-warnings .agents/skills/nemoclaw-maintainer-day/scripts/version-target.ts"), the changelog path pattern "docs/changelog/YYYY-MM-DD.mdx, headed ## vX.Y.Z" — but most steps give direction without executable means: "Inspect the current Docs / Author Post-Merge Catch-Up state" and Section 3's "Show: merged work in vX.Y.Z ... the newest full E2E status, SHA, age, and URLs" specify outputs but no commands or tools to produce them. This is anchor 3 (some concrete guidance but incomplete, missing key details), not 4.

3 / 5

Workflow Clarity

A clear five-step sequence (Select Target Version → Documentation Change → Handoff → Cut Tag → Complete) with explicit checkpoints and conditionals: "Merge the documentation PR before selecting the tag candidate", "If another product merge lands before candidate selection, decide whether it belongs in this release", and Hard Rules gating the destructive tag operation ("Never cut a tag without the maintainer's exact confirmation phrase"). It falls short of anchor 5 only because some validation detail is delegated to the external cut-release-tag skill rather than stated as feedback loops here.

4 / 5

Progressive Disclosure

The bundle has no local references/, scripts/, or assets/; the body is the whole skill, and it is well organized into short purposeful sections. External references are one level deep and clearly signaled ("See [PR-REVIEW-PRIORITIES.md](...) for the daily cadence", "Load nemoclaw-maintainer-cut-release-tag and pass the version"), matching the anchor-4 pattern of good structure with minor gaps — several referenced paths point to sibling skills outside this bundle rather than to co-located files.

4 / 5

Total

15

/

20

Passed

Description

53%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 has a clear what and a specific domain niche, but lacks an explicit trigger clause and natural-language trigger variations, and its capability statements are summary-level rather than concrete. It is serviceable but would be significantly improved by a 'Use when...' clause.

Suggestions

Add an explicit trigger clause, e.g., "Use when the maintainer is closing out the NemoClaw day, catching up documentation, or handing off a release candidate."

Add natural trigger variations users would actually say ("end of day", "close out", "changelog catch-up", "sign off for the day") alongside the current terms.

Make the capabilities more concrete: name the artifacts produced (pre-tag changelog entry in docs/changelog/, cumulative docs PR, signed release tag) instead of "documentation and release handoff".

DimensionReasoningScore

Specificity

"Complete the NemoClaw end-of-day documentation and release handoff" names a domain and two-to-three actions (documentation, release handoff, conditionally "Cut a release tag"), but the actions are high-level summaries rather than concrete capabilities. It matches anchor 3 ("Names domain and 1-2 concrete actions, but not comprehensive") better than anchor 4, which expects several specific actions with only minor gaps.

3 / 5

Completeness

The "what" is stated clearly ("Complete the NemoClaw end-of-day documentation and release handoff"), but there is no "Use when..." clause or equivalent explicit trigger guidance; "end-of-day" only weakly implies the "when". Per the rubric guidelines, a missing 'Use when' clause caps completeness at 3.

3 / 5

Trigger Term Quality

Relevant keywords exist — "end-of-day", "documentation", "release handoff", "release tag" — but common variations a user would naturally say ("close out the day", "changelog", "publish/release", "sign off") are missing. This sits at anchor 3 ("Some relevant keywords but missing common variations or synonyms"), below anchor 4's good coverage.

3 / 5

Distinctiveness Conflict Risk

"NemoClaw end-of-day documentation and release handoff" carves a clear niche with distinct triggers (end-of-day, handoff). Minor overlap risk exists with the closely related sibling skills the body delegates to (e.g., a user asking to "cut a release tag" may want the cut-release-tag skill directly, and "Cut a release tag only when requested" partially overlaps it) — anchor 4, not 5.

4 / 5

Total

13

/

20

Passed

Validation

87%

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

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

relative_links

Relative link issues: 4 suspicious

Warning

Total

14

/

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.