CtrlK
BlogDocsLog inGet started
Tessl Logo

ce-doc-review

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

64

Quality

77%

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

Fix and improve this skill with Tessl

tessl review fix ./skills/ce-doc-review/SKILL.md

The canonical home for this skill is ce-doc-review in EveryInc/compound-engineering-plugin

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-engineered orchestration body: lean, dense, and procedural, with an explicitly sequenced multi-phase workflow, real validation checkpoints, failure/backpressure handling, and exemplary just-in-time progressive disclosure. Its only weakness is minor — a few rationale sentences and operational details deferred to references that leave small gaps when the body is read alone.

DimensionReasoningScore

Conciseness

The body is dense and procedural with essentially no padding — no explanations of what a document or a persona is; it assumes Claude's competence. Not 5 because a few sentences carry rationale that could be trimmed (e.g., "so they cannot reach a path that exists only on an unchecked-out branch (issue #925)" and the "never depends on a repo root or a CE config it does not need" clause), placing it at anchor 4: efficient with minor instances that could be tightened.

4 / 5

Actionability

Guidance is concrete and executable: exact reference files to read with explicit timing, exact config rules ("Read `docs_root` from `<repo-root>/.compound-engineering/config.yaml` only", `git rev-parse --show-toplevel`), explicit classification rules, and a defined team roster. Not 5 because much operational detail (payload variables, slicing, announcement format, synthesis rules) is delegated to references rather than specified inline, leaving minor gaps if read in isolation — anchor 4, mostly executable guidance with minor gaps. Per the rubric's scoring note, the absence of code in this instruction-only skill is not penalized.

4 / 5

Workflow Clarity

The multi-step process is explicitly sequenced (Phase 1 intake/classification, Phase 2 announce/dispatch, Phases 3-5 synthesis/presentation) with explicit validation checkpoints and feedback loops: "Verify before any dispatch. Every resolved path must be readable on disk", "Wait until every dispatched agent has returned", capacity-rejection retry/backpressure handling, a stop-as-incomplete path with preserved evidence, and a concrete Done-when checklist. This matches anchor 5 — clear sequence, explicit validation, error-recovery loops.

5 / 5

Progressive Disclosure

The body is a lean orchestrator over one-level-deep, well-signaled references, each with explicit load timing ("Read `references/modes.md` before anything else"; "Load neither before review evidence is complete ... a non-interactive run never loads them at all"). All referenced files exist in the bundle (modes.md, document-intake.md, persona-selection.md, dispatch.md, cross-model-review.md, synthesis-and-presentation.md, walkthrough.md, bulk-preview.md, subagent-template.md, findings-schema.json, and eight files under personas/), and detail is appropriately split out of the overview. 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 clear, concise, third-person description with an explicit 'Use when' clause and natural trigger terms. Its main weakness is a thin 'what': the single verb "review" undersells the skill's actual behavior (persona dispatch, verified findings, applied corrections), and the when-clause is somewhat narrow.

Suggestions

Add one or two more concrete actions to the 'what' clause, e.g., "...with role-specific lenses: dispatch reviewer personas, verify findings against the document, and apply authorized corrections."

Broaden the when-clause with natural variations users would say, e.g., "Use when the user wants to review, critique, or improve an existing requirements doc, plan, or spec."

DimensionReasoningScore

Specificity

"Review requirements, plans, or specs with role-specific lenses" names the domain and one concrete action (review) plus a modifier, but does not enumerate what the review actually does (e.g., dispatch personas, verify findings, apply fixes). Matches anchor 3 — domain plus 1-2 concrete actions, not comprehensive — and not anchor 4, which expects several specific listed actions.

3 / 5

Completeness

Both parts are explicit: what ("Review requirements, plans, or specs with role-specific lenses") and when ("Use when the user wants to improve an existing planning document"). Not 5 because the when-clause covers a single narrow intent — a user asking to "review" or "check" a document without saying "improve" may not match.

4 / 5

Trigger Term Quality

Natural terms a user would say are present: "requirements", "plans", "specs", "improve", "planning document", "review". Not anchor 5 because common variations like "design doc", "PRD", "critique my plan", or "feedback on this spec" are missing.

4 / 5

Distinctiveness Conflict Risk

The planning-document review niche (requirements/plans/specs with role-specific lenses) is fairly distinct, but "review" as a trigger overlaps with code-review and PR-review skills. Mostly distinct with minor overlap risk against closely related review skills — anchor 4.

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
crdant/compound-engineering-plugin
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.