CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

flow-develop

Multi-AI implementation using available external providers (Double Diamond Develop phase). DO NOT use for simple code edits, reading/reviewing code, built-in commands, or trivial single-file changes.

Quality

54%

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

Quality

Content

38%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 skill is highly actionable — concrete commands, scripts, prompts, and validation gates cover every phase — but it is buried in an 800-line monolith with wholesale duplicated sections, conflicting step numbering, and references to files and placeholders that do not resolve within the bundle. A disciplined rewrite could cut its length by more than half while preserving all executable guidance.

Suggestions

Delete the duplicated "Develop Workflow" and "Implementation Instructions" restatements of Steps 1-2 and the banner, keeping one canonical sequence with one step numbering scheme.

Move the subtype quality-supplement table, frontend-ui BM25 enrichment, banner templates, and example transcripts into separate reference files under references/ and link to them one level deep.

Resolve or remove the unresolved template placeholders ({{PREAMBLE}}, {{VISUAL_INDICATORS}}, {{QUALITY_GATES}}) and the unpopulated ${codex_status}/${agy_status} variables, or document where they come from, and isolate version-specific notes (CC v2.1.77+, v7.16.0+) in a compatibility section.

DimensionReasoningScore

Conciseness

At 808 lines the body is severely padded: context detection and the banner are stated twice with conflicting formats, there are three separate checklists, repeated "MANDATORY - CANNOT SKIP" / "DO NOT PROCEED TO STEP X" boilerplate, and a WHY-justification for why code review matters — all concepts Claude already knows. It also embeds time-sensitive version numbers (v7.16.0+, CC v2.1.77+, v9.5) inline rather than in a deprecation section, matching anchor 1's heavily padded profile.

1 / 5

Actionability

The guidance is mostly executable: concrete bash for every phase (orchestrate.sh, state-manager.sh, synthesis verification via find, git checkpoint tagging), a subtype table with concrete quality supplements, and full agent prompts. Minor gaps keep it below anchor 5: ${codex_status}/${agy_status} are never populated, prompts contain literal placeholders like "<user's task description>", and the BM25 snippet embeds literal \n strings that would not run as-is.

4 / 5

Workflow Clarity

Sequence and validation are explicit (Step 5 synthesis verification, an error-handling section, verification gate before checkpoint), so it sits above anchor 3's missing checkpoints. But the "Implementation Instructions" section renumbers the same workflow differently (Step 3 = orchestrate vs. Step 4 in the contract; Step 4 = validation vs. Step 5), and the two banner templates conflict (four provider lines with a duplicated Antigravity row vs. three lines with a session ID) — duplicating and contradicting the sequence is more than anchor 4's "minor validation gaps".

3 / 5

Progressive Disclosure

The bundle ships no reference files at all, yet the body points to plugin-internal paths (skills/blocks/codex-host-adapter.md, skills/blocks/engineering-method-selection.md) and unresolved template placeholders ({{PREAMBLE}}, {{VISUAL_INDICATORS}}, {{QUALITY_GATES}}) that are not present, while inlining ~800 lines of banners, subtype tables, examples, and agent prompts that clearly belong in separate files — matching anchor 2's inlining of separate-file content, worsened by broken references.

2 / 5

Total

10

/

20

Passed

Description

48%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 establishes a recognizable niche and avoids conflicts through an explicit exclusion list, but it is thin: one generic action, no positive trigger guidance, and no enumeration of the concrete capabilities the skill actually performs. A user scanning descriptions would struggle to know when to invoke it.

Suggestions

Add a positive trigger clause naming natural user phrases, e.g. "Use when the user asks to build or implement a feature, endpoint, or architecture requiring multi-provider analysis".

Enumerate 2-3 concrete actions, e.g. "Generates multiple implementation approaches via external CLI providers (Codex, Antigravity), synthesizes them into a recommended plan, and runs quality gates".

Include common synonyms users say for this skill ("build", "implement", "code generation", "architecture") so it competes on trigger terms, not just exclusions.

DimensionReasoningScore

Specificity

The only positive capability stated is "Multi-AI implementation using available external providers" — a single generic action plus domain, equivalent to anchor 2's "Processes PDF files". Concrete actions like generating multiple implementation approaches, synthesizing provider outputs, or running quality gates are absent, so it does not reach anchor 3's "1-2 concrete actions".

2 / 5

Completeness

A "what" is present (multi-AI implementation, Develop phase) but "when" exists only negatively ("DO NOT use for simple code edits, reading/reviewing code...") with no positive trigger clause; per the judging guidelines a missing 'Use when' clause caps completeness at 3, and the exclusion list only weakly implies the intended use.

3 / 5

Trigger Term Quality

Relevant keywords appear ("implementation", "code edits", "reading/reviewing code") but the natural phrases a user would actually say ("build a feature", "implement", "create an endpoint") are missing, and coverage leans on exclusion terms rather than synonyms — matching anchor 3's "some relevant keywords but missing common variations".

3 / 5

Distinctiveness Conflict Risk

The explicit DO-NOT list (simple code edits, reading/reviewing code, built-in commands, trivial single-file changes) plus a clear multi-provider orchestration niche make it mostly distinct with only minor overlap risk against generic implementation skills — anchor 4. Without positive triggers it cannot fully claim anchor 5's minimal conflict risk.

4 / 5

Total

12

/

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

skill_md_line_count

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

Warning

Total

15

/

16

Passed

Repository

nyldn/claude-octopus

Path

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