setup

Guided onboarding wizard for Ouroboros setup

Quality

63%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Low

Low-risk findings worth noting

Fix and improve this skill with Tessl

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

Quality

Content

77%Weight 40%Scale 1-3

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

This is a thoroughly actionable, well-sequenced setup wizard with strong workflow clarity and validation. Its main weaknesses are verbosity from decorative/marketing content and a monolithic single-file structure with no progressive disclosure to supporting files.

Dimension	Reasoning	Score
Conciseness	The body is highly actionable but padded with decorative ASCII banners, celebration checkpoints, and marketing copy ("Let's unlock your full AI development potential", "You're going to love seeing vague ideas turn into crystal-clear specifications") that do not earn their tokens; it could be tightened substantially.	2 / 3
Actionability	It provides copy-paste-ready bash commands, exact MCP tool call arguments, JSON config payloads, decision matrices, and a full CLAUDE.md preview block — concrete and executable throughout.	3 / 3
Workflow Clarity	The 6-step wizard is clearly sequenced (Step 0 through Step 6) with a decision matrix, verification step (Step 4), troubleshooting, and explicit deferred-schema validation feedback loops in the brownfield scan section.	3 / 3
Progressive Disclosure	No bundle files exist (references/scripts/assets absent) and the skill is a monolithic ~650-line SKILL.md with content that could be split out (troubleshooting, conversion metrics, the CLAUDE.md block) kept fully inline, matching the mid anchor.	2 / 3
	Total	10 / 12 Passed

Description

50%Weight 40%Scale 1-3

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 concise and tied to a specific product, but it is generic about capabilities and entirely missing explicit use-when trigger guidance. It reads as a tagline rather than a trigger-rich skill description.

Suggestions

Add a concrete capability list, e.g. "Registers the Ouroboros MCP server, integrates CLAUDE.md, and scans for existing repos."

Append an explicit trigger clause such as "Use when the user wants to set up, configure, or onboard to Ouroboros."

Include natural keyword variations ("setup", "install", "configure", "onboarding") to improve trigger coverage.

Dimension	Reasoning	Score
Specificity	"Guided onboarding wizard for Ouroboros setup" names the domain (onboarding) and an action framing (wizard/setup), but lists no concrete actions like registering an MCP server or scanning repos, so it stops short of the multi-action anchor.	2 / 3
Completeness	It states what the skill does (guided onboarding for Ouroboros setup) but provides no "Use when..." clause or equivalent trigger guidance, which caps completeness at 2 per the judging guidelines.	2 / 3
Trigger Term Quality	"onboarding wizard" and "setup" are natural terms a user might say, but coverage is thin with no common variations or surface triggers; it has some relevant keywords but misses the breadth of the top anchor.	2 / 3
Distinctiveness Conflict Risk	Tying it to the named product "Ouroboros" helps, but the generic "onboarding wizard" framing with no distinct triggers could still overlap with other setup-related skills, matching the mid anchor.	2 / 3
	Total	8 / 12 Passed

Validation

87%

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 — 14 / 16 Passed

Validation for skill structure

Criteria	Description	Result
skill_md_line_count	SKILL.md is long (659 lines); consider splitting into references/ and linking	Warning
relative_links	Relative link issues: 1 missing	Warning

	Total	14 / 16 Passed

Repository: Q00/ouroboros
Path: .claude-plugin/skills/setup/SKILL.md
Commit: f09fa36

Reviewed: 6 days 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.