CtrlK
BlogDocsLog inGet started
Tessl Logo

clarification-broker

Compress planner candidate questions into a compact frontdesk-facing clarification batch and normalize answers back to planner.

60

Quality

70%

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_clarification_broker/skills/clarification-broker/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

72%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

The body is concise and well-organized for a simple skill, but its rules stay at a directional level without concrete examples or explicit validation checkpoints for the staged clarification handoff.

Suggestions

Add a short concrete example showing one consolidated question batch and the corresponding normalized answer mapping so the rules become actionable.

Include an explicit validation step in the workflow, e.g. confirm no duplicate or already-answerable questions remain before emitting the batch to frontdesk.

DimensionReasoningScore

Conciseness

The body is a lean set of short bulleted lists (Inputs, Outputs, Rules) with no padding or explanation of concepts Claude already knows, matching the score-3 anchor of lean and efficient where every token earns its place.

3 / 3

Actionability

Rules such as 'Prefer one stage-batched question set' and 'Defer later-phase questions' are directional but lack concrete examples of what a batch or a deferred question looks like; this matches the score-2 anchor of some concrete guidance but incomplete, not the fully actionable anchor at 3.

2 / 3

Workflow Clarity

Inputs/Outputs/Rules imply a flow but no explicit sequence or validation checkpoint is given for the staged handoff; this sits at the score-2 anchor of steps present but checkpoints missing, below the score-3 validated-workflow anchor.

2 / 3

Progressive Disclosure

This is a sub-50-line single-task skill with no need for external references, and its content is organized into clear Inputs/Outputs/Rules sections, so it qualifies for the score-3 simple-skills allowance on organization alone.

3 / 3

Total

10

/

12

Passed

Description

67%

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 concrete actions and occupies a distinct niche, but it lacks an explicit 'Use when...' trigger clause and its keywords are internal jargon rather than natural user phrasing.

Suggestions

Add an explicit 'Use when...' clause stating when Claude should invoke this skill (e.g., 'Use when the planner emits candidate questions that need consolidation before asking the user').

Replace or supplement internal jargon like 'frontdesk-facing clarification batch' with natural terms a user might say, such as 'clarifying questions', 'ask the user', or 'batch questions'.

DimensionReasoningScore

Specificity

Quotes 'Compress planner candidate questions into a compact frontdesk-facing clarification batch and normalize answers back to planner' list multiple concrete actions (compress/batch questions, normalize answers back), matching the score-3 anchor of multiple specific concrete actions rather than the single-domain anchor at 2.

3 / 3

Completeness

It clearly states what the skill does but offers no 'Use when...' clause or equivalent trigger guidance; per the rubric, a missing explicit trigger caps completeness at 2 even though the 'what' is strong.

2 / 3

Trigger Term Quality

Terms like 'planner candidate questions', 'frontdesk-facing clarification batch', and 'normalize answers' are domain jargon a user would not naturally say; this matches the score-2 anchor of some relevant keywords but missing common variations, not the natural-language coverage expected at 3.

2 / 3

Distinctiveness Conflict Risk

The broker niche between planner and frontdesk clarification is a clear, narrow role with distinct triggers unlikely to overlap with unrelated skills; it is above the score-2 'could still overlap' anchor.

3 / 3

Total

10

/

12

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.

Validation16 / 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.