CtrlK
BlogDocsLog inGet started
Tessl Logo

planner-rt-ica

Same reverse-thinking method as dh:rt-ica (see dh:rt-ica or dh-glossary for the definition), but localizes any MISSING input to the affected task only, as a non-blocking information-completeness pre-pass before task decomposition and plan generation. Use when grooming backlog items, generating plans, decomposing tasks under uncertainty, or working in brownfield and refactor scenarios. Produces completeness summary (APPROVED-FOR-PLANNING, APPROVED-WITH-GAPS, or BLOCKED-FOR-PLANNING), missing input report with dependency mapping, required unblock actions, and planning annotations for downstream tasks. Use dh:rt-ica instead at the S2 implementation gate where missing inputs must halt execution.

64

Quality

78%

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 ./plugins/development-harness/skills/planner-rt-ica/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

63%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-structured, highly actionable policy skill with an exact output contract and good validation checkpoints, but at 415 lines it carries real redundancy and inlines several long rule catalogs that belong in reference files. Tightening the duplicated material and splitting the gate/escalation catalogs out would raise both token efficiency and navigation.

Suggestions

Deduplicate the report-back material: keep the issue-category taxonomy in one place (e.g. the Output Contract 3A section) and have the policy section reference it, rather than restating the full list twice.

Consolidate the Safe Default Gate's 16 overlapping criteria into roughly 8 distinct checks (merging e.g. bounded-blast-radius/scope/reversibility repeats) and move the merged gate plus the 12 ambiguity rules into reference files linked from SKILL.md.

Add one worked example of a completed planner-rt-ica analysis (one APPROVED-WITH-GAPS run showing the Decision line, missing-inputs section, batched clarification packet, and <concerns> block) so a producer can pattern-match the exact output shape.

DimensionReasoningScore

Conciseness

Most of the body is project-specific policy rather than explanations of concepts Claude already knows, but there is substantial redundancy that could be tightened: the Safe Default Gate's 16 criteria overlap heavily (e.g. criteria 1/5/13/14 and 9/16 restate each other), the report-back taxonomy appears twice in near-full detail (the 'Report Back For Review' section and Output Contract 3A), and the reclassify-after-research rule is stated three times (Ambiguity Escalation, Behavioral Rules, and recursive question discovery). This fits 'mostly efficient but includes some unnecessary explanation or could be tightened' better than the verbose anchor below it.

3 / 5

Actionability

For an instruction-only skill the guidance is concrete: an exact output contract with named sections, a fixed three-token verdict vocabulary, a literal emission format ('Decision: APPROVED-WITH-GAPS') with explicit anti-patterns ('do not bold the field name... do not wrap it in brackets'), a ready-to-emit <concerns> XML template, and a fully-specified hard-block rule for data deletion. It stops short of a 5 because there is no worked end-to-end example of a completed analysis showing how the sections assemble in practice.

4 / 5

Workflow Clarity

The multi-step process is clearly sequenced — classify inputs, evaluate the Safe Default Gate, run recursive question discovery, batch ASK-USER items after discovery, emit the verdict — with an explicit 'Reflection checkpoint' before classification and reclassification rules after research, and validation is present for the destructive case (the data-deletion hard block, so the destructive-ops cap does not apply). It is not a 5 because the sequence is interleaved across duplicated sections (report-back policy vs. output contract, ambiguity rules vs. behavioral rules), which forces the reader to stitch the order together.

4 / 5

Progressive Disclosure

Sectioning and headers are good and there are no nested or buried references, but this is a 415-line single-file skill with no reference files at all — long, semi-independent policy blocks (the 16-criterion Safe Default Gate, the 12 ambiguity escalation rules, the 15 report-back categories) are fully inlined in SKILL.md when they would serve better as one-level-deep references. This sits between the anchor where 'content that should be separate is inline' and the minimal-structure anchor, but noticeably above the midpoint given the consistent header and table structure.

3 / 5

Total

14

/

20

Passed

Description

92%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: concrete actions, explicit trigger guidance, enumerated outputs, and explicit conflict disambiguation against the sister skill, all in third-person voice. The only weakness is trigger-term coverage, which is good but not exhaustive of natural synonyms.

DimensionReasoningScore

Specificity

The description lists multiple concrete actions — 'localizes any MISSING input to the affected task only, as a non-blocking information-completeness pre-pass before task decomposition and plan generation' plus a full inventory of outputs ('completeness summary (APPROVED-FOR-PLANNING, APPROVED-WITH-GAPS, or BLOCKED-FOR-PLANNING), missing input report with dependency mapping, required unblock actions, and planning annotations'). This matches the 'comprehensive coverage of specific concrete actions' anchor; nothing here is generic filler.

5 / 5

Completeness

It explicitly answers both questions: 'what' via the pre-pass role and enumerated outputs, and 'when' via the concrete 'Use when...' trigger clause — plus a counter-trigger ('Use dh:rt-ica instead at the S2 implementation gate where missing inputs must halt execution'). This matches the anchor requiring clear and explicit what AND when with concrete trigger phrases; it is not the score-4 case because the 'when' is specific, not weakly implied.

5 / 5

Trigger Term Quality

The 'Use when' clause carries natural phrases a planning-domain user would actually say: 'grooming backlog items, generating plans, decomposing tasks under uncertainty, or working in brownfield and refactor scenarios'. Good coverage, but it misses common synonyms and variations users might use (e.g. 'writing a plan', 'planning a feature', 'pre-implementation checklist'), so it is not comprehensive.

4 / 5

Distinctiveness Conflict Risk

The description carves out a clear niche (planning-phase, non-blocking) and explicitly disambiguates from its only realistic conflict — the sister skill dh:rt-ica — with a routing rule tied to a distinct trigger ('the S2 implementation gate where missing inputs must halt execution'). Minimal conflict risk; a reader knows exactly which skill fires in which phase.

5 / 5

Total

19

/

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
Jamie-BitFlight/claude_skills
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.