CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

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.

Quality

79%

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

67%Weight 40%Scale 1-5

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

An instruction-only skill with actionable, rule-based guidance, explicit gating checkpoints, and a well-signaled reference structure. Its main weaknesses are repetition that inflates token cost without adding rules and long inline policy sections that belong in reference files.

Suggestions

Cite [spec-loop-write-adr/SKILL.md](../spec-loop-write-adr/SKILL.md) once in the ADR routing section and consolidate the Living Project Documents and Glossary policy into one shorter section or a reference file, removing the repeated ask-before-acting variations.

Replace the repeated "current task, or the current subtask plus any required shared context" phrasing with a single defined term (e.g., 'the current unit') introduced once and reused.

Add a short ordered overview of the full flow (classify → select form → clarify → plan current unit → approval → execution) near the top so the pipeline is scannable without assembling it from separate sections.

DimensionReasoningScore

Conciseness

The prose is dense rule statements with no padding about concepts Claude already knows, but there is noticeable tightening opportunity: "[spec-loop-write-adr/SKILL.md]" is cited four times in one section, the phrase "current task, or the current subtask plus any required shared context" recurs across sections, and the Living Project Documents / Glossary sections restate the same ask-before-acting rule in several variations. Not anchor 4 because the repetition goes beyond minor trimmable instances.

3 / 5

Actionability

Concrete, executable instruction-style guidance throughout: specific non-triviality tests ("spans multiple files and is not a straightforward mechanical edit", "changes public or shared APIs"), explicit defaults ("use `tasks/` as the default task directory"), specific file names ("glossary.adoc and glossary.md"), and unambiguous stop conditions ("If readiness or the referent is unclear, ask"). Minor gaps remain because task-format details are delegated to other files, so this is not anchor 5.

4 / 5

Workflow Clarity

A coherent pipeline is present (first classification → planning-form selection → clarification gate → current-first detailed planning → form-specific handling → execution approval) with explicit checkpoints ("Starting EXECUTION requires explicit user approval", "If drafting later exposes an important open decision, stop and clarify"). It falls short of anchor 5 because the sequence must be assembled across separate sections rather than being laid out as one ordered flow, and error-recovery guidance is scattered.

4 / 5

Progressive Disclosure

The body works as a router with clearly signaled, one-level-deep references ("read [planning-form-selection-guidance.md](planning-form-selection-guidance.md) fully", "follow it together with [common-task-guidance.md](common-task-guidance.md)"). Not anchor 5: the referenced local 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) are not present in the provided bundle to verify, and substantial policy detail (Living Project Documents, Glossary policy) is inlined in the router file.

4 / 5

Total

15

/

20

Passed

Description

83%Weight 40%Scale 1-5

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: it states concrete, enumerated capabilities and gives an explicit "Use this skill to..." trigger scoped to non-trivial implementation and investigation work. Its only weaknesses are a few missing natural synonyms and slight overlap risk with generic planning vocabulary.

DimensionReasoningScore

Specificity

Concrete actions are enumerated: "Choose the planning form for new work and plan it before execution", "decide whether the work is taskless, chat-only, a task file, a task file with subtasks, or multiple task files / backlog items", and "create the needed plan". It stops short of anchor 5 because coverage is limited to classification and plan creation with no hint of what the skill does downstream (e.g., approval gating or execution hand-off).

4 / 5

Completeness

It explicitly answers both questions: the what ("Choose the planning form for new work and plan it before execution") and the when ("Use this skill to decide whether the work is taskless, chat-only... for non-trivial implementation work or investigation work that needs its own task"), with concrete trigger conditions stated rather than merely implied.

5 / 5

Trigger Term Quality

Good natural keyword coverage: "plan", "planning", "task", "task file", "subtasks", "backlog items", "implementation work", "investigation work". A few common user phrasings are missing (e.g., "break down the work", "spec out", "organize this into tasks"), which keeps it below anchor 5.

4 / 5

Distinctiveness Conflict Risk

The enumerated planning forms ("taskless, chat-only, a task file, a task file with subtasks, or multiple task files / backlog items") form a distinct niche, but generic terms like "plan" and "task" carry minor overlap risk with general task-management or planning skills, so it is not anchor 5.

4 / 5

Total

17

/

20

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.

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

relative_links

Relative link issues: 8 missing, 10 suspicious

Warning

Total

15

/

16

Passed

Repository

dpolivaev/spec-loop

Path

skills/spec-loop-plan-task/SKILL.md

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.