CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

authoring-cookbooks

Diagnose cookbook quality: skimmability, clarity, and reader load. Use when recipes are hard to follow or a new cookbook is starting. It does not set house voice (that's `docs-writing-style`).

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

93%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 skill body: lean, concrete, with verified copy-paste commands and well-signaled one-level-deep references that all exist in the bundle. The only notable gap is that the fix/intervention half of the workflow lacks explicit per-fix validation steps in the main body, though triage itself is rigorously sequenced.

DimensionReasoningScore

Conciseness

The ~64-line body is lean and table-driven with a one-sentence core principle and no explanations of concepts Claude already knows; the only redundancy is the rewrite rule repeated between the intro and 'Do not'. It matches anchor 5 ('Lean and efficient; assumes Claude's competence; every token earns its place') since that single repetition is not over-explanation.

5 / 5

Actionability

Both deno commands are copy-paste ready and exactly match the bundled scripts' documented usage (verified against recipe-scaffold.ts and coverage-audit.ts), and the diagnostic steps are concrete heuristics ('Read 3 random recipes and match them to the states', 'Read the first sentence of each paragraph. It must stand alone'). This matches anchor 5 ('Fully executable; copy-paste ready code or commands; specific examples cover the common cases').

5 / 5

Workflow Clarity

A clear 7-step numbered diagnose sequence with per-step pass criteria ('Headings must tell the story', 'It must stand alone') and a session-end feedback loop with escalation ('Did this solve what you were trying to do?' plus issue filing). It is not a 5 because the fix/intervention phase has no per-fix validation loop in the body; the non-destructive, read-only nature of the operations means the destructive/batch cap does not apply.

4 / 5

Progressive Disclosure

The body is a clear overview with five purpose-labeled, one-level-deep reference pointers ('For expanded symptoms, questions, and interventions, load `references/states.md`' and four others), all verified to exist in references/, plus two bundled scripts. This matches anchor 5 ('Clear overview with well-signaled one-level-deep references; content appropriately split; easy navigation').

5 / 5

Total

19

/

20

Passed

Description

70%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 solid description with an explicit 'Use when' clause, natural trigger phrasing, and a rare explicit disambiguation boundary against a sibling skill. Its main weakness is thin action coverage: it advertises only 'diagnose' while the skill body also scaffolds, audits, and guides fixes.

Suggestions

List the full action set in the description, e.g. 'Diagnose cookbook quality, audit recipe coverage, and scaffold new recipes' so the 'what' is comprehensive rather than a single verb.

Add natural synonyms to the trigger clause, such as 'documentation', 'confusing recipes', or 'recipe writing', to catch users who don't use the word 'cookbook'.

Mention the bundled audit/scaffold tooling briefly so users searching for 'audit my cookbook' or 'recipe template' trigger the skill.

DimensionReasoningScore

Specificity

The description names the domain and three quality dimensions ("Diagnose cookbook quality: skimmability, clarity, and reader load") but lists only one action verb ("diagnose"); the scaffold/audit/guide capabilities in the body are absent, matching the anchor 'Names domain and 1-2 concrete actions, but not comprehensive'. It is not a 4 because it does not list several specific concrete actions.

3 / 5

Completeness

Both 'what' ("Diagnose cookbook quality: skimmability, clarity, and reader load") and 'when' ("Use when recipes are hard to follow or a new cookbook is starting") are explicitly present with two concrete trigger conditions. It is not a 5 because the 'what' is a single high-level action and the trigger coverage is narrower than the comprehensive anchor example.

4 / 5

Trigger Term Quality

Natural phrases users would say are present ("recipes are hard to follow", "a new cookbook is starting", "cookbook quality"), giving good keyword coverage. It is not a 5 because common variations and synonyms such as "documentation", "confusing", or "recipe writing" are missing.

4 / 5

Distinctiveness Conflict Risk

The explicit boundary "It does not set house voice (that's `docs-writing-style`)" disambiguates from the closest sibling skill, and "cookbook"/"recipes" carve a clear niche. It is not a 5 because those terms could still overlap with other documentation-quality or writing skills beyond the one explicitly excluded.

4 / 5

Total

15

/

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

metadata_field

'metadata' should map string keys to string values

Warning

Total

15

/

16

Passed

Repository

saif-shines/devex-kit

Path

plugins/documentation/skills/authoring-cookbooks/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.