CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

technical-writing

Standard for technical prose in four layers: Diataxis document modes, Google developer style, Simplified Technical English and Global English, with templates for ADRs, changelogs and known issues. Use when writing or reviewing docs, RFCs, README files, ADRs, changelog entries, PR descriptions or commit messages.

Quality

87%

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

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

An exceptionally lean and actionable prose standard whose rules each carry concrete micro-examples and a full worked example. Its weaknesses are structural: the sole external reference (TEMPLATES.md) points to a missing file, and the write-then-review workflow has an explicit final checklist but no stated fix-and-recheck loop.

Suggestions

Ship the referenced TEMPLATES.md (ADR, changelog entry, known issue, Mermaid) in the bundle or remove the reference — currently the link is broken and the templates promised in both the description and body are unavailable.

State the full workflow order explicitly as steps (apply layers 1-4, run unslop, review with the checklist, fix and re-check) so the validation loop is a sequence rather than implied.

Guard the unslop dependency: if the unslop skill may not be present, add a one-line fallback for the word-level cuts it currently delegates.

DimensionReasoningScore

Conciseness

The body is dense with rules and free of padding: no explaining what Diataxis or style guides are beyond one operational line each ("Tutorial. You are the teacher and the learner's success is your job"). Every line is an instruction, a micro-example ("'Remove backup file' reads two ways"), or the single worked example — nothing explains concepts Claude already knows. Fits 'lean and efficient; every token earns its place'.

5 / 5

Actionability

For an instruction-only skill the guidance is fully concrete: each rule carries a quoted before/after micro-example ("'the proto import budget check script' becomes 'the script that checks the proto-import budget'"), plus a full worked example with Before/After text and a layer-by-layer explanation. This matches the top anchor's 'specific examples cover the common cases' for a non-code skill.

5 / 5

Workflow Clarity

The process is sequenced ("Apply all four, then run the unslop skill over the result") and closes with an explicit 7-item review checklist, which is genuine validation. But it sits between anchors: there is no per-layer checkpoint and the fix-and-recheck loop is only implied (only two checklist items state a remediation, e.g., "Split it"), so it lacks the full feedback-loop structure of the top anchor.

4 / 5

Progressive Disclosure

Sectioning is good (four layers, worked example, checklist, sources) and the single external reference is clearly signaled ("Templates for an ADR, a changelog entry, a known issue and a Mermaid diagram: TEMPLATES.md"), but TEMPLATES.md does not exist in the bundle — there is no references/ directory at all, so the link is broken and the advertised templates are unreachable. A dangling reference is a navigation failure beyond the 'minor organization gaps' of anchor 4, landing it at anchor 3.

3 / 5

Total

17

/

20

Passed

Description

83%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 with an explicit and well-enumerated 'Use when' clause plus a concrete, jargon-anchored 'what'. It falls just short of the top anchors on specificity and trigger coverage because the 'what' is stated as a standard rather than actions, and it lacks synonyms and file extensions.

Suggestions

Reframe the opening as concrete actions (e.g., "Writes and reviews technical prose to a four-layer standard...") so the 'what' reads as capabilities, not an abstract noun phrase.

Add synonym and extension trigger terms such as "documentation", ".md files", "release notes", or "design docs" to round out natural-keyword coverage.

DimensionReasoningScore

Specificity

The description names its concrete components ("Diataxis document modes", "Google developer style", "Simplified Technical English and Global English", "templates for ADRs, changelogs and known issues") rather than vague fluff, but the 'what' is framed as a standard/thing rather than a list of actions. It lists several specific artifacts but not the multiple concrete actions (rewrite, review, apply templates) that anchor 5 requires.

4 / 5

Completeness

Both halves are explicit: 'what' is "Standard for technical prose in four layers... with templates for ADRs, changelogs and known issues" and 'when' is "Use when writing or reviewing docs, RFCs, README files, ADRs, changelog entries, PR descriptions or commit messages" — a concrete, well-enumerated trigger clause. This matches the top anchor, which requires both what and when with concrete trigger phrases.

5 / 5

Trigger Term Quality

Strong natural vocabulary a developer would say out loud: "docs", "RFCs", "README files", "ADRs", "changelog entries", "PR descriptions", "commit messages". It misses synonyms and file extensions anchor 5 expects (e.g., "documentation", ".md", "release notes"), so it fits 'good keyword coverage; a few natural terms missing' rather than comprehensive.

4 / 5

Distinctiveness Conflict Risk

The niche (a prose-quality standard across engineering artifacts) is clear and the trigger list is artifact-specific, but "commit messages" and "PR descriptions" overlap with dedicated commit-message/PR skills, and "docs"/"README" writing overlaps with general writing skills. Minor overlap risk with closely related skills — anchor 4.

4 / 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 missing

Warning

Total

15

/

16

Passed

Repository

monkilabs/opencastle

Path

src/orchestrator/skills/technical-writing/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.