tutorial

Interactive tutorial teaching Ouroboros hands-on

Quality

63%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./.claude-plugin/skills/tutorial/SKILL.md

Quality

Content

77%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

The body is a well-structured, actionable tutorial with a clear phased workflow and feedback loops, but it is over-long for a single file and does not progressively disclose detail into referenced bundle files. Trimming auxiliary sections and offloading variations/responses would improve token efficiency and disclosure.

Suggestions

Move "Tutorial Variations" and "Common Tutorial Responses" into a referenced bundle file (e.g. responses.md) and link to it from the main flow to reduce inline length.

Trim or relocate the RFC #1392 breadcrumb footer and "Tutorial Principles"/"Success Metrics" sections that restate content already implied by the phased flow.

Keep the core six-phase script front and center as a lean overview so the SKILL.md body stays closer to a navigable hub.

Dimension	Reasoning	Score
Conciseness	The phased script is mostly purposeful, but canned dialogue plus auxiliary sections ("Tutorial Principles", "Success Metrics", "Tutorial Variations") and the tangential RFC #1392 breadcrumb footer add padding that could be trimmed.	2 / 3
Actionability	Provides copy-paste-ready dialogue blocks, specific commands (ooo interview, ooo seed, ooo run), and concrete bracketed interaction cues, giving Claude exact instructions for an instructional skill.	3 / 3
Workflow Clarity	A clear six-phase sequence with timings, a checkbox checkpoint list, success metrics, and objection-handling responses that act as feedback loops; not a destructive/batch operation so no validation cap applies.	3 / 3
Progressive Disclosure	Sections are well organized, but the ~240-line body is monolithic with no external references and inline content (variations, common responses, full dialogue) that could be split into bundle files.	2 / 3
	Total	10 / 12 Passed

Description

50%

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 correctly identifies the product and format in third person, but it is vague about concrete actions and omits any explicit use-when trigger guidance. Adding a "Use when..." clause with natural trigger terms would raise most dimensions.

Suggestions

Add an explicit trigger clause, e.g. "Use when the user wants to learn Ouroboros, asks for a tutorial, or says they want to get started hands-on."

List concrete actions the tutorial performs (e.g. "guides a learn-by-doing interview, generates a starter seed, and demos the core commands") instead of the abstract "teaching hands-on".

Include common trigger variations ("learn", "get started", "walkthrough", "onboarding") alongside "tutorial".

Dimension	Reasoning	Score
Specificity	Names the domain ("Ouroboros", "tutorial") and a general action ("teaching hands-on") but stays abstract rather than listing multiple concrete actions like the score-3 anchor.	2 / 3
Completeness	States what the skill does (a hands-on tutorial for Ouroboros) but lacks any "Use when..." clause, which per the guidelines caps completeness at 2.	2 / 3
Trigger Term Quality	"tutorial" and "Ouroboros" are plausible user terms, but coverage is thin and misses common variations such as "learn", "guide", or "walkthrough".	2 / 3
Distinctiveness Conflict Risk	The specific product name "Ouroboros" gives it a niche, but the generic word "tutorial" could overlap with other onboarding-style skills.	2 / 3
	Total	8 / 12 Passed

Validation

100%

Warnings & errors only

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: Q00/ouroboros
Path: .claude-plugin/skills/tutorial/SKILL.md
Commit: f09fa36

Reviewed: about 2 hours ago

Table of Contents

Discovery Implementation Validation

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.