setup

Guided onboarding wizard for Ouroboros setup

Quality

59%

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

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

The content is highly actionable with a clearly sequenced, validation-backed wizard flow. Its main weaknesses are verbose marketing/celebration padding and a monolithic single-file structure that inlines material which could be split into referenced files.

Suggestions

Trim marketing language and decorative ASCII banners in Steps 0, 5, and 6 to reduce token cost without losing the wizard content.

Move the full CLAUDE.md preview block and the Python resolver into referenced files under references/ and link to them, keeping SKILL.md an overview.

Reconcile inconsistent counts (Step 4 says '12+ skills' / '20+ agents' while Step 5 says '15 skills' / '9 agents') so verification guidance is unambiguous.

Dimension	Reasoning	Score
Conciseness	The body is mostly efficient with concrete wizard content, but includes unnecessary marketing fluff ("unlock your full AI development potential", "85% savings on average") and repeated decorative celebration banners that could be trimmed, fitting the score-3 anchor.	3 / 5
Actionability	Guidance is fully executable: a copy-paste Python resolver, exact MCP tool calls with argument objects, AskUserQuestion JSON payloads, and concrete bash verification commands cover the common cases, matching the score-5 anchor.	5 / 5
Workflow Clarity	Steps 0-6 are clearly sequenced with explicit validation/celebration checkpoints, a decision matrix, backup-before-mutate handling for CLAUDE.md, and a feedback loop in troubleshooting, matching the score-5 anchor.	5 / 5
Progressive Disclosure	Sections are well-headed and inline references to docs/getting-started.md and ../config/SKILL.md are one level deep, but ~700 lines are monolithically inlined (full CLAUDE.md preview block, full resolver) and no bundle files exist, fitting the score-3 anchor of some structure with heavy inlining.	3 / 5
	Total	16 / 20 Passed

Description

41%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 short and brand-distinct but thin: it states the purpose without listing concrete actions or an explicit trigger clause. It passes on distinctiveness but underserves specificity and trigger-term coverage.

Suggestions

Add 2-3 concrete actions the wizard performs (e.g., 'detects your Python/uv environment, configures the Claude SDK runtime, and registers brownfield repos').

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

Include natural synonyms users would say (configure, install, get started) alongside 'setup' to improve trigger-term coverage.

Dimension	Reasoning	Score
Specificity	The description names the domain ("Ouroboros setup") but the only action is the generic "Guided onboarding wizard", with no concrete setup actions listed, matching the score-2 anchor "Names the domain but actions are minimal or generic".	2 / 5
Completeness	It gives a clear "what" ("Guided onboarding wizard for Ouroboros setup") but has no "Use when..." trigger clause, so per the rubric completeness is capped at 3 for a clear what with missing when.	3 / 5
Trigger Term Quality	Only "onboarding" and "setup" appear as keywords; natural phrases users would say like "configure", "install", or "get started with Ouroboros" are missing, fitting the score-2 anchor of one or two generic keywords.	2 / 5
Distinctiveness Conflict Risk	The "Ouroboros" qualifier gives it a clear niche with low conflict risk, but the generic "setup"/"onboarding" terms leave minor overlap risk with other setup skills, fitting the score-4 anchor.	4 / 5
	Total	11 / 20 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 (710 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: c801447

Reviewed: ~23 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.