CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

plan

Use ONLY when the user explicitly asks to plan a task, create a task file, produce a task breakdown in the accepted format, or prepare a critiqued strategy before coding. Writes under the `tasks` role. Not for design chat or ad-hoc code suggestions.

60

Quality

76%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

Fix and improve this skill with Tessl

tessl review fix ./plugins/flowai/skills/plan/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

66%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.

The body is exceptionally actionable and the workflow control flow (sequencing, stop points, critique loop, verification) is a model of explicitness, but it pays for that with severe verbosity — rules restated three or four times, embedded incident narratives, and rationale-asides — and zero progressive disclosure: a 40K monolith with no reference files where clearly separable material (question format, agent-dispatch protocol, SALP formats) is inlined.

Suggestions

Split the self-contained 'Question Format (FR-UNIVERSAL.QA-FORMAT)' section and the surface-scout/plan-critic dispatch protocol into reference files (e.g. references/question-format.md, references/agent-dispatch.md), leaving SKILL.md a lean overview with one-level-deep pointers — the body currently carries ~40K characters inline with no bundle files at all.

Deduplicate rules stated in multiple places: the frontmatter five-key/eliding-is-a-defect rule is repeated verbatim in rule 9, step 3, step 5a, and the Output Format section — state it once and reference it.

Move dated incident post-mortems ("observed 2026-09-06, plan-affected-surface-scout: ...", "2026-09-06: plan-recommends-root-over-symptom ...") out of the operative rules; they are history, not instruction, and per the rubric's time-sensitivity guideline belong in a separate defect-notes reference if kept at all.

DimensionReasoningScore

Conciseness

The ~40K-character body restates the same constraints in three or four places ("Eliding a key is a defect" appears in rule 9, step 3, step 5a, and the Output Format section) and pads rules with incident post-mortems ("observed 2026-09-06, `plan-affected-surface-scout`: the two scout rows for `documents/` and `.codex/` had no bullet...", "2026-09-06: `plan-recommends-root-over-symptom` offered three DB-side variants...") and multi-clause rationale asides ("a dispatch you launched and never collected has cost turns and bought nothing, and the pull to shrug and enumerate the tree yourself is strongest exactly there"). This matches anchor 2 ('noticeably verbose; several unnecessary explanations or padded sections') rather than anchor 1, since the verbosity is self-written process prose, not explanations of concepts Claude already knows.

2 / 5

Actionability

Guidance is fully concrete and copy-paste ready: a canonical frontmatter YAML block, exact SALP row format (`- [REF:fr:<id> | <FR-ID>] — <one-line summary> — <status>`), exact insert strings (`- **Tasks:** [REF:task:<YYYY>-<MM>-<slug> | <slug>]`), and runnable commands (`mkdir -p`, `date +%Y-%m-%d`, `ls .claude/agents/ .cursor/agents/ .opencode/agent/ "${CODEX_HOME:-$HOME/.codex}/agents/" 2>/dev/null`). Per the rubric's instruction-only note, the absence of program code isn't penalized because every instruction carries an exact format or command; this matches anchor 5 ('fully executable; copy-paste ready; specific examples cover the common cases').

5 / 5

Workflow Clarity

Steps 1–8 are explicitly sequenced with STOP points ("STOP and wait", "Never stop here with nothing written", "TOTAL STOP"), a built-in feedback loop (step 6 critique → step 7 triage/apply), validation checkpoints (5a acceptance-tuple check, completeness check, "Only ambiguity that blocks stating the Goal may halt you"), and a final verification checklist. Anchor 5 ('clear sequence with explicit validation steps; feedback loops for error recovery; checklists') is the best fit; the oddly ordered sub-steps (5a, 5c, 5b) is a cosmetic blemish, not a validation gap that would drop it to anchor 4.

5 / 5

Progressive Disclosure

There are no bundle files (references/, scripts/, assets/ are absent) and no references at all — the entire skill is one ~40K-character file. Large self-contained blocks that clearly belong in separate files are fully inlined: the ~2.5K-character "Question Format" section, the surface-scout dispatch protocol with host-specific variants (Codex spawn_agent/wait_agent instructions), and the SALP row/back-pointer format rules. This matches anchor 2 ('minimal structure; content that clearly belongs in separate files is inlined'); not anchor 1 because the body has clear internal section organization, and not anchor 3 because there are no references to signal and the inlined mass is very large.

2 / 5

Total

14

/

20

Passed

Description

78%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 trigger-focused description with explicit positive and negative activation conditions and natural user phrasing. Its one weakness is an under-specified 'what' — the capability statement is a single clause ("Writes under the `tasks` role") — leaving the artifact the skill produces implied rather than stated.

DimensionReasoningScore

Specificity

The description names several concrete actions — "plan a task", "create a task file", "produce a task breakdown in the accepted format", "prepare a critiqued strategy before coding" — plus where it writes ("Writes under the `tasks` role"), matching the anchor 'lists several specific actions; minor gaps in coverage'. It falls short of 5 because the actions are four phrasings of one planning activity and omit what the skill actually produces (variant options, DoD tuples, index/SRS updates).

4 / 5

Completeness

Both halves are explicit: 'when' is exceptionally strong ("Use ONLY when the user explicitly asks to..." plus negative scope "Not for design chat or ad-hoc code suggestions"), while 'what' is thinner — "Writes under the `tasks` role" states the location but not the artifact (a critiqued plan in the accepted task format appears only as a trigger phrase). This sits between anchor 4 ('both what and when; one could be more specific') and anchor 5; the thin 'what' keeps it at 4.

4 / 5

Trigger Term Quality

Natural phrases a user would say are present — "plan a task", "task file", "task breakdown", "strategy before coding", "design chat" — giving good keyword coverage per the anchor. Not 5: common variations like "make a plan", "break this down", "planning doc", or a file extension (.md) are missing; not 3 because multiple natural trigger phrasings, not just one generic keyword, appear.

4 / 5

Distinctiveness Conflict Risk

"Use ONLY when the user explicitly asks" plus the explicit exclusion "Not for design chat or ad-hoc code suggestions" give it a clear niche with distinct triggers and minimal conflict risk, matching the anchor 5 example's structure (positive triggers + explicit scope fence). The ONLY+exclusion combo distinguishes it from general planning, architecting, or implementation skills.

5 / 5

Total

17

/

20

Passed

Validation

87%

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

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

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

Warning

referenced_paths_exist

Referenced path issues: 2 missing

Warning

Total

14

/

16

Passed

Repository

korchasa/flowai-plugins

Path

plugins/flowai/skills/plan/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.