help

Full reference guide for Ouroboros commands and agents

Quality

57%

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/help/SKILL.md

Quality

Content

65%

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 and clearly organized as a reference, but it is verbose due to duplicated command/skill tables and lacks progressive disclosure since all reference material sits inline with no supporting bundle files. Splitting the reference tables into separate files and de-duplicating would improve both dimensions.

Suggestions

De-duplicate the command and skill listings — the 'All Commands' and 'Available Skills' sections overlap heavily; consolidate or cross-reference instead of repeating rows.

Move the agent table and detailed command reference into a separate reference file (e.g. references/commands.md) and link to it from the overview to enable progressive disclosure.

Add a brief verification step after `ooo setup` (e.g. 'run `ooo status` to confirm the MCP server registered') so the setup workflow has an explicit checkpoint.

Dimension	Reasoning	Score
Conciseness	The body is accurate and well-categorized but carries notable redundancy — commands reappear in both the 'All Commands' and 'Available Skills' tables — so it is mostly efficient but could be tightened, matching the mid anchor.	2 / 3
Actionability	It provides concrete, copy-paste-ready commands (`ooo setup`, `/ouroboros:help`) plus exact natural-language trigger mappings, fully executable guidance appropriate for a reference skill.	3 / 3
Workflow Clarity	Sections are clearly organized but this is reference material with no multi-step workflow or validation checkpoints, and the setup step lacks a verify/check sequence; structure is present but checkpoints are missing.	2 / 3
Progressive Disclosure	No bundle files exist and the body references no external files, leaving ~156 lines of commands/skills/agents reference content entirely inline in one file; content that could be split into separate reference files is inline, matching the mid anchor.	2 / 3
	Total	9 / 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 identifies its Ouroboros domain but relies on generic 'reference guide' language and omits any explicit usage trigger, leaving all dimensions at the mid level. Adding concrete actions and a 'Use when...' clause would lift specificity and completeness.

Suggestions

Replace the abstract 'Full reference guide' phrasing with concrete actions the skill performs, e.g. 'Lists Ouroboros commands, skills, and agents and maps natural-language phrases to the matching command.'

Add an explicit trigger clause such as 'Use when the user asks about Ouroboros commands, available skills, or how to invoke a specific workflow.'

Include natural trigger terms users would actually say ('ouroboros commands', 'what can ooo do', 'list ouroboros skills') to improve trigger-term coverage.

Dimension	Reasoning	Score
Specificity	The phrase 'reference guide for Ouroboros commands and agents' names the domain but uses an abstract action ('reference guide') rather than listing concrete actions, matching the anchor that names a domain and some actions but is not comprehensive.	2 / 3
Completeness	It states what the skill does (a reference guide for commands and agents) but provides no explicit 'when to use' trigger, which the rubric caps at 2 for a missing 'Use when...' clause.	2 / 3
Trigger Term Quality	It includes the relevant keyword 'Ouroboros' but lacks natural user-spoken trigger phrases or 'Use when...' variations, fitting the anchor for some relevant keywords missing common variations.	2 / 3
Distinctiveness Conflict Risk	The Ouroboros scoping gives it a recognizable niche, but 'reference guide for commands and agents' is generic enough to overlap with sibling help/reference skills, matching the somewhat-specific anchor.	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/help/SKILL.md
Commit: f09fa36

Reviewed: about 3 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.