CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

ce-doc-review

Review requirements, plans, or specs with role-specific lenses. Use when the user wants to improve an existing planning document.

Quality

81%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

85%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 well-orchestrated multi-phase skill body: the workflow is clearly sequenced with explicit validation checkpoints and failure-recovery loops, and the bundle is structured as a lean overview with well-signaled, verified one-level-deep references. Only minor improvements are available — slight rule duplication with modes.md and a few mechanics delegated to references without inline bounds.

DimensionReasoningScore

Conciseness

The body is dense and imperative throughout, teaching nothing Claude already knows, and every section carries operational rules. It falls just short of anchor 5 because the question-tool rules in "Interactive mode rules" are restated more fully in references/modes.md — a minor duplication that could be trimmed by trusting the reference.

4 / 5

Actionability

Concrete inline guidance is abundant: exact command ("`<repo-root>` = `git rev-parse --show-toplevel`"), exact paths ("references/personas/<reviewer-name>.md"), explicit conditionals ("Run this pass if any of the conditional judgment trio was activated"), and failure routes ("A capacity rejection is backpressure, not reviewer failure: wait and retry"). Not anchor 5 because a few mechanics (the parallelism bound, the announcement format) are named but defined only in references; not anchor 3 because what is stated inline is specific and executable.

4 / 5

Workflow Clarity

Phases 1-2-3-5 are clearly sequenced with the reference to read at each step, explicit validation checkpoints ("Every resolved path must be readable on disk. If one is not, dispatch **no** personas"; "Wait until every dispatched agent has returned"), a "Done when" completion checklist, and feedback loops for error recovery (capacity retry, stop-as-incomplete while preserving collected outcomes, peer timeouts named in Coverage). This matches anchor 5.

5 / 5

Progressive Disclosure

Verified against the actual bundle: every path the body references exists (modes, document-intake, persona-selection, dispatch, cross-model-review, synthesis-and-presentation, walkthrough, bulk-preview, subagent-template, findings-schema), alongside 7 persona files and 3 scripts. The 77-line overview signals each read per phase, defers interactive-only references until evidence is complete, and uses @-includes for the dispatch payload; cross-references among reference files are lateral single-source citations, not nested chains. This matches anchor 5.

5 / 5

Total

18

/

20

Passed

Description

70%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 concise, third-person description that clearly answers both what the skill does and when to use it, with natural trigger terms for the planning-document niche. The main weakness is that the capability statement stays at one abstract action ("review with role-specific lenses") without naming the concrete activities the skill actually performs.

Suggestions

Replace the abstract phrase "with role-specific lenses" with 1-2 concrete actions the skill performs, e.g. "dispatch role-specific reviewer personas and apply authorized fixes to the findings".

Broaden trigger coverage with common synonyms users say for planning documents, such as "PRD", "RFC", "design doc", or "spec review".

DimensionReasoningScore

Specificity

Names the domain (requirements, plans, specs) and one concrete action ("Review ... with role-specific lenses"), but "role-specific lenses" is abstract and no further concrete actions (e.g., dispatch reviewer personas, apply authorized fixes) are stated. It sits at anchor 3: not anchor 4 because several specific actions are not listed, and not anchor 2 because a concrete action beyond bare domain naming is present.

3 / 5

Completeness

Both parts are present in third person: what ("Review requirements, plans, or specs with role-specific lenses") and when ("Use when the user wants to improve an existing planning document"). Not anchor 3 because the "when" is explicit rather than weakly implied; not anchor 5 because the "when" is a single condition and the "what" is abstract, lacking the concrete trigger phrases of the exemplar.

4 / 5

Trigger Term Quality

"requirements, plans, or specs", "improve", and "planning document" are natural user phrases with good coverage of the domain. Not anchor 3 because coverage goes well beyond one or two generic keywords; not anchor 5 because common variations like "PRD", "RFC", "design doc", or "spec review" are missing.

4 / 5

Distinctiveness Conflict Risk

"role-specific lenses" plus "planning document" carve a recognizable niche for structured document review. Not anchor 3 because it is more specific than generic document-file handling; not anchor 5 because there is minor overlap risk with adjacent document-editing and general feedback skills.

4 / 5

Total

15

/

20

Passed

Validation

93%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

15

/

16

Passed

Repository

EveryInc/compound-engineering-plugin

Path

skills/ce-doc-review/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.