minimal-good

Use when testing doraval validate and drift commands.

Quality

48%

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 ./test/fixtures/skills/minimal-good/SKILL.md

Quality

Content

47%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 body is brief and appropriately small for a simple skill, but its steps are vague, the code example is a placeholder, and there is no validation or failure-handling guidance.

Suggestions

Replace the `echo hello` placeholder with the actual command used to run the test suite (e.g., `doraval validate` / `doraval drift`).

Make "Verify the output" concrete by stating what to check for and what to do on failure, adding a validate→fix→retry feedback loop.

Remove the meta filler ("MUST follow the rubric. MUST NOT skip steps.") since it adds no executable guidance.

Dimension	Reasoning	Score
Conciseness	The body is lean and assumes competence, but the lines "MUST follow the rubric. MUST NOT skip steps." and the placeholder `echo hello` are minor trimmable filler, placing it just below the fully-lean level-5 anchor.	4 / 5
Actionability	Steps "Run the test suite" and "Verify the output" are high-level hints missing specific commands, and the only code block (`echo hello`) is a placeholder rather than executable test guidance, matching the level-2 anchor of minimal concrete guidance.	2 / 5
Workflow Clarity	A rough two-step sequence is present but steps are poorly defined with no validation checkpoint or failure-handling feedback loop, fitting the level-2 anchor of a rough sequence with gaps and absent validation.	2 / 5
Progressive Disclosure	This is a small single-purpose skill under 50 lines with no bundle files and no need for external references; it is appropriately scoped with a heading, but the generic title and lack of any section structure keep it below the well-organized level-5 anchor.	4 / 5
	Total	12 / 20 Passed

Description

48%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, specific, and provides an explicit trigger clause, but it leans on a single generic action ("testing") and only weakly states what the skill does beyond when to use it.

Suggestions

Add a concrete verb beyond "testing" (e.g., "Runs doraval validate and drift commands and reports failures") to lift specificity.

Expand the trigger with natural synonyms or phrasings users might say (e.g., "Use when checking doraval for drift or running validation").

Separate the "what" from the "when" so the skill's action is stated explicitly before the "Use when" clause.

Dimension	Reasoning	Score
Specificity	The description names the domain ("doraval validate and drift commands") but the only action verb is the generic "testing", matching the anchor that names the domain with minimal/generic actions rather than the level-3 anchor requiring concrete actions.	2 / 5
Completeness	An explicit "Use when..." clause supplies a clear "when", and the "what" (testing validate/drift commands) is only weakly implied and terse, so it sits above the "only when, no what" level-2 anchor but below the level-4 anchor where both are explicit.	3 / 5
Trigger Term Quality	Phrases like "testing", "doraval", "validate", and "drift" are natural enough for a niche tool, but coverage lacks common synonyms or variations, fitting the level-3 anchor of some relevant keywords with missing variations.	3 / 5
Distinctiveness Conflict Risk	The named tool "doraval" and its "validate" and "drift" commands form a clear niche with minimal conflict risk, though the generic words "validate"/"drift" could appear in other contexts, keeping it just below a clean level-5.	4 / 5
	Total	12 / 20 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: saif-shines/doraval
Path: test/fixtures/skills/minimal-good/SKILL.md
Commit: 0fa2092

Reviewed: 1 day 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.