CtrlK
BlogDocsLog inGet started
Tessl Logo

spec-loop-plan-task

Choose the route for new work and plan it before implementation. Use this skill to decide whether the work is taskless, chat-only, or task-file, and to create the needed plan for non-trivial executable work.

48

Quality

51%

Does it follow best practices?

Impact

No eval scenarios have been run

SecuritybySnyk

Passed

No known issues

Optimize this skill with Tessl

npx tessl skill review --optimize ./skills/spec-loop-plan-task/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Discovery

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 adequately communicates both what the skill does and when to use it, with an explicit 'Use this skill' clause. However, it relies on internal jargon (taskless, chat-only, task-file) that may not match natural user language, and the concrete actions could be more specific. The planning/routing concept is moderately distinctive but could overlap with other planning-related skills.

Suggestions

Replace or supplement internal jargon ('taskless', 'chat-only', 'task-file') with natural language equivalents that a user might actually say, e.g., 'quick question', 'conversation', 'complex task requiring files'.

Add more specific concrete actions beyond 'decide the route' and 'create the plan', such as 'assess complexity, determine if task files are needed, outline implementation steps'.

DimensionReasoningScore

Specificity

The description names a domain (routing and planning new work) and some actions (decide the route, create a plan), but the actions are somewhat abstract. Terms like 'taskless', 'chat-only', 'task-file' hint at specific categories but aren't fully explained as concrete actions.

2 / 3

Completeness

The description clearly answers both 'what' (choose the route for new work and plan it) and 'when' ('Use this skill to decide whether the work is taskless, chat-only, or task-file, and to create the needed plan for non-trivial executable work'). The 'Use this skill' clause provides explicit trigger guidance.

3 / 3

Trigger Term Quality

It includes some relevant terms like 'plan', 'new work', 'implementation', and the routing categories ('taskless', 'chat-only', 'task-file'), but these are internal/technical jargon rather than natural terms a user would say. A user is more likely to say 'start a new task' or 'how should I approach this' than use these specific routing terms.

2 / 3

Distinctiveness Conflict Risk

The routing/planning concept is somewhat distinctive with its specific categories (taskless, chat-only, task-file), but 'plan' and 'new work' are broad terms that could overlap with project management or task creation skills. The internal terminology helps differentiate but the overall scope of 'planning before implementation' is fairly broad.

2 / 3

Total

9

/

12

Passed

Implementation

35%

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

This skill provides a comprehensive routing and planning framework with clear decision criteria and phase transitions, but suffers from significant verbosity and repetition. The same concepts (route selection, trivial vs non-trivial, taskless/chat-only/task-file) are restated across multiple sections, inflating token cost without adding clarity. The workflow logic is sound but would benefit from consolidation and a more streamlined presentation.

Suggestions

Consolidate route selection into a single decision table or flowchart-style list instead of repeating criteria across 'Core rules', 'Route selection', 'Planning routes', and individual route sections.

Remove redundant restatements — e.g., the taskless route section repeats the 'This looks trivial' prompt already stated in Core rules, and chat-only/task-file criteria overlap with the Planning routes section.

Move the glossary policy and ADR routing sections to a separate referenced file since they are secondary concerns that add ~40 lines of rarely-needed detail.

Add a concise decision flowchart at the top (e.g., 'New work → trivial? → ask user → taskless / non-trivial → chat-only criteria met? → chat-only / else → task-file') to replace the scattered prose descriptions.

DimensionReasoningScore

Conciseness

The skill is extremely verbose at ~200+ lines, with significant repetition (route selection criteria are stated multiple times, taskless/chat-only/task-file routes are described redundantly across sections). Many rules restate things Claude would naturally understand (e.g., explaining what phases mean, when to ask questions). The glossary policy section alone adds substantial weight for what could be 2-3 lines.

1 / 3

Actionability

The skill provides concrete decision criteria and specific prompts to use (e.g., exact phrases like 'This looks trivial. May I do this without a plan?'), which is good. However, there are no executable code examples, no concrete task file templates inline, and much of the guidance is procedural prose rather than copy-paste-ready artifacts. It relies heavily on external files for the actual actionable content.

2 / 3

Workflow Clarity

The phase model (PLAN → IMPLEMENTATION → DONE) is clearly defined with explicit transition rules and validation checkpoints (unresolved-questions scan, clarification before proceeding). However, the overall workflow is fragmented across many sections with overlapping concerns, making it hard to follow the actual sequence. The route selection decision tree would benefit from a clearer flowchart-style presentation rather than scattered bullet lists.

2 / 3

Progressive Disclosure

The skill references several external files (common-task-guidance.md, chat-only-path-guidance.md, task-file-path-guidance.md, etc.) which is good progressive disclosure structure. However, without bundle files provided, we can't verify these exist. The main file itself contains too much inline detail that could be pushed to referenced files, and some references are to sibling skill directories (../spec-loop-clarify-task/SKILL.md) creating a multi-level navigation pattern.

2 / 3

Total

7

/

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.

Validation11 / 11 Passed

Validation for skill structure

No warnings or errors.

Repository
dpolivaev/spec-loop
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.