CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

multi-ai-planning

Create production-ready, agent-executable plans using verification-first approach, hierarchical decomposition, dependency mapping, and quality gates. Optional multi-AI research integration (Claude + Gemini + Codex). Use when planning complex features, migrations, refactorings, security implementations, or any multi-step agentic workflows requiring rigorous verification and parallel execution coordination.

Quality

72%

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/multi-ai-planning/SKILL.md

The canonical home for this skill is multi-ai-planning in fernandezbaptiste/Skrillz

SKILL.md
Quality
Evals
Security

Quality

Content

51%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 has an exceptionally clear, well-validated 6-step workflow with genuine feedback loops, but it is embedded in a heavily padded ~1140-line monolith. Verbose per-step boilerplate, redundant Best Practices/Common Mistakes sections, explanations of concepts Claude already knows, and — most seriously — references to bundle files (scripts, templates, schemas, examples) that do not exist in the bundle undermine both token efficiency and navigability. The executable commands are concrete in form but not actually runnable as written.

Suggestions

Make every referenced path resolve: either add the missing bundle files (scripts/validate-schema.sh, scripts/generate-plan-md.sh, scripts/visualize-deps.sh, templates/PLAN_TEMPLATE.md, templates/VERIFICATION_TEMPLATE.md, the three JSON schemas, and examples/) or remove the broken references and the "For examples, see examples/" line from the body.

Cut the duplication: merge the "Best Practices" and "Common Mistakes" sections (which restate the six steps' own validation checklists) into brief notes inside each step, and trim the repeated Purpose/Inputs/Outputs/Time-Estimate boilerplate to what each step actually adds.

Move the five near-identical Step 5 quality-assessment templates into a references/ file (e.g., references/quality-assessment.md), and replace the execution-template pseudocode (executeTask/verifyTask/createCheckpoint) with real Task-tool invocations or concrete bash so the guidance is copy-paste runnable.

DimensionReasoningScore

Conciseness

The ~1140-line body repeats heavy scaffolding per step ("Purpose/Inputs/Process/Outputs/Validation/Time Estimate/Next"), then restates the same six steps twice more in "Best Practices" ("Practice: Break down until tasks cannot be meaningfully subdivided") and "Common Mistakes" ("Fix: SMART criteria - specific, measurable, testable"), and explains concepts Claude already knows (SMART criteria, critical path, topological sort). It is noticeably verbose with several padded sections, but the core workflow guidance is substantive rather than foundational-knowledge padding throughout, which keeps it above the anchor-1 example.

2 / 5

Actionability

Concrete commands exist ("git tag -a cp-001 -m \"Schema and OAuth\"", "npm test -- src/auth/tokens.test.ts", "grep -q \"function generateToken\" src/auth/tokens.ts || exit 1"), but key commands invoke scripts absent from the bundle ("bash scripts/validate-schema.sh plan.json", "bash scripts/generate-plan-md.sh plan.json", "scripts/visualize-deps.sh") and the execution template is pseudocode with undefined functions ("executeTask(task)", "verifyTask(task)", "createCheckpoint(task.id)"). This matches anchor 3 (concrete guidance but incomplete; pseudocode rather than executable code) better than anchor 4, since the gaps exceed minor.

3 / 5

Workflow Clarity

The "6-step sequential process" is clearly sequenced with per-step Validation checklists ("[ ] Every task has specific success criteria"), explicit quality gates ("Gate 1: Foundation Complete"), and a real feedback loop at the decision point ("If <90: Apply fixes, return to relevant step, re-verify"). This squarely matches anchor 5: clear sequence, explicit validation steps, error-recovery loops, and checklists for a complex process.

5 / 5

Progressive Disclosure

Scored against the actual bundle: of the ~9 paths the body references, only "references/task-tool-coordination.md" exists; "scripts/visualize-deps.sh", "scripts/validate-schema.sh" (cited twice, once as ".claude/skills/multi-ai-planning/scripts/validate-schema.sh"), "scripts/generate-plan-md.sh", "templates/VERIFICATION_TEMPLATE.md", "templates/PLAN_TEMPLATE.md", "examples/", and the three schemas (plan.schema.json, task.schema.json, checkpoint.schema.json) are all missing. Meanwhile ~130 lines of near-identical fill-in assessment templates in Step 5 and the section headers are inlined monolithically. This fits anchor 2 (content that clearly belongs in separate files is inlined; navigation points to files that don't resolve) better than anchor 3, where references are present but merely under-signaled.

2 / 5

Total

12

/

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.

The description is strong: it clearly and explicitly states both what the skill does and when to use it, in third person, with concrete technique names and natural trigger terms spanning features, migrations, refactorings, security implementations, and multi-step agentic workflows. Its only weaknesses are minor — a single dominant action verb ("create plans") and a few missing common planning synonyms that keep specificity and trigger coverage just below the top anchor.

DimensionReasoningScore

Specificity

"Create production-ready, agent-executable plans using verification-first approach, hierarchical decomposition, dependency mapping, and quality gates" names the domain plus several concrete techniques. It falls short of anchor 5 because the only concrete action verb is "Create... plans" — the rest are method names — and outputs (plan.json, PLAN.md) and coverage details are omitted; it is clearly above anchor 3, which expects only 1-2 concrete actions.

4 / 5

Completeness

It explicitly answers both what ("Create production-ready, agent-executable plans using verification-first approach, hierarchical decomposition, dependency mapping, and quality gates") and when ("Use when planning complex features, migrations, refactorings, security implementations, or any multi-step agentic workflows requiring rigorous verification and parallel execution coordination") with concrete trigger phrases, exactly matching the anchor-5 example pattern.

5 / 5

Trigger Term Quality

"Use when planning complex features, migrations, refactorings, security implementations, or any multi-step agentic workflows" gives good natural keyword coverage users would actually say. It sits at anchor 4 rather than 5 because common variations like "implementation plan", "task breakdown", "roadmap", or "project planning" are missing; it is well above anchor 3's "some relevant keywords but missing common variations".

4 / 5

Distinctiveness Conflict Risk

"agent-executable plans", "multi-AI research integration (Claude + Gemini + Codex)", and "parallel execution coordination" carve out a mostly distinct planning niche, but "planning complex features, migrations, refactorings" overlaps with general feature-development and project-planning skills, so it fits anchor 4 (mostly distinct, minor overlap risk with closely related skills) rather than anchor 5's clear-niche bar, and is well above anchor 3.

4 / 5

Total

17

/

20

Passed

Validation

81%

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

Validation — 13 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

skill_md_line_count

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

Warning

allowed_tools_field

'allowed-tools' contains unusual tool name(s)

Warning

referenced_paths_exist

Referenced path issues: 3 missing

Warning

Total

13

/

16

Passed

Repository

fernandezbaptiste/Skrillz

Path

.claude/skills/multi-ai-planning/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.