CtrlK
BlogDocsLog inGet started
Tessl Logo

clarity

Establish clarity before starting work. Use when beginning any significant task, when input is vague or stream-of-consciousness, or when requirements seem unclear. Handles messy voice input efficiently. This is the first system in the 5-system framework.

86

1.26x
Quality

Does it follow best practices?

Impact

85%

1.26x

Average score across 6 eval scenarios

SecuritybySnyk

Passed

No known issues

SKILL.md
Quality
Evals
Security

Quality

Content

85%

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

The body is a well-organized, actionable clarification protocol with copy-paste templates, a worked example, and clear sequenced workflows with confirm checkpoints. Its only weakness is mild redundancy between the Efficiency Rules and the protocol steps and repeated section headers that could be tightened.

Suggestions

Collapse the 'Efficiency Rules' section into the Messy Input Protocol steps (or remove it) since it restates the same clear/slightly-unclear/very-unclear decision logic already implied by the process.

Replace the repeated 'Ask and document:' line under each Full Clarity step with a single lead-in so each step opens directly with its bulleted questions, trimming redundant tokens.

DimensionReasoningScore

Conciseness

The body is mostly efficient with concrete templates and a worked example, but the 'Efficiency Rules' section restates the Messy Input Protocol and each Full Clarity step repeats an 'Ask and document:' header, adding redundancy that could be tightened. It is not a 3 because of this repetition, and not a 1 because it does not pad with concepts Claude already knows.

2 / 3

Actionability

It provides a copy-paste ready active-context.md template, a concrete WHAT/WHY/SCOPE extraction format, and a full worked dialogue example demonstrating exactly what to do. Per the rubric's instruction-skill note, absence of code is not penalized when guidance is this concrete and specific; it is not a 2 because the guidance is complete and actionable rather than pseudocode or vague direction.

3 / 3

Workflow Clarity

The Messy Input Protocol is a numbered 1-5 sequence with an explicit confirm checkpoint ('Is that right?') and a feedback loop (if gaps exist, ask 1-2 questions, then execute), and the Full Clarity Protocol is a clear 4-step checklist. This matches the top anchor; it is not capped at 2 because the workflow is conversational clarification, not a destructive or batch operation requiring a verify-fix-retry loop.

3 / 3

Progressive Disclosure

There are no bundle files, so the single SKILL.md is scored on its own organization: it has a clear purpose/when header, well-labeled sections (Messy Input Protocol, Full Clarity Protocol, Output Requirements, Rules, Transition), and easy navigation with no nested references. It is not a 2 because the content is cleanly sectioned and self-contained rather than a monolithic wall or poorly-signaled inline material.

3 / 3

Total

11

/

12

Passed

Description

82%

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 has an explicit 'Use when' trigger clause with natural, well-covered terms and answers both what and when, scoring well on completeness and trigger quality. It is held back by a somewhat abstract capability list and an overly broad 'beginning any significant task' trigger that risks overlapping with other skills.

Suggestions

Add one or two more concrete capabilities (e.g., 'extracts the core intent of a request and confirms scope before executing') to lift specificity from a domain-naming description to a concrete-action list.

Tighten the broad 'beginning any significant task' trigger or scope it to clarification-specific situations (e.g., 'when a request is ambiguous, rambling, or lacks clear success criteria') to reduce conflict with other skills.

DimensionReasoningScore

Specificity

It names the domain and a couple of actions ('Establish clarity before starting work', 'Handles messy voice input efficiently') but does not list a comprehensive set of concrete actions, matching the 'names domain and some actions, but not comprehensive' anchor. It is not a 3 because there is no enumerated list of specific capabilities, and not a 1 because it does name concrete-ish actions rather than being purely abstract.

2 / 3

Completeness

It explicitly answers what it does ('Establish clarity before starting work', 'Handles messy voice input efficiently') and when to use it via an explicit 'Use when ...' clause with concrete triggers. This matches the top anchor for both what AND when with explicit triggers; it is not a 2 because the when is explicit rather than merely implied.

3 / 3

Trigger Term Quality

The 'Use when ... input is vague or stream-of-consciousness, or when requirements seem unclear' clause gives good coverage of natural terms a user would experience (vague, stream-of-consciousness, unclear requirements, messy voice input). It is not a 2 because it supplies multiple common natural phrasings rather than a single keyword, and not below 3 since these are terms users actually say.

3 / 3

Distinctiveness Conflict Risk

The messy/vague-input and stream-of-consciousness triggers carve a niche, but 'beginning any significant task' is very broad and would overlap with many skills that also trigger at the start of work. This fits 'somewhat specific but could still overlap'; it is not a 3 because of that broad trigger, and not a 1 because the messy-input angle is genuinely distinctive.

2 / 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
majiayu000/claude-skill-registry
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.