CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

nemoclaw-maintainer-refactor-docs

Reorganize NemoClaw documentation pages, navigation, or content ownership while preserving published routes. Use for structural documentation refactors.

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

85%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-structured skill body: lean conditional dispatch to verified one-level-deep references, a hard completion contract with validation feedback loops appropriate to destructive route changes, and concrete reporting requirements. Only minor tightening of the repeated plan-vs-implement framing and one worked example of the route/anchor mapping would improve it.

DimensionReasoningScore

Conciseness

The body is dense, declarative, and free of concept explanations Claude already knows (e.g. "Read the full target pages, their navigation entries in docs/index.yml, their redirects in fern/docs.yml"). Minor trimming is possible: the plan-only vs. implemented distinction is restated across "Choose the Deliverable", "Load the phase", and "Completion Contract", so it sits just below anchor 5.

4 / 5

Actionability

Concrete, specific guidance throughout for an instruction-only skill: named artifacts (docs/index.yml, fern/docs.yml, ../_shared/documentation-writing-review.md), a hard completion checklist ("Every visible TOC item that readers can select is a real topic page"), and concrete reporting items. Not a 5 because formats like the required route/anchor mapping are only pointed at, not exemplified, leaving minor gaps.

4 / 5

Workflow Clarity

Clear phase sequence (Prerequisites → Choose the Deliverable → Load the phase → Completion Contract → Report) with explicit validation and a feedback loop for destructive/batch route changes: "Repair findings and rerun affected checks before reporting completion" and "The docs build, route checks, link checks, and diff check pass", plus a completion checklist — matching anchor 5 including the destructive-operation validation requirement.

5 / 5

Progressive Disclosure

The body is a concise overview that conditionally dispatches to three real, one-level-deep references with explicit when-to-load rules ("For an audit or structure plan, use Structure and Ownership"; "Before changing published routes or moving content, use Migration"; "For an implemented refactor, use Validation and Review"). All three files exist in references/ and contain no nested .md references, and "Do not load execution-only detail for a plan-only request" shows deliberate disclosure control — a clean anchor 5.

5 / 5

Total

18

/

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.

A strong description: domain-scoped, third-person, with explicit what and when clauses. The main improvement would be broadening trigger phrasing and slightly richer action enumeration.

Suggestions

Expand the trigger clause with natural variations, e.g. "Use for structural documentation refactors, reorganizing docs navigation, or reassigning content ownership."

Enumerate one or two more concrete outcomes (e.g. producing an ownership map or route migration plan) to lift specificity toward comprehensive coverage.

DimensionReasoningScore

Specificity

"Reorganize NemoClaw documentation pages, navigation, or content ownership while preserving published routes" names the domain and several specific actions (pages, navigation, ownership, route preservation). Not a 5 because it describes objects of work at a summary level rather than enumerating multiple concrete sub-actions.

4 / 5

Completeness

Both parts are explicit: what ("Reorganize … while preserving published routes") and when ("Use for structural documentation refactors"). The when-clause is present but terse and narrow, so it does not reach anchor 5's concrete multi-phrase triggers.

4 / 5

Trigger Term Quality

"structural documentation refactors", "documentation pages", and "navigation" are natural phrases a user would say, giving good coverage. Below 5 because common variations like "reorganize docs", "restructure", or "docs cleanup" are missing.

4 / 5

Distinctiveness Conflict Risk

"NemoClaw" scoping plus the structural-refactor niche gives a clear domain with distinct triggers and minimal conflict risk. Anchor 4's minor-overlap caveat does not apply since no neighboring skill territory is claimed.

5 / 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

relative_links

Relative link issues: 1 suspicious

Warning

Total

15

/

16

Passed

Repository

NVIDIA/NemoClaw

Path

.agents/skills/nemoclaw-maintainer-refactor-docs/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.