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

The content is a well-structured orchestration overview with clear phased workflow, explicit validation checkpoints, and excellent progressive disclosure via verified one-level references. It is only slightly held back by minor verbosity and a few abstract directives.

DimensionReasoningScore

Conciseness

The body is dense and information-rich, assumes Claude's competence without explaining basic concepts, but a few explanatory clauses (e.g. "An adequate document needs no changes", "A capacity rejection is backpressure, not reviewer failure") could be trimmed, fitting efficient anchor 4 rather than the every-token-earns-its-place anchor 5.

4 / 5

Actionability

It gives concrete, executable guidance — specific file paths to read, `git rev-parse --show-toplevel`, dispatch rules — but some directives remain abstract ("resolve them within the authority already given"), and most execution detail lives in referenced files, placing it at anchor 4 with minor gaps rather than fully copy-paste-ready anchor 5.

4 / 5

Workflow Clarity

The multi-phase process (Phases 1-5, interactive vs non-interactive) is clearly sequenced with explicit validation checkpoints ("Verify before any dispatch", readable-path check, docs_root validation, capacity-rejection retry), a "Done when" completion checklist, and feedback loops, matching anchor 5.

5 / 5

Progressive Disclosure

The body is a concise overview that points via clearly signaled one-level-deep references (modes.md, document-intake.md, persona-selection.md, dispatch.md, synthesis-and-presentation.md, etc.) to detail split into real, verified files under references/ and references/personas/, matching the well-signaled navigation of 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.

The description cleanly answers what the skill does and when to use it with mostly natural trigger terms and low conflict risk. Its main weakness is limited action specificity and a single-condition trigger rather than rich trigger phrases.

Suggestions

List the concrete review actions (e.g. find blocking defects, flag missing decisions, resolve authorized corrections) rather than only "Review ... with role-specific lenses" to lift specificity.

Broaden the "when" clause with synonyms users actually say, e.g. "Use when the user wants to improve, critique, or stress-test a plan, spec, or requirements document."

DimensionReasoningScore

Specificity

"Review requirements, plans, or specs with role-specific lenses" names the domain and one concrete action (reviewing via role-specific lenses), but offers only a single action rather than a comprehensive set, matching anchor 3 and falling below anchor 4's "several specific actions".

3 / 5

Completeness

It states both a clear "what" (review requirements/plans/specs with role-specific lenses) and an explicit "when" ("Use when the user wants to improve an existing planning document"), but the "when" is a single condition rather than the rich, multi-synonym trigger phrases of anchor 5.

4 / 5

Trigger Term Quality

Natural terms like "requirements", "plans", "specs", and "planning document" are terms users would say, giving good keyword coverage, though common synonyms (e.g. "critique", "spec review") are missing — anchor 4 rather than a comprehensive anchor 5.

4 / 5

Distinctiveness Conflict Risk

The role-specific-lens review of planning documents is a fairly distinct niche with only minor overlap risk against generic review skills, fitting anchor 4 rather than the fully-distinct anchor 5.

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.

Validation15 / 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
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.