CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

doc-help

Interactive help with Netwrix documentation already in progress or already written. Use whenever the user wants to review, edit, tighten, restructure, or improve an existing doc, section, or paragraph ('review this page', 'does this read well', 'make this clearer', 'how should I structure this', 'fix this section'); asks why Vale or Dale flagged something or what a style rule means; wants to brainstorm or outline before writing; wants a section drafted with their input; or wants an external document (.docx) merged into an existing markdown file. Applies to any file under docs/ or any pasted doc text. When the user hands over source material to write from (a PR, a GitHub issue, Jira ticket, or Azure DevOps item, specs, notes, a detailed prompt), use doc-draft instead.

77

Quality

97%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

—

The risk profile of this skill

SKILL.md
Quality
Evals
Security

Quality

Content

96%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 strong, well-sequenced interactive workflow: concrete commands, scripted dialogs, explicit validate-and-retry lint loops, and clear stage routing. The only real weaknesses are local: the Vale/Dale procedure and the doc-draft handoff are each stated twice, which both pads the token budget slightly and leaves a small organization gap.

Suggestions

Factor the identical Vale/Dale check procedure (run Vale, fix, re-run until zero errors, then /dale, fix, report) into one shared section referenced by both the Drafting and Editing workflows instead of repeating it verbatim in Stage 2 Step 4 and Stage 3 Step 5.

State the doc-draft handoff once (e.g., keep it in 'Tips for Handling Deviations' and trim the second mention in Stage 2 Step 5), removing the remaining duplication.

DimensionReasoningScore

Conciseness

Terse imperative style with no explanation of concepts Claude already knows — every line is instructional ("Read the full document before suggesting any changes", "Do not reprint the full document after each edit — describe what changed and where"). It is not the 5 anchor because of real duplication: the identical Vale/Dale check blocks appear in Stage 2 Step 4 and Stage 3 Step 5 ("Fix all reported errors. Re-run until zero errors remain" twice), and the doc-draft handoff is stated twice (Stage 2 Step 5 and "Tips for Handling Deviations"). It is above the 3 anchor because there is no padded or unnecessary conceptual explanation, only process redundancy.

4 / 5

Actionability

Fully executable, copy-paste-ready commands: "vale <file>", "/dale <file>", "npm run quality:check -- --table", "npm run quality:readability -- <file>". Scripted intake questions, a concrete placeholder ("{/* TODO: add an example */}"), a worked before/after example ("Before: 'It is recommended that you configure...' / After: 'Configure the monitoring plan before enabling auditing.'"), and a sample findings report ("For example, setting the interval to 4 hours means the monitoring plan collects data four times per day") cover the common cases. Per the rubric's note on instruction-only skills, the absence of code blocks beyond commands is not penalized because the guidance is actionable.

5 / 5

Workflow Clarity

Clear sequences in all four stages with numbered steps, and explicit validation feedback loops where they matter for document editing: "Fix all reported errors. Re-run until zero errors remain" followed by the Dale pass and "Report what was fixed across both linters". Stage 2 Step 5 is an explicit checklist (flow/consistency, redundancy/contradictions, sentences that don't earn their place), and the intake stage defines unambiguous routing ("Do not ask 'what do you need?' — they've already told you"). This matches the 5 anchor: explicit validation steps, feedback loops for error recovery, and a checklist.

5 / 5

Progressive Disclosure

Well-structured single file with clearly staged headers and a consistent step pattern; external references are well signaled ("Read `docs/CLAUDE.md` before starting any session. It contains the Netwrix style rules..." and ".claude/references/lint-rules.md lists the rules"). It is not the 5 anchor because the duplicated Vale/Dale check blocks across Stage 2 and Stage 3 are content that should be factored into one shared section (or a one-level-deep reference file), leaving a minor organization gap — exactly the 4 anchor's "minor organization gaps". It is well above the 3 anchor: nothing that clearly belongs in a separate file is inlined.

4 / 5

Total

18

/

20

Passed

Description

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

An exemplary description: it states what the skill does, gives an explicit 'Use whenever' trigger clause with quoted natural user phrases, covers synonyms and file extensions, and closes with an explicit delegation boundary to the sibling doc-draft skill. Third-person voice is used throughout, and the length is dense with trigger-relevant content rather than padding.

DimensionReasoningScore

Specificity

Lists multiple concrete actions across every workflow: "review, edit, tighten, restructure, or improve an existing doc, section, or paragraph", "an external document (.docx) merged into an existing markdown file", "brainstorm or outline before writing", and "asks why Vale or Dale flagged something or what a style rule means". This is comprehensive coverage of the body's four workflows, so it fits the 5 anchor rather than the 4 anchor ("minor gaps in coverage") — no capability in the body is left out.

5 / 5

Completeness

Explicitly answers both questions: what — "Interactive help with Netwrix documentation already in progress or already written" (plus the enumerated capabilities); when — "Use whenever the user wants to review, edit, tighten, restructure..." with concrete quoted trigger phrases, and scope clarified by "Applies to any file under docs/ or any pasted doc text". It also adds an explicit negative boundary ("use doc-draft instead"), which exceeds the 5 anchor's requirement rather than falling to the 4 anchor's "when could be more explicit".

5 / 5

Trigger Term Quality

Comprehensive natural-term coverage including synonyms, file extensions, and literal user utterances: "doc", "section", "paragraph", ".docx", "markdown", "Vale", "Dale", plus quoted phrases users would actually say: "'review this page'", "'does this read well'", "'make this clearer'", "'how should I structure this'", "'fix this section'". This matches the 5 anchor (synonyms + file extensions + natural phrasing); the 4 anchor requires "a few natural terms missing", and none of the common phrasings are missing.

5 / 5

Distinctiveness Conflict Risk

Clear niche with distinct triggers: Netwrix documentation, the Vale/Dale linters, "any file under docs/", and style-rule questions. The main overlap risk (drafting from source material) is explicitly routed away: "When the user hands over source material to write from (a PR, a GitHub issue, Jira ticket, or Azure DevOps item, specs, notes, a detailed prompt), use doc-draft instead". This active disambiguation puts it at the 5 anchor, beyond the 4 anchor's "minor overlap risk with closely related skills".

5 / 5

Total

20

/

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

frontmatter_unknown_keys

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

Warning

Total

15

/

16

Passed

Repository

netwrix/docs

Path

.claude/skills/doc-help/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.