CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

aif-plan

Plan a feature or task in fast, full, or ultra mode. Ultra creates an indexed multi-file bundle with deeply specified phases for execution by a smaller model. Use for "plan", "new feature", "start feature", "create tasks", or exhaustive implementation planning.

Quality

82%

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

SKILL.md
Quality
Evals
Security

Quality

Content

77%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 body is exceptionally actionable and its workflow is rigorously sequenced with validation and repair loops at every risky point, supported by a clean one-level-deep reference bundle. Its weaknesses are length and imbalance: duplicated rule blocks and large handoff/numbering/hashing details inlined in SKILL.md instead of delegated to reference files make it harder to navigate than its structure deserves.

Suggestions

Deduplicate repeated blocks: state the SHA256 normalization procedure and the '--parallel' sequential-prefix rule once and cross-reference them from the other locations (Step 5, Step 1.4, Plan File Handling) to cut significant tokens.

Move the Handoff branch-ownership contract (Step 0 'Branch ownership under Handoff') and the sequential numbering algorithm's edge-case notes into a dedicated reference file (e.g., references/HANDOFF.md), keeping only the decision rules inline in SKILL.md.

Trim rationale prose aimed at the reader (e.g., the 'AI-generated code benefits greatly from extensive logging because' bullet list) down to the rule itself ('Default to verbose logging'), trusting Claude's competence.

DimensionReasoningScore

Conciseness

The body is procedural rule-density rather than concept padding (no 'what is git' explanations), so it is above a 2, but it is noticeably over-long: the SHA256 normalization procedure is repeated nearly verbatim in Step 0 and Step 5, the '--parallel' sequential-prefix warning appears three times (Step 1.2.c, Step 1.4, Plan File Handling), and rationale prose like 'AI-generated code benefits greatly from extensive logging because...' assumes less competence than Claude has. Substantial tightening via deduplication is possible without losing meaning.

3 / 5

Actionability

Guidance is fully executable: exact commands ('Bash: git rev-parse --abbrev-ref HEAD', 'git worktree add ../${DIRNAME}-<branch-name-with-hyphens> <branch-name>', 'mkdir -p <configured plans dir>'), exact machine-readable markers ('<!-- aif:task-kind:commit -->', '<!-- aif:plan-mode:ultra -->'), a complete AskUserQuestion script, and a step-by-step sequential numbering algorithm with glob patterns and an abort condition. Nothing is left as pseudocode or vague direction.

5 / 5

Workflow Clarity

Steps are numbered and explicitly sequenced (Step 0 pre through Step 6 plus subcommands) with early-return jumps clearly marked ('--list and --cleanup execute immediately and STOP'). Validation and feedback loops are explicit throughout: strict branch-drift equality check with a STOP, ultra bundle-integrity checks ('Fix broken links, missing/duplicate task IDs, orphan phase files'), and the meaning-preservation gate with PASS/FAIL and a repeat-comparison repair loop.

5 / 5

Progressive Disclosure

The three reference files (EXAMPLES.md, TASK-FORMAT.md, ULTRA-FORMAT.md) are real, one level deep with no nested chains, and clearly signaled at the right points ('read references/ULTRA-FORMAT.md before creating or modifying the bundle'). However, the ~1,200-line body inlines large detail blocks that clearly belong in references — the ~60-line Handoff branch-ownership contract, the hashing procedure, and sequential-numbering edge cases — so the split between overview and detail is imbalanced.

3 / 5

Total

16

/

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 that explicitly states what the skill does across its three modes and gives a concrete 'Use for' trigger list. Trigger terms are natural, though a few synonyms are absent and 'plan'/'create tasks' carry mild overlap risk with adjacent skills.

DimensionReasoningScore

Specificity

Concrete actions are named — 'Plan a feature or task in fast, full, or ultra mode' and 'Ultra creates an indexed multi-file bundle with deeply specified phases for execution by a smaller model' — but fast/full capabilities are only summarized, leaving minor coverage gaps. Not a 5 because several capabilities (preferences, branch/worktree flow, roadmap linkage) are never mentioned; not a 3 because more than 1-2 specific actions with differentiated modes are explicitly stated.

4 / 5

Completeness

Both questions are explicitly answered: what ('Plan a feature or task in fast, full, or ultra mode. Ultra creates an indexed multi-file bundle...') and when ('Use for "plan", "new feature", "start feature", "create tasks", or exhaustive implementation planning') with concrete trigger phrases. This matches the anchor that clearly and explicitly answers both what AND when with concrete triggers.

5 / 5

Trigger Term Quality

Natural user phrases are present: 'plan', 'new feature', 'start feature', 'create tasks', 'exhaustive implementation planning'. A few common variations are missing (e.g., 'implementation plan', 'task breakdown', 'break down this feature'), so it falls short of the comprehensive synonym coverage of a 5 but is well above the partial coverage of a 3.

4 / 5

Distinctiveness Conflict Risk

The planning niche is fairly distinct ('exhaustive implementation planning', ultra bundle delegation), but 'plan' and 'create tasks' are broad triggers with minor overlap risk against task-management or generic planning skills. It is mostly distinct with minor overlap risk rather than a fully clear niche.

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 (1225 lines); consider splitting into references/ and linking

Warning

allowed_tools_field

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

Warning

frontmatter_unknown_keys

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

Warning

Total

13

/

16

Passed

Repository

lee-to/ai-factory

Path

skills/aif-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.