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.

Quality

84%

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

88%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 process-orchestration skill: strictly sequenced phases, copy-paste-ready sub-agent prompts, explicit validation and recovery loops for batch operations, and conditional offloading of fallback details to a real, well-structured reference file. The only notable improvements are trimming the design-language duplication with the template asset and slimming the inline HTML spec.

DimensionReasoningScore

Conciseness

The body is dense and instructional with no explanations of concepts Claude already knows, but minor trims are possible: the Design Language section restates palette/typography/layout already available in assets/report-template.html, and a few meta-commentary lines ("This is the most time-intensive phase") add little.

4 / 5

Actionability

Copy-paste-ready extraction and reduction prompts, exact commands (plannotator data-dir, platform-specific stat invocations), exact output paths (/tmp/compound-planning/extraction-{batch-name}.md), versioned filenames, dataset-size batching thresholds, and a fully specified hook file path and format cover the common cases concretely.

5 / 5

Workflow Clarity

Phases 0-6 are strictly sequenced with explicit validation and feedback loops for the batch extraction: "Verify the total matches the inventory from Phase 1. If any agent's count is short, flag it and consider re-launching", timeout re-launch instructions, user confirmation gates for incremental vs. full runs, and a Key Rules checklist for the report.

5 / 5

Progressive Disclosure

Fallback-mode details are properly offloaded to a clearly signaled, conditionally-read reference (references/claude-code-fallback.md), the parser script and design template are split out at point of use, and references are one level deep — but the ~590-line body inlines a large HTML design specification that stricter organization could partially move to the assets layer.

4 / 5

Total

18

/

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 specific, distinctive description that clearly communicates a multi-step analysis-and-reporting capability with a documented fallback path. Its main weakness is the absence of any "when to use this" trigger clause and the limited set of natural keyword synonyms.

Suggestions

Add an explicit trigger clause such as "Use when the user wants to analyze their denied/rejected plans or planning feedback history" to raise completeness.

Include common synonyms users would naturally say — "rejected plans", "plan feedback", "planning review history" — alongside "denial patterns".

If the skill is intended for model invocation (disable-model-invocation is currently true), the missing trigger guidance matters even more; consider enabling it or making the slash-command usage explicit.

DimensionReasoningScore

Specificity

The description lists multiple concrete actions — "extract denial patterns, feedback taxonomy, evolution over time, and actionable prompt improvements" and "produce a polished HTML dashboard report" — plus an explicit fallback behavior, giving comprehensive coverage of the skill's capabilities.

5 / 5

Completeness

The "what" is clearly stated (analyze the archive, extract patterns, produce an HTML dashboard), but there is no "Use when..." clause or equivalent explicit trigger guidance, which caps completeness at 3 per the rubric guidelines.

3 / 5

Trigger Term Quality

Natural niche terms like "Plannotator plan archive", "denial patterns", "feedback taxonomy", and "ExitPlanMode denial reasons" are present, but common variations a user might actually say ("rejected plans", "plan feedback", "planning history") are missing.

4 / 5

Distinctiveness Conflict Risk

"Plannotator plan archive" and "Claude Code ExitPlanMode denial reasons" carve out a clear niche with distinct triggers and minimal risk of firing for the wrong skill.

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