CtrlK
BlogDocsLog inGet started
Tessl Logo

doc-help

Interactive writing assistant for Netwrix documentation. Use when a writer wants hands-on, conversational help: brainstorming structure, drafting a section, editing existing content, incorporating external documents (e.g., .docx files) into existing markdown files, or understanding a style or Vale rule. For fully autonomous tasks (write this entire doc, fix all Vale errors end-to-end), use the tech-writer agent instead.

86

1.18x
Quality

90%

Does it follow best practices?

Impact

69%

1.18x

Average score across 3 eval scenarios

SecuritybySnyk

—

The risk profile of this skill

SKILL.md
Quality
Evals
Security

Quality

Content

88%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 interactive workflow skill with highly actionable guidance, explicit validation loops around Vale/Dale, and clear sequencing across its drafting, editing, and style-question workflows. Its main weaknesses are minor: verbatim duplication of the Vale/Dale step across stages and no use of bundle files to keep the main SKILL.md leaner.

Suggestions

Deduplicate the identical Vale/Dale check block in Stage 2 Step 4 and Stage 3 Step 5 into a single shared section (e.g., '## Vale and Dale check') referenced from both workflows to cut ~8 lines.

Consider moving the Stage 2 Drafting and Stage 3 Editing workflows into reference files (e.g., references/DRAFTING.md, references/EDITING.md), keeping SKILL.md as a trigger-plus-intake overview, so the interactive details load only when needed.

DimensionReasoningScore

Conciseness

The body is efficient and assumes Claude's competence (no explanations of what Vale or markdown are), but the Vale/Dale check block is duplicated verbatim in Stage 2 Step 4 and Stage 3 Step 5, and some connective framing ('Act as a patient, knowledgeable writing partner') could be trimmed — minor instances rather than the unnecessary explanations of the 3 anchor.

4 / 5

Actionability

Guidance is fully executable for an instruction-only skill: exact intake questions, concrete section patterns, the exact commands 'vale <file>' and '/dale <file>', a worked example finding report, and a before/after style example — copy-paste-ready and covering the common cases.

5 / 5

Workflow Clarity

Each of the three workflows is clearly sequenced with explicit validation checkpoints and feedback loops — 'Fix all reported errors. Re-run until zero errors remain', iterative confirmation after each edit round ('Ask if the changes look right before continuing'), and hand-off guidance when a task grows large.

5 / 5

Progressive Disclosure

Well-organized sections with one clearly signaled one-level reference ('Read docs/CLAUDE.md before starting any session'), but no bundle files exist and all three full workflows live inline in a ~210-line SKILL.md; the drafting and editing workflows could plausibly be split into separate reference files — good structure with minor organization gaps, fitting 4 rather than 5.

4 / 5

Total

18

/

20

Passed

Description

92%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 that states concrete capabilities, gives explicit 'Use when' triggers with natural terms and a file extension, and cleanly separates itself from the fully-autonomous tech-writer agent. The only minor gap is a few missing natural trigger variations users might phrase differently.

DimensionReasoningScore

Specificity

The description lists multiple concrete actions — 'brainstorming structure, drafting a section, editing existing content, incorporating external documents (e.g., .docx files) into existing markdown files, or understanding a style or Vale rule' — giving comprehensive coverage of the skill's capabilities within its domain, matching the 5 anchor rather than the 4 anchor (which requires minor gaps).

5 / 5

Completeness

It explicitly answers both 'what' ('Interactive writing assistant for Netwrix documentation' with enumerated actions) and 'when' ('Use when a writer wants hands-on, conversational help: ...') with concrete trigger phrases, and adds boundary guidance for when to use the tech-writer agent instead — matching the 5 anchor exactly.

5 / 5

Trigger Term Quality

Good keyword coverage including natural phrases and a file extension ('drafting', 'editing', '.docx files', 'style or Vale rule'), but a few natural trigger variations users would say are missing (e.g., 'review my doc', 'fix this Vale error'), placing it between the 4 and 5 anchors but noticeably below the comprehensive-synonym coverage of 5.

4 / 5

Distinctiveness Conflict Risk

A clear niche (Netwrix documentation, Vale rules, .docx incorporation) with distinct trigger terms, plus explicit disambiguation from the adjacent tech-writer agent ('For fully autonomous tasks... use the tech-writer agent instead'), giving minimal conflict risk.

5 / 5

Total

19

/

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