CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

plannotator-compound

Analyze a user's Plannotator plan archive to extract denial patterns, feedback taxonomy, evolution over time, and actionable prompt improvements — then produce a polished HTML dashboard report. Falls back to Claude Code ExitPlanMode denial reasons when Plannotator data is unavailable.

64

Quality

81%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

High

Do not use without reviewing

SKILL.md
Quality
Evals
Security

Quality

Content

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

An exemplary orchestration skill body: concrete commands, complete agent prompts, size-adaptive batching, explicit validation loops, and a properly deferred fallback reference. Its weaknesses are moderate redundancy (integrity injunctions and design specs repeated inline) and a long inline HTML design spec that would fit better in its own reference file.

Suggestions

State the 'read every file, no skipping' rule once (e.g. in Important Notes) and delete the repetitions in the preamble and Phase 2.

Move the detailed HTML design specification (palette/typography/section-by-section layout) into a references/report-design.md and keep only the section order and key rules inline, letting assets/report-template.html carry the visual specifics.

Consolidate the per-phase 'Claude Code fallback mode' notes into the single fallback reference (e.g. one summary line per phase pointing there) to cut repeated boilerplate.

DimensionReasoningScore

Conciseness

Mostly efficient procedural writing, but with repeated content that could be tightened: the 'read every file / do not skip / research integrity' injunction appears in the preamble, Phase 2 ('Do not skip files', 'Do NOT skip any files'), and Important Notes; and the '### Design Language (from template)' section (~15 lines of palette/typography/layout prose) duplicates what the template file itself is read for ('Read the template ... for the design language only'). Not score 2 because there is no explanation of concepts Claude already knows and no padding for its own sake; not score 4 because these duplications are noticeable rather than minor.

3 / 5

Actionability

Fully executable guidance throughout: exact shell commands with platform variants ('stat -f %Sm -t %Y-%m-%d' / 'stat -c %y | cut -d' ' -f1'), exact output paths ('/tmp/compound-planning/extraction-{batch-name}.md'), copy-paste-ready extraction and reduction prompts, numeric batching thresholds (≤10 / 11-30 / 31-80 / 80+), and a concrete hook-file path with replace/merge/keep handling. Not score 4 because there are no material gaps in executability for an instruction-only skill.

5 / 5

Workflow Clarity

Phases 0-6 are clearly sequenced with an explicit gating rule ('Each phase must complete fully before the next begins'), and validation checkpoints with feedback loops are present for the batch operations: verify extraction counts against the Phase 1 inventory, re-launch timed-out agents for just the unprocessed files, warn and offer full-mode switch when fewer than 3 new denied files exist, and Key Rules requiring real data with no fabrication. Not score 4 because both the checkpoints and the error-recovery loops are explicit rather than implicit.

5 / 5

Progressive Disclosure

Good structure with well-signaled, verified, one-level-deep bundle references: [references/claude-code-fallback.md](references/claude-code-fallback.md) is correctly gated behind fallback mode, the parser script and 'assets/report-template.html' are linked with clear purpose statements. Not score 5 because ~130 lines of HTML design specification (palette, typography, per-section layout, adaptation rules) are inlined in SKILL.md — a natural candidate for a separate design reference — and the design-language prose partially duplicates the template file. Not score 3 because references are clearly signaled and the inline content is legitimately the core deliverable spec, not misfiled reference material.

4 / 5

Total

17

/

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 strong, concrete description that says exactly what the skill does and even how it degrades when the primary data source is missing. Its one real weakness is the complete absence of a 'when to use it' clause, which caps completeness and slightly weakens trigger coverage.

Suggestions

Add an explicit trigger clause, e.g. 'Use when the user asks to analyze their denied/rejected plans, plan feedback, or Plannotator archive, or wants a planning-improvement report.'

Include natural user phrasings and synonyms such as 'denied plans', 'rejected plans', and 'plan feedback' alongside 'denial patterns'.

Mention the deliverable trigger ('HTML report' / 'dashboard') in the when-clause so users asking for a report of their plan history match this skill.

DimensionReasoningScore

Specificity

The description lists multiple concrete actions — 'extract denial patterns, feedback taxonomy, evolution over time, and actionable prompt improvements', 'produce a polished HTML dashboard report', and a concrete fallback ('Falls back to Claude Code ExitPlanMode denial reasons'). Coverage of the skill's capabilities is comprehensive and nothing is vague fluff; it cannot be score 4 because there are no minor gaps in the action list.

5 / 5

Completeness

The 'what' is clearly and concretely answered, but there is no 'Use when...' clause or equivalent explicit trigger guidance anywhere in the description — per the judging guidelines this caps completeness at 3. Not score 2 because the 'what' is explicit and detailed rather than vague or absent.

3 / 5

Trigger Term Quality

Good keyword coverage with domain-natural terms like 'Plannotator plan archive', 'denial patterns', 'feedback taxonomy', and 'ExitPlanMode denial reasons'. It falls short of 5 because common user phrasings and synonyms are missing — e.g. 'denied plans', 'plan feedback', 'plan review analysis' — and no file-path or extension triggers are given.

4 / 5

Distinctiveness Conflict Risk

It occupies a clear niche — Plannotator plan-archive analysis with an explicitly stated Claude Code fallback — with distinct, product-specific trigger terms unlikely to collide with other skills. The fallback sentence also pre-empts overlap ambiguity with generic Claude Code log-analysis skills.

5 / 5

Total

17

/

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

skill_md_line_count

SKILL.md is long (576 lines); consider splitting into references/ and linking

Warning

Total

15

/

16

Passed

Repository

backnotprop/plannotator

Path

apps/skills/extra/plannotator-compound/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.