CtrlK
BlogDocsLog inGet started
Tessl Logo

dev-planning

AI DevKit · Planning phase guidance for creating and reconciling feature task plans. Use when the user wants to create an implementation plan, update planning docs, mark task progress, capture blockers or new tasks, or run dev-lifecycle planning work.

63

Quality

79%

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 ./skills/dev-planning/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

78%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 a lean, well-structured instruction skill: concrete CLI commands, specific field checklists, clearly sequenced procedures with validation checkpoints, and clean phase-to-phase navigation in a self-contained 44-line document. Remaining gaps are minor — some repeated clauses across sections and the absence of an example task-entry format or a post-reconciliation verification loop.

DimensionReasoningScore

Conciseness

The body is imperative and lean with no explanation of concepts Claude already knows ('Run npx ai-devkit@latest lint --feature <name>', 'record completed/blocked/new tasks, blockers, and next action per task'). It is not 5 because the lint command and the 'If task tracing is available' clause repeat across the Phase Contract and both procedures and could be consolidated, and not 3 because there is no unnecessary explanation or padding.

4 / 5

Actionability

Concrete executable commands ('npx ai-devkit@latest lint --feature <name>', resolve '.ai-devkit.json paths.docs, falling back to docs/ai') and specific per-task fields (outcome, dependencies, validation evidence, related testing scenarios) give mostly executable guidance. It is not 5 because there is no copy-paste-ready example of a task entry or planning-doc format, and not 3 because the guidance is concrete and specific rather than high-level hints.

4 / 5

Workflow Clarity

Both procedures are clearly sequenced numbered lists with explicit phase transitions ('Next: dev-implementation'; 'if all done, run implementation verification before testing and review') and a validation checkpoint ('Verify every test-plan scenario has at least one implementation task'). It is not 5 because reconciliation has no explicit verify-after-write or error-recovery feedback loop, and not 3 because checkpoints are present, not merely implied.

4 / 5

Progressive Disclosure

The body is a 44-line, self-contained instruction skill with no bundle files, and its well-organized sections (Phase Contract, Create Initial Plan, Update Planning) with clear next-phase navigation match the under-50-lines simple-skill exception. It is not 4 because there is no content that clearly belongs in a separate reference file and navigation between the two procedures is unambiguous.

5 / 5

Total

17

/

20

Passed

Description

70%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 answers both what and when with an explicit, multi-trigger 'Use when' clause and natural user phrasing, and is well-scoped to the AI DevKit planning niche. Its main weakness is specificity: the capability side is limited to two fairly abstract actions ('creating and reconciling') rather than an enumerated list of concrete operations.

Suggestions

Enumerate the concrete planning operations in the capability half (e.g., 'Create ordered implementation tasks from requirements/design/testing docs, reconcile task statuses, record blockers and scope changes') to lift specificity beyond 1-2 actions.

Add one or two plain-language synonyms for the jargon-heavy triggers (e.g., 'to-do list for a feature', 'plan checklist') so users who don't say 'dev-lifecycle' still naturally match.

DimensionReasoningScore

Specificity

Names the domain ('feature task plans') with two concrete actions ('creating and reconciling'), matching the anchor for 1-2 concrete actions without comprehensive coverage. It is not 4 because it does not enumerate several specific actions, and not 2 because the actions named are more than minimal or generic.

3 / 5

Completeness

Both what ('creating and reconciling feature task plans') and when (explicit 'Use when the user wants to create an implementation plan, update planning docs, mark task progress, capture blockers or new tasks...') are present, with the when clause concrete and multi-trigger. It is not 5 because the what-side ('Planning phase guidance for...') is thinner and less concretely enumerated than the 5 anchor's action list, and not 3 because the when is explicit, not implied.

4 / 5

Trigger Term Quality

'implementation plan', 'update planning docs', 'mark task progress', 'capture blockers', and 'new tasks' are natural phrases users would say, giving good keyword coverage. It is not 5 because kit-specific jargon ('AI DevKit', 'dev-lifecycle') stands in for common synonyms a user might use, and not 3 because the natural terms present go beyond 'some relevant keywords'.

4 / 5

Distinctiveness Conflict Risk

Scoping to 'AI DevKit' and 'dev-lifecycle planning work' carves a mostly distinct niche with clear triggers, though 'create an implementation plan' could overlap with general planning skills. It is not 5 because generic planning phrasing keeps some overlap risk, and not 3 because the kit-specific framing makes wrong-skill triggering unlikely.

4 / 5

Total

15

/

20

Passed

Validation

100%

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

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
codeaholicguy/ai-devkit
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.