CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

write-manual

Writes a long technical manual that explains one subject at one pinned version, from its purpose to each request and response. Every listing comes from an offline capture, every claim traces to a ranked source, and an audit must report TOTAL 0. Use it for "write a manual", "write a 101 manual for <subject>", "manual.json", "add a manual section", "build a capture kit", "audit the manual", or "pin a spec version and document it".

Quality

90%

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

92%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 exemplary instruction-only skill body: a fully sequenced method with embedded validation loops and a completion checklist, quantified rules throughout, and a clean one-level reference bundle that exists on disk. The only improvement available is consolidating the small amount of repeated invariant statements to save tokens.

Suggestions

State the "TOTAL 0" merge gate once (e.g., in Build and audit) and reference it from the checklist to trim repeated invariant statements.

Drop Method step 13 or the first Commit rules bullet, since "Size commits by judgment" is stated verbatim in both places.

DimensionReasoningScore

Conciseness

The body is dense and prescriptive (prose-limit table, fenced-block table, arrow-style table) with no padding that explains concepts Claude already knows; the manual-vs-lesson sentences define the skill's own terminology. It stops short of 5 because of trimmable redundancy: the "TOTAL 0" invariant is stated four times (intro, Method step 12, Build and audit, checklist) and "Size commits by judgment" appears as both Method step 13 and again in Commit rules.

4 / 5

Actionability

Fully concrete, executable guidance: exact build commands ("node --test site/test_manuals.js", "node scripts/audit_manuals.js --manual <id>"), an exact commit message format ("feat(manual/<id>): <section slug>"), quantified limits ("at most 25 words", "viewBox=\"0 0 640 H\" with H at most 760, text at least 11 units"), and required keys per fence kind. For an instruction-only skill this is copy-paste-ready and matches anchor 5.

5 / 5

Workflow Clarity

A 13-step numbered Method in dependency order with an explicit validation feedback loop ("Fix every finding until the audit prints `TOTAL 0`", "Fix the text, never the limit"), a capture drift check, and a 10-item "Check before you finish" checklist. Sequence, checkpoints, feedback loop, and checklist are all present, matching anchor 5.

5 / 5

Progressive Disclosure

All six referenced files (research-and-sources.md, capture-kit.md, manual-json.md, section-template.md, prose-rules.md, audit.md) exist in references/, are linked at the point of use, are one level deep, and are indexed in a "Files" section; bulky detail (audit rules, banned words, schema fields) is correctly split out. This matches anchor 5's clear-overview pattern.

5 / 5

Total

19

/

20

Passed

Description

87%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: third-person voice, explicit what-and-when structure, and a set of quoted natural trigger phrases that carve out a distinct niche. The only gaps are a few missing natural synonyms (documentation, spec reference, guide) and a what-clause centered on one action rather than an enumeration of capabilities.

Suggestions

Add one or two natural trigger synonyms such as "document a protocol/format" or "write the reference documentation for <subject>" so users who say "documentation" instead of "manual" still hit the skill.

Enumerate one or two component actions (e.g., "build the offline capture kit and audit the result") in the what-clause to broaden capability coverage without adding length.

DimensionReasoningScore

Specificity

The description states a concrete what ("Writes a long technical manual that explains one subject at one pinned version, from its purpose to each request and response") plus concrete invariants ("Every listing comes from an offline capture, every claim traces to a ranked source, and an audit must report TOTAL 0"). These are facets of one main action rather than a list of multiple distinct actions, matching anchor 4; it is well above 3 in concreteness but short of 5's multi-action comprehensiveness.

4 / 5

Completeness

It explicitly answers both what ("Writes a long technical manual that explains one subject at one pinned version...") and when ("Use it for...") with a list of concrete trigger phrases. This matches the anchor-5 example pattern exactly; 4 would require the when to be less explicit, which it is not.

5 / 5

Trigger Term Quality

Seven natural quoted triggers ("write a manual", "write a 101 manual for <subject>", "manual.json", "add a manual section", "build a capture kit", "audit the manual", "pin a spec version and document it") give good coverage including the manifest filename. A few natural synonyms a user might say, such as "write documentation for X" or "spec reference/guide", are missing, so it fits anchor 4 rather than 5's comprehensive synonym coverage.

4 / 5

Distinctiveness Conflict Risk

The niche is clear (pinned-version 101 manuals with offline capture kits, ranked sources, and a TOTAL 0 audit) and the triggers ("101 manual", "manual.json", "capture kit", "pin a spec version") are phrases unlikely to fire any other skill. Minimal overlap risk with generic documentation skills, matching anchor 5.

5 / 5

Total

18

/

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

referenced_paths_exist

Referenced path issues: 1 missing

Warning

Total

14

/

16

Passed

Repository

rohitg00/ai-engineering-from-scratch

Path

.claude/skills/write-manual/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.