CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

flow-define

Multi-AI requirements scoping using available external providers (Double Diamond Define phase). Priority triggers: octo define, octo scope, co-define, co-scope. DO NOT use for implementation, research, review/validation, or built-in commands.

Quality

70%

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 ./.claude/skills/flow-define/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

62%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's execution contract is exemplary — a rigorously sequenced, validated, blocking workflow with real error recovery. Its quality is dragged down by severe duplication (nearly the entire second half restates the first) and the absence of any file-level decomposition, making it far more token-expensive than the procedure warrants.

Suggestions

Delete the duplicated second-half sections ("What This Workflow Does", "How It Works" Stages A-D, "Implementation Instructions") that restate the Execution Contract, keeping one authoritative 7-step sequence.

Move the ~100-line Example 1 (auth definition) and the illustrative banner template into a separate EXAMPLES.md / references file and link to them from the body.

Trim repeated boilerplate to a single occurrence: the banner text appears in both Step 1 and "Visual Indicators", and cost/provider details appear in both the banner and the "Cost Awareness" section.

DimensionReasoningScore

Conciseness

The ~745-line body duplicates itself heavily: the 7-step sequence is restated in "Implementation Instructions", the banner template appears twice, the orchestrate.sh command appears three times, and "How It Works" (Stages A-D) re-narrates Steps 4-7. A ~100-line worked example and a second copy of provider/cost information add further padding; this goes well beyond "some unnecessary explanation" but stops short of explaining basic concepts Claude already knows.

2 / 5

Actionability

Mostly executable: full provider-check bash with awk parsing and allowlist handling, exact script paths, concrete AskUserQuestion specs, and a real synthesis-file verification block. However, placeholder-laden sections (user_flow="[Answer from question 1]", "$USER_REQUEST", TaskUpdate({taskId: "..."})) and the fragile grep-based decision extraction prevent full copy-paste readiness.

4 / 5

Workflow Clarity

Seven explicitly sequenced, individually blocking steps each gated by a "DO NOT PROCEED until..." checkpoint; Step 1 validates provider availability with exit-on-fail, Step 5 verifies the synthesis file exists, and the error-handling section defines per-step failure recovery (show logs, suggest /octo:setup, never substitute direct analysis). A quality checklist covers completion.

5 / 5

Progressive Disclosure

A single 745-line monolith with no bundle files; the worked examples, banner templates, and cost/provider tables clearly belong in separate reference files. Section headers do provide navigable structure and the two external references (skills/blocks/*.md) are signaled, so structure exists but organization into files is absent.

3 / 5

Total

14

/

20

Passed

Description

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

The description is well-bounded with explicit positive triggers and a strong exclusion list, making conflict risk low. Its main weaknesses are thin action specificity and trigger terms framed as command aliases rather than natural user phrasing, which limits discoverability for users who don't already know the plugin's command vocabulary.

Suggestions

Enumerate the concrete outputs of the scoping work (e.g., "clarifies requirements, identifies technical constraints and edge cases, defines scope boundaries") instead of the single phrase "requirements scoping".

Add natural trigger phrases users would actually say — e.g., "Use when the user asks to define the requirements for X, clarify the scope of Y, or specify what X needs to do" — alongside the command aliases.

Replace the alias-only "Priority triggers" list with a proper "Use when..." clause so the activation conditions read as situations rather than command names.

DimensionReasoningScore

Specificity

"Multi-AI requirements scoping using available external providers" names the domain and one concrete action, but the description never enumerates what the scoping actually produces (clarifying requirements, constraints, edge cases, scope boundaries). It sits above anchor 2 (generic actions) but below anchor 4 (several specific actions listed).

3 / 5

Completeness

Both "what" (Multi-AI requirements scoping using external providers) and "when" (explicit "Priority triggers" plus a "DO NOT use for" exclusion list) are present, so the missing-"Use when" cap does not apply. However, the "when" clause relies on command aliases rather than concrete natural trigger phrases, keeping it below anchor 5.

4 / 5

Trigger Term Quality

The trigger terms "octo define, octo scope, co-define, co-scope" are plugin command aliases rather than phrases a user would naturally say; common variations like "define the requirements", "clarify the scope", or "problem definition" are absent. Relevant keywords exist (define, scope, requirements) but coverage of natural synonyms is incomplete.

3 / 5

Distinctiveness Conflict Risk

The explicit negative boundary ("DO NOT use for implementation, research, review/validation, or built-in commands") cleanly fences off sibling workflows, and the Double Diamond Define-phase niche with distinct plugin command triggers gives minimal overlap risk.

5 / 5

Total

15

/

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

skill_md_line_count

SKILL.md is long (784 lines); consider splitting into references/ and linking

Warning

frontmatter_unknown_keys

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

Warning

Total

14

/

16

Passed

Repository

nyldn/claude-octopus

Path

.claude/skills/flow-define/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.