CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

review-with-dora

Use when reviewing agent context (SKILL.md, plugin, rule, AGENTS.md) with dora before reporting done. Also when ask-dora routes a Dora job (review, fix, unused, scan), or the user asks to review, diagnose, or clean up Claude, Cursor, Codex, Copilot, or Grok context.

68

Quality

85%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

SKILL.md
Quality
Evals
Security

Quality

Content

88%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.

A lean, highly executable skill body with a clearly gated six-step workflow, explicit exit-code validation, and re-review feedback loops. Its only real weakness is organization: the inline harness subcommand list in Side paths duplicates reference content that already has a home in commands.md.

DimensionReasoningScore

Conciseness

The body is aggressively lean and telegraphic — 'You run `dora`. Assess the agent setup in this project and show what to fix' — with zero padding and no explanation of concepts Claude already knows; every token earns its place.

5 / 5

Actionability

Concrete copy-paste commands throughout: 'dora review --quick <path>', 'dora fix <path> --dry-run' / '--yes' / '--brief', the 'npx @hacksmith/doraval' PATH fallback, and enumerated fix-item fields. Minor gaps remain in step 4, where the replacement procedure ('Write the smallest wording that states it') is necessarily abstract guidance rather than executable commands.

4 / 5

Workflow Clarity

The six-step loop is clearly sequenced with an explicit validation gate ('Done: **exit 0**. That is the only report-done.'), per-step Done checklists, and a genuine feedback loop — 'Re-review. `dora review --quick <path>` after every edit' — plus dry-run before '--yes' on writes, so the destructive/batch cap does not apply.

5 / 5

Progressive Disclosure

The overview cleanly signals one-level-deep references — 'Verbs: [commands.md](references/commands.md). Exit codes and JSON: [output.md](references/output.md)' — and both files exist with no nested links. Minor gap: the 'Side paths' section inlines a dense enumeration of a dozen harness subcommands whose detail already lives in commands.md.

4 / 5

Total

18

/

20

Passed

Description

75%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.

A solid trigger-oriented description with an explicit 'Use when...' clause, natural trigger phrases, and a distinct niche around agent-context review. Its weakness is a circular 'what': it says to review with dora but never states what dora does or outputs, keeping every dimension just short of the top anchor.

Suggestions

State the concrete outcome of running dora in the description (e.g., 'runs dora to find issues in agent context and applies mechanical fixes') instead of the circular 'reviewing ... with dora'.

Add common synonyms users would naturally say for the trigger clause, such as 'audit', 'lint', or 'check' agent context.

Briefly enumerate dora's operation set (review, fix, diagnose) as capabilities rather than only as routed job names.

DimensionReasoningScore

Specificity

Quotes several concrete actions and named artifacts — 'reviewing agent context (SKILL.md, plugin, rule, AGENTS.md)', 'routes a Dora job (review, fix, unused, scan)', 'review, diagnose, or clean up' — but what dora actually produces (findings, assessment) is left implicit, so coverage has minor gaps rather than being comprehensive.

4 / 5

Completeness

An explicit 'Use when...' clause with multiple triggers is present, and the 'what' ('reviewing agent context ... with dora before reporting done') is stated, but the what is somewhat circular — the actual operation dora performs is not spelled out — so it does not clearly and explicitly answer both at the anchor-5 level.

4 / 5

Trigger Term Quality

Good natural keyword coverage: 'review', 'diagnose', 'clean up', 'SKILL.md', 'AGENTS.md', 'plugin', 'rule', and tool names 'Claude, Cursor, Codex, Copilot, or Grok'. A few common synonyms users might say ('audit', 'lint', 'check') are missing, so it falls short of the comprehensive anchor.

4 / 5

Distinctiveness Conflict Risk

It carves a clear niche — reviewing agent context files via a specific named tool with specific file types — making it mostly distinct; minor overlap risk remains with generic code-review or cleanup skills triggered by the word 'review'.

4 / 5

Total

16

/

20

Passed

Validation

100%

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

skills/review-with-dora/SKILL.md

Reviewed

Table of Contents

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.