CtrlK
BlogDocsLog inGet started
Tessl Logo

clear-cove-task-design

Use when orchestration or planning agents are producing task plans, task prompts, or TASK.md instructions that must be unambiguous, verifiable, and resistant to hallucination. Applies CLEAR (Concise, Logical, Explicit, Adaptive, Reflective) to structure and write agent task files, then adds CoVe (Chain of Verification) checks where accuracy risk is meaningful. Activates on draft task prompts, swarm plans, migration tasks, and multi-step plans requiring independently executable steps.

84

Quality

81%

Does it follow best practices?

Impact

Pending

No eval scenarios have been run

SecuritybySnyk

Passed

No known issues

SKILL.md
Quality
Evals
Security

Quality

Discovery

85%

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

This is a well-structured description that clearly defines both what the skill does and when to use it, with explicit trigger conditions and a distinct niche. Its main weakness is the heavy reliance on specialized terminology (CLEAR, CoVe, orchestration agents) that may not match how users naturally phrase requests, potentially reducing discoverability. The description is thorough but could benefit from including more natural-language trigger terms alongside the technical ones.

Suggestions

Add more natural-language trigger terms that users might actually say, such as 'write agent instructions', 'create a task plan', or 'break down work into steps for agents' alongside the technical terminology.

DimensionReasoningScore

Specificity

Lists multiple specific concrete actions: structuring/writing agent task files using CLEAR methodology, adding CoVe checks, and specifies the types of artifacts it works on (task plans, task prompts, TASK.md instructions, swarm plans, migration tasks, multi-step plans).

3 / 3

Completeness

Clearly answers both 'what' (applies CLEAR framework to structure task files, adds CoVe checks for accuracy) and 'when' (explicitly states 'Use when orchestration or planning agents are producing task plans...' and 'Activates on draft task prompts, swarm plans, migration tasks...').

3 / 3

Trigger Term Quality

Includes some relevant terms like 'task prompts', 'TASK.md', 'swarm plans', 'migration tasks', 'multi-step plans', but relies heavily on specialized jargon (CLEAR, CoVe, orchestration agents) that users may not naturally use. Missing simpler trigger terms a user might say like 'write instructions for an agent' or 'plan tasks'.

2 / 3

Distinctiveness Conflict Risk

Highly distinctive niche combining CLEAR methodology and CoVe verification specifically for agent task file authoring. The specific frameworks (CLEAR, CoVe) and the focus on agent-to-agent task instructions make it very unlikely to conflict with other skills.

3 / 3

Total

11

/

12

Passed

Implementation

77%

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

This is a strong, highly actionable skill that provides a complete framework for writing agent task prompts with clear workflows, validation checkpoints, and a ready-to-use template. Its main weakness is moderate verbosity — some sections could be tightened, and the monolithic structure would benefit from splitting specialized guidance (migration tasks, swarm planning) into referenced files. The migration section with its four mandatory criteria and scorer behavior is particularly well-designed.

Suggestions

Extract the 'Migration and Data Conversion Tasks' and 'Special Guidance for Swarm Planning Agents' sections into separate referenced files (e.g., MIGRATION.md, SWARM_PLANNING.md) to improve progressive disclosure and reduce the main file's token footprint.

Tighten the CLEAR Guidelines section by removing explanations Claude already knows (e.g., 'remove filler and meta commentary' is self-evident) and consolidating overlapping guidance between the linting rules and the CLEAR section.

DimensionReasoningScore

Conciseness

The skill is mostly efficient and well-structured, but contains some redundancy (e.g., success criteria at the end largely restates what's already covered in the template and linting rules) and some sections explain concepts Claude already understands (like what CoVe stands for conceptually). The CLEAR acronym expansion is useful but some elaboration is unnecessary for an LLM audience.

2 / 3

Actionability

The skill provides a complete, copy-paste-ready task prompt template in markdown, concrete linting rules to apply before finalizing, specific verification commands and assertion examples (especially in the migration section), and a clear output protocol (score → revise → label changes). The guidance is fully executable.

3 / 3

Workflow Clarity

The workflow is clearly sequenced: (1) apply CLEAR to structure, (2) add CoVe where justified, (3) control verbosity. The linting rules serve as an explicit validation checkpoint before finalization. The migration section adds mandatory gates including a deletion gate that prevents destructive action without confirmation. The 'Your Output Responsibilities' section provides a clear feedback loop (score → revise → label).

3 / 3

Progressive Disclosure

The content is well-organized with clear headers and logical section progression, but it is a monolithic document (~200+ lines) with no references to external files. The migration-specific guidance and swarm planning guidance could be split into separate reference files. For a skill of this complexity, inline presentation of all content is borderline appropriate but would benefit from modularization.

2 / 3

Total

10

/

12

Passed

Validation

90%

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

Validation10 / 11 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

10

/

11

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.