CtrlK
BlogDocsLog inGet started
Tessl Logo

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

71

Quality

88%

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.

The body is an exemplar of lean, actionable skill authoring: dense tables, executable commands, a sequenced diagnostic workflow with a feedback loop, and a clean one-level reference structure with all bundle paths verified to exist. The only minor gap is that in-workflow validation checkpoints are implied rather than explicitly gated.

DimensionReasoningScore

Conciseness

The body is lean and information-dense — a compact states table, a numbered diagnostic procedure, and two code blocks — with no padding or explanation of concepts Claude already knows; every section earns its place.

5 / 5

Actionability

Provides two copy-paste-ready deno commands with flags and arguments and a concrete seven-step diagnostic procedure with specific, executable actions ('Read 3 random recipes', 'Skim headings only', 'Read the first sentence of each paragraph').

5 / 5

Workflow Clarity

The Diagnose section is a clear sequenced checklist culminating in prioritization ('Pick the one most useful state. Fix that state first') and an explicit end-of-session feedback loop ('Did this help?'), but mid-process validation checkpoints are implicit rather than gated.

4 / 5

Progressive Disclosure

A concise overview points to seven well-signaled, one-level-deep bundle paths (five references + two scripts) via blockquote 'load ...' lines; all referenced files exist and no reference points to another reference, so navigation is clean and shallow.

5 / 5

Total

19

/

20

Passed

Description

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

The description is clear, complete, and well-bounded, answering both what and when with natural trigger terms and an explicit distinction from a sibling skill. Its only weakness is moderate specificity — it leads with a single diagnostic verb rather than enumerating the concrete interventions it performs.

DimensionReasoningScore

Specificity

Names the domain ('cookbook quality') and three concrete diagnostic dimensions ('skimmability, clarity, and reader load') but offers only a single verb ('Diagnose') plus a boundary statement rather than a comprehensive list of actions.

3 / 5

Completeness

Explicitly answers 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') with concrete trigger phrases and an added boundary clarification.

5 / 5

Trigger Term Quality

Natural trigger phrasing ('recipes are hard to follow', 'a new cookbook is starting') covers the common user utterances well, though a few synonymous phrasings a user might say are not present.

4 / 5

Distinctiveness Conflict Risk

Occupies a clear niche (cookbook/recipe quality diagnosis) and explicitly distinguishes itself from a neighboring skill ('It does not set house voice (that's `docs-writing-style`)'), minimizing conflict risk.

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

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