CtrlK
BlogDocsLog inGet started
Tessl Logo

planner-task-packet

Draft CCB workflow task packets, readiness recommendations, and candidate clarification questions without mutating authoritative state.

57

Quality

65%

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 ./docs/plantree/plans/agentic-loop-workflow/drafts/agentroles.ccb_planner/skills/planner-task-packet/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

71%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 highly actionable, with exact templates, executable verification commands, explicit fail-closed validation, and unambiguous routing rules — a genuinely operational instruction skill. Its weaknesses are repetition of the same prohibitions across sections and a monolithic single-file structure where rule sets like the bounded post-detail contract could be split into reference files.

Suggestions

Consolidate the repeated route rules ("do not authorize implementation paths", allowed_paths/verification requirements) into one route-to-readiness table instead of restating them in three paragraphs.

Move the bounded post-detail stop contract and the git-capability verification rules into one-level-deep reference files (e.g., references/post-detail-stop.md, references/verification.md) and link them from SKILL.md.

Rewrite the stable-interface paragraph as a short checklist of the exact conditions that create a predecessor-output constraint — it currently makes one point four different ways.

DimensionReasoningScore

Conciseness

The body is dense with genuinely novel system rules (no explaining of concepts Claude already knows), but it could be tightened: "Do not authorize implementation paths" is repeated across three route paragraphs, the needs_detail rule is stated both in the bounded-stop section and again in "ordinary rule remains in force", and several long prose sentences (e.g., the stable-interface paragraph) restate the same constraint multiple ways. This fits anchor 3 (mostly efficient, some unnecessary repetition) better than 4's "minor instances that could be trimmed".

3 / 5

Actionability

The skill provides copy-paste-ready templates for every output shape — exact fenced task-packet and readiness.json blocks, a complete task-set.json example, an exact bounded post-detail readiness JSON shape, and a concrete executable verification command ("python -m unittest discover -s tests -p test_example.py") with the anti-pattern to avoid. Guidance is fully executable and covers the common cases (single-slice, task-set, each route, git vs non-git capability).

5 / 5

Workflow Clarity

Routing decisions are explicit and each route maps to an exact readiness value with required fields, and the bounded post-detail stop includes a real validation checkpoint with fail-closed error handling ("If any required constraint field is absent, stale, malformed, or conflicts... fail closed"). However, the decision flow is scattered across interleaved sections rather than presented as one ordered sequence, and the interaction between the bounded-stop exception and the ordinary needs_detail rule requires re-reading to sequence correctly — minor gaps that keep it below anchor 5.

4 / 5

Progressive Disclosure

The bundle contains no references/, scripts/, or assets/ directories, so all ~210 lines live inline in SKILL.md. Section headers are clear, but the bounded post-detail stop contract, the git-capability verification rules, and the stable-interface/decomposition guidance are each self-contained rule sets that could live in one-level-deep reference files, pulling them out of the always-loaded context. This matches anchor 3 (some structure, content that could be separate is inline) rather than 4's well-split organization.

3 / 5

Total

15

/

20

Passed

Description

58%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 states a clear, specific set of actions with a useful non-mutation boundary, but it omits any "when to use this" trigger guidance and leans on internal jargon ("CCB workflow") that a user would not naturally say. Adding an explicit trigger clause with natural-language phrasing would raise both completeness and trigger-term quality.

Suggestions

Append a trigger clause such as: "Use when asked to plan, decompose, or scope a CCB task, draft a task packet or readiness recommendation, or generate clarification questions before implementation."

Replace or gloss the jargon "CCB workflow" with user-facing vocabulary (e.g., "planning workflow") so natural keyword matching works.

Name the concrete deliverables users would recognize (task-packet.md, readiness.json) to improve trigger-term coverage and distinctiveness.

DimensionReasoningScore

Specificity

The description lists several concrete actions — "Draft CCB workflow task packets, readiness recommendations, and candidate clarification questions without mutating authoritative state" — which is specific, but coverage is partial: "CCB workflow" is unexplained domain jargon and no output formats or trigger scenarios are named. This matches anchor 4 (several specific actions, minor gaps) rather than 5, whose examples show more comprehensive coverage, and clearly exceeds anchor 3's 1-2 concrete actions.

4 / 5

Completeness

The "what" is clearly stated (draft task packets, readiness recommendations, clarification questions) but there is no "Use when..." clause or equivalent trigger guidance, which the guidelines cap at 3. Anchor 4 explicitly requires both what and when; this description has no when at all.

3 / 5

Trigger Term Quality

Terms like "task packets", "readiness recommendations", and "clarification questions" are relevant keywords, but the natural phrases a user would actually say (e.g., "plan a task", "write a task packet", "is this ready") and common synonyms are missing, and "CCB workflow" is internal jargon rather than user vocabulary. This fits anchor 3 (some relevant keywords, missing variations/synonyms), not 4's good natural-term coverage.

3 / 5

Distinctiveness Conflict Risk

The niche is narrow and the guardrail "without mutating authoritative state" distinguishes it from execution-oriented skills, so wrong-skill triggering is unlikely. However, terms like "task packets" and "readiness" could overlap with adjacent planning/scoping skills, keeping it at anchor 4 (mostly distinct, minor overlap risk) rather than 5.

4 / 5

Total

14

/

20

Passed

Validation

100%

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

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
SeemSeam/claude_codex_bridge
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.