CtrlK
BlogDocsLog inGet started
Tessl Logo

spec-loop-plan-task

Choose the planning form for new work and plan it before execution. Use this skill to decide whether the work is taskless, chat-only, a task file, a task file with subtasks, or multiple task files / backlog items, and to create the needed plan for non-trivial implementation work or investigation work that needs its own task.

62

Quality

73%

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 ./skills/spec-loop-plan-task/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

62%

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

A well-structured policy skill with clear sequencing, explicit gates, and feedback loops, but it is somewhat verbose and delegates its core procedures to guidance files that are missing from the bundle, weakening both actionability and progressive disclosure.

Suggestions

Include the referenced guidance files (planning-form-selection-guidance.md, common-task-guidance.md, chat-only-path-guidance.md, task-file-path-guidance.md, scenario-and-glossary-guidance.md) in the bundle, or inline their essential steps so the skill is self-contained.

Tighten the 'Glossary policy' section and de-duplicate repeated sibling-skill links to reduce token cost.

Add a short numbered overview of the end-to-end flow (classify → select form → clarify → plan → approve → execute) near the top so the sequence is visible at a glance.

DimensionReasoningScore

Conciseness

The body is dense, rule-oriented, and avoids explaining concepts Claude already knows, but it is not lean: sections like 'Glossary policy' restate conditional caveats, links to sibling skills are repeated across sections, and several passages could be tightened. This fits the level-2 anchor of mostly efficient with some unnecessary explanation or room to tighten.

2 / 3

Actionability

Concrete directives are present ('Work starts in PLAN', 'create or update the active task file before EXECUTION starts', 'use tasks/ as the default task directory') and classification criteria are specific, but the actual procedures are delegated to five local guidance files (e.g. 'read [planning-form-selection-guidance.md] fully') that are absent from the bundle, leaving the body's own guidance incomplete — matching the level-2 anchor of concrete but incomplete guidance.

2 / 3

Workflow Clarity

The flow is sequenced (classify → select planning form → clarification gate → planning content → execution approval → route to implementation/investigation) with explicit checkpoints and feedback loops: the clarification gate, the 'Starting EXECUTION requires explicit user approval' gate, and error routing ('If clarification returns an unresolved blocker... route that work'; 'If drafting later exposes an important open decision, stop and clarify'). This matches the level-3 anchor of clear sequence with explicit validation steps and error-recovery loops.

3 / 3

Progressive Disclosure

References are well-signaled and one level deep ('read [common-task-guidance.md] fully', sibling SKILL.md links), and content is appropriately split into clear sections rather than a monolith. However, scored against the actual bundle, none of the bundle directories exist and the five referenced local guidance .md files are missing, so the disclosure path is broken — fitting the level-2 anchor of structure present but navigation not actually functional.

2 / 3

Total

9

/

12

Passed

Description

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.

A strong description: concrete actions, an explicit 'Use this skill' trigger, and a distinct niche. Its main weakness is trigger-term quality, since much of the vocabulary is internal taxonomy rather than phrasing users naturally say.

Suggestions

Add user-natural trigger phrasing such as 'Use when the user asks to plan new work, break work into tasks, or decide how to track a piece of work' alongside the internal taxonomy.

Consider trimming the full taskless/chat-only/task-file/subtask enumeration in the description so the opening sentence stays scannable.

DimensionReasoningScore

Specificity

Lists multiple concrete actions — 'Choose the planning form', 'plan it before execution', 'decide whether the work is taskless, chat-only, a task file... or multiple task files / backlog items', and 'create the needed plan' — matching the level-3 anchor of several specific concrete actions. Imperative voice ('Choose', 'Use this skill to') mirrors the rubric's own good examples, so no voice penalty applies.

3 / 3

Completeness

It states what the skill does ('Choose the planning form... and create the needed plan') and gives an explicit trigger ('Use this skill to decide whether...'), satisfying both the 'what' and 'when' requirements of the level-3 anchor with an explicit 'Use this skill' clause.

3 / 3

Trigger Term Quality

It includes some natural terms a user might say ('plan', 'task', 'backlog', 'investigation work'), but the bulk of the trigger vocabulary is internal Spec Loop taxonomy ('taskless', 'chat-only', 'a task file with subtasks') that a user would rarely utter verbatim, fitting the level-2 anchor of relevant keywords missing common variations.

2 / 3

Distinctiveness Conflict Risk

The Spec Loop planning-form niche with its specific taxonomy (taskless / chat-only / task-file / backlog) is a clear, narrow domain unlikely to fire for unrelated skills, matching the level-3 anchor of a clear niche with distinct triggers.

3 / 3

Total

11

/

12

Passed

Validation

93%

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

Validation15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

relative_links

Relative link issues: 7 missing, 8 suspicious

Warning

Total

15

/

16

Passed

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.