CtrlK
BlogDocsLog inGet started
Tessl Logo

spring-planning

Create structured implementation plan in docs/plans/

54

Quality

Does it follow best practices?

Impact

No eval scenarios have been run

SecuritybySnyk

Passed

No known issues

SKILL.md
Quality
Evals
Security

Quality

Content

75%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

The body is highly actionable with a clear sequenced workflow and validation checkpoints, but it is somewhat verbose due to repeated test mandates and keeps a large plan template inline rather than splitting it into a reference file.

Suggestions

De-duplicate the testing mandates: state them once and reference back, instead of repeating 'CRITICAL: every task MUST include tests' across multiple sections.

Move the full plan template into a referenced file (e.g. references/plan-template.md) and keep only a concise sketch in SKILL.md to improve progressive disclosure.

Tighten the Preflight section's installation fallback text, which is lengthy for a contingency branch.

DimensionReasoningScore

Conciseness

The body is mostly efficient procedural guidance, but it pads with repeated 'CRITICAL' test mandates restated across the Development Approach, Testing Strategy, and Implementation Steps sections, which could be tightened.

2 / 3

Actionability

It provides concrete executable guidance throughout: exact file paths, a full plan template with checkboxes, specific AskUserQuestion JSON, and a dependency-detection table mapping starters to skills.

3 / 3

Workflow Clarity

Steps 0 through 3 are clearly sequenced with explicit validation checkpoints (tests must pass before next task, STOP before moving on, re-ask loop after IDE review) and error-recovery feedback loops.

3 / 3

Progressive Disclosure

No bundle files are present and the skill is a single self-contained SKILL.md, but the plan template and task guidelines are embedded inline as a large block that could be split into a referenced template file.

2 / 3

Total

10

/

12

Passed

Description

45%

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 concise and names a concrete artifact, but it lacks an explicit 'Use when' trigger clause and natural user-facing trigger terms, leaving activation guidance implicit.

Suggestions

Add a 'Use when' clause naming natural triggers, e.g. 'Use when planning a new feature, bug fix, refactor, or migration that needs a structured implementation plan.'

Expand from one action to a few concrete ones (e.g. 'gather context, propose approaches, and create a structured plan') to strengthen specificity.

Include common user phrasings like 'implementation plan', 'plan a task', or 'feature plan' to improve trigger-term coverage.

DimensionReasoningScore

Specificity

The phrase 'Create structured implementation plan' names the core action and a concrete artifact ('docs/plans/'), but it lists a single action rather than multiple specific concrete actions, falling short of the score-3 anchor.

2 / 3

Completeness

It states what the skill does (create a plan in docs/plans/) but includes no 'Use when...' clause or equivalent explicit trigger guidance, capping completeness at 2 per the rubric.

2 / 3

Trigger Term Quality

It includes the relevant keyword 'implementation plan', which a user might say, but it lacks common variations like 'plan a feature', 'feature plan', or 'task plan', so coverage is partial.

2 / 3

Distinctiveness Conflict Risk

'Create structured implementation plan in docs/plans/' is somewhat specific to a niche but 'implementation plan' is generic enough to overlap with other planning skills, not a fully distinct trigger set.

2 / 3

Total

8

/

12

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.

Validation16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
Amplicode/spring-skills
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.