CtrlK
BlogDocsLog inGet started
Tessl Logo

dev-guide-generator

Generates complete technical tutorials from prerequisites and environment setup to core steps, troubleshooting, and a final cheatsheet. Trigger on requests to write a tutorial, create a setup guide, organize steps for beginners, or keywords like step-by-step, quickstart, or how-to guide.

66

Quality

79%

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

Fix and improve this skill with Tessl

tessl review fix ./skills/dev-guide-generator/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

70%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-engineered SOP: the workflow clarity is excellent, with sequenced phases, mode selection, a pre-output quality checklist, and a genuine refinement feedback loop. The main costs are token efficiency (repeated rules across sections inflate the body) and a monolithic structure — the output template, cheatsheet skeleton, and example tutorials would be better served as one-level-deep reference files.

Suggestions

Deduplicate repeated rules: state each rule once (e.g., 'all code blocks specify the language', 'never chmod 777 or commit real keys') in a single Global Writing Rules section and reference it from phases and the Quality Checklist, which repeats them verbatim.

Move the Phase 8 tutorial document template and Phase 7 cheatsheet skeleton into a references/ file (e.g., references/templates.md) and point to them from SKILL.md, adding one-level-deep progressive disclosure and cutting the body substantially.

Add one short worked example (a few lines of a real generated step or error entry from the Docker example in Quick Start) so the placeholder formats ('xxx', 'YOUR_XXX') are grounded in concrete output.

DimensionReasoningScore

Conciseness

The body is mostly efficient — it prescribes formats and rules Claude could not infer rather than explaining known concepts — but at ~375 lines it contains clear redundancy that could be tightened: rules repeat across sections ('code blocks must specify the language' appears in Phase 4, Phase 8 requirements, and the Quality Checklist; the chmod 777 / no-real-keys rules likewise appear twice). This fits the level-3 'mostly efficient but includes some unnecessary explanation or could be tightened' anchor rather than level 4, where only minor trimming would be needed.

3 / 5

Actionability

Guidance is highly concrete for an instruction-only skill: exact step templates ('#### Step N', Objective/Actions/Explanation/Verification), an error-entry format, a cheatsheet skeleton, a full output document template, decision rules (200-word digression rule, 5–10 steps), and a worked Quick Start interaction. It stops short of the level-5 anchor because the formats are fill-in-the-blank placeholders ('xxx', 'YOUR_XXX') with no worked example of a real generated section, leaving minor gaps for the common cases.

4 / 5

Workflow Clarity

Eight phases are sequenced with per-phase goals, steps, and explicit outputs; the Flow Control table picks the interaction mode; the Quality Checklist validates before output; and Iterative Refinement provides an explicit error-recovery loop (identify phase → re-execute → cascade downstream updates → maintain numbering). This matches the level-5 anchor (clear sequence, explicit validation steps, feedback loops, checklists for a complex process) — the level-4 anchor's 'minor validation gaps' criticism does not apply since every phase has a self-check or output gate.

5 / 5

Progressive Disclosure

There are no bundle files and no references at all; everything — including the full tutorial output template, cheatsheet skeleton, and troubleshooting entry format — is inlined in one ~375-line SKILL.md. Section headers give it real structure (above level 2's unstructured inline dump), but content that clearly belongs in separate reference files (the Phase 8 document template, the cheatsheet structure, worked examples) is inline with no external navigation, matching the level-3 anchor.

3 / 5

Total

15

/

20

Passed

Description

88%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: explicit what-and-when structure, third person, concrete component enumeration, and a dedicated trigger sentence with natural user phrasing. Its only weaknesses are a few missing common synonyms ('getting started', 'beginner's guide') and slight overlap risk with general writing requests for how-to content.

DimensionReasoningScore

Specificity

The description enumerates concrete, comprehensive tutorial components — 'from prerequisites and environment setup to core steps, troubleshooting, and a final cheatsheet' — and uses third person ('Generates'), matching the multiple-specific-actions anchor. No concrete action category of the skill's workflow is left unlisted, so it does not fall to the level-4 'minor gaps in coverage' anchor.

5 / 5

Completeness

Both halves are explicit: what it does ('Generates complete technical tutorials from prerequisites and environment setup to core steps, troubleshooting, and a final cheatsheet') and when to use it ('Trigger on requests to write a tutorial, create a setup guide, ... or keywords like step-by-step, quickstart, or how-to guide'). This directly matches the level-5 anchor with concrete trigger phrases; level 4's 'when could be more explicit' criticism does not apply since the trigger clause is a dedicated, specific sentence.

5 / 5

Trigger Term Quality

Natural trigger phrases are well covered: 'write a tutorial', 'create a setup guide', 'organize steps for beginners', 'step-by-step', 'quickstart', 'how-to guide' — all phrases a user would plausibly say. It falls short of the level-5 'comprehensive coverage including synonyms and file extensions' anchor because common variants like 'getting started guide', 'onboarding guide', or 'beginner's guide' (used in the body's own example) are absent.

4 / 5

Distinctiveness Conflict Risk

Technical-tutorial generation is a clear niche with distinct triggers, but 'setup guide', 'how-to guide', and 'step-by-step' can plausibly appear in requests a general writing or documentation skill should handle — the 'minor overlap risk with closely related skills' of the level-4 anchor. It is more distinct than 'somewhat specific but could still overlap with similar skills' (level 3), since the full trigger list points squarely at tutorial authoring rather than generic document work.

4 / 5

Total

18

/

20

Passed

Validation

100%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
zebbern/claude-code-guide
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.