CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

plan-review

Use when asked to review, audit or quality-check a plan in .context/plans/. Runs 3 independent subagent reviewers (Technical, Strategic, Risk) on the same plan brief and consolidates their findings. Reads reviewer models from .claude/plan-review.json when present, otherwise asks the user first. Not for plans outside .context/plans/, one-off notes, or external documents.

Quality

87%

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.

Excellent actionability, workflow sequencing, and bundle structure: exact commands, validation scripts, a verification checklist, and clean one-level-deep references. The main weakness is token efficiency — the model-diversity rationale and a few decision rules are repeated across Mindset, steps, and Anti-Patterns, and one stale cross-reference ("Take the plan's SHA-256 in step 2" — step 2 never mentions SHA-256) could confuse execution.

Suggestions

State the model-diversity rationale once (Mindset or the Anti-Patterns section) and reference it elsewhere instead of repeating it nearly verbatim three times.

Fix the stale cross-reference in Step 8 ("Take the plan's SHA-256 in step 2") by either adding the SHA-256 instruction to Step 2 or pointing at references/saving-the-report.md where the command lives.

Tighten or consolidate the sample 'Structural Issues' report blocks in Step 3, which duplicate detail already covered in references/structural-inference.md.

DimensionReasoningScore

Conciseness

Mostly dense, actionable instruction Claude could not infer, but the model-diversity rationale is repeated nearly verbatim three times ("Model diversity is the strongest/main lever" in Mindset, Step 5, and two Anti-Patterns), and the Mindset bullet about Editorial/Decision classification duplicates Step 10. Not 4 because the redundancy goes beyond minor trimmable instances; not 2 because there is no padding explaining concepts Claude already knows.

3 / 5

Actionability

Fully executable guidance throughout: exact commands ("sh <path>/validate-context-frontmatter.sh .context/plans/<plan-file>.md", "find -L <skills dir> -name validate-context-frontmatter.sh", "bash <this skill's directory>/scripts/validate-plan-review-config.sh <path>"), a reviewer/subagent-type/model table, and ready Agent-call prompt templates with a paste slot. As an instruction-only skill the guidance is copy-paste ready and covers the common cases.

5 / 5

Workflow Clarity

An 11-step sequence with explicit validation checkpoints (frontmatter validation script, schema validation of the report, a 6-item Verification checklist) and error-recovery feedback loops ("Re-spawn that reviewer individually... if a reviewer fails twice, fall back to the other two"). Matches the level-5 anchor: clear sequence, explicit validation, feedback loops, and a checklist.

5 / 5

Progressive Disclosure

The body is an overview/workflow that delegates detail to one-level-deep, well-signaled references (model-routing.md, structural-inference.md, reviewer-prompts.md, saving-the-report.md) with a References table giving 'When to Use' per entry, plus templates/schemas/scripts that all exist in the bundle. References do not chain into further instructional docs. This matches the clear-overview, well-split level-5 anchor.

5 / 5

Total

18

/

20

Passed

Description

87%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 strong description: third-person, concrete about the mechanism (3 named reviewer lenses, config file, consolidation), with an explicit 'Use when' trigger and a negative boundary for scope. Trigger-term coverage is good though a few natural synonyms are absent.

DimensionReasoningScore

Specificity

"Runs 3 independent subagent reviewers (Technical, Strategic, Risk) on the same plan brief and consolidates their findings" and "Reads reviewer models from .claude/plan-review.json" list several concrete actions in third-person voice. Not 5 because coverage has minor gaps (structural validation and report generation are part of the skill but unmentioned); clearly above 3, which expects only 1-2 concrete actions.

4 / 5

Completeness

Explicitly answers both: what ("Runs 3 independent subagent reviewers... consolidates their findings") and when ("Use when asked to review, audit or quality-check a plan in .context/plans/") with concrete trigger phrases, matching the level-5 anchor. A level-4 score would require the 'when' to be less explicit, which it is not.

5 / 5

Trigger Term Quality

"review, audit or quality-check a plan" plus the concrete location trigger ".context/plans/" give good natural keyword coverage. Not 5 because a few natural variants users might say (e.g. "validate a plan", "get a second opinion on a plan", "critique") are missing; above 3 since multiple relevant natural phrases are present.

4 / 5

Distinctiveness Conflict Risk

A clear niche (multi-reviewer audits of ".context/plans/" files) with distinct triggers and an explicit exclusion clause ("Not for plans outside .context/plans/, one-off notes, or external documents") minimizing conflict risk. Not 4 or below, since the negative boundary removes overlap with adjacent review/reflection skills.

5 / 5

Total

18

/

20

Passed

Validation

87%

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

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

relative_links

Relative link issues: 8 deeper-than-1-level

Warning

referenced_paths_exist

Referenced path issues: 18 deeper-than-1-level

Warning

Total

14

/

16

Passed

Repository

pantheon-org/tekhne

Path

skills/project-mgmt/plan-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.