CtrlK
BlogDocsLog inGet started
Tessl Logo

planning

Universal planning for technical and non-technical projects. Domains: software implementation, business, personal, creative, academic, events. Capabilities: feature planning, system architecture, goal setting, milestone planning, requirement breakdown, trade-off analysis, resource allocation, risk assessment. Actions: plan, architect, design, evaluate, breakdown, structure projects. Keywords: implementation plan, technical design, architecture, roadmap, project plan, strategy, goal setting, milestones, timeline, action plan, SMART goals, sprint planning, task breakdown, OKRs. Use when: planning features, designing architecture, creating roadmaps, setting goals, organizing projects, breaking down requirements.

82

1.60x
Quality

74%

Does it follow best practices?

Impact

90%

1.60x

Average score across 3 eval scenarios

SecuritybySnyk

Passed

No known issues

Optimize this skill with Tessl

npx tessl skill review --optimize ./skills/data/0-planning/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Discovery

92%

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

This is a well-structured description that excels in specificity, trigger term coverage, and completeness with a clear 'Use when' clause. Its main weakness is the intentionally broad scope ('universal planning') which spans many domains and could conflict with more specialized skills. The description uses proper third-person voice and avoids vague fluff.

Suggestions

Consider narrowing the scope or adding differentiating language that clarifies when this skill should be chosen over more specialized planning or architecture skills (e.g., 'Use this for general-purpose planning when no domain-specific planning skill is available').

DimensionReasoningScore

Specificity

Lists multiple specific concrete actions including feature planning, system architecture, goal setting, milestone planning, requirement breakdown, trade-off analysis, resource allocation, and risk assessment. Also enumerates specific verbs: plan, architect, design, evaluate, breakdown, structure.

3 / 3

Completeness

Clearly answers both 'what' (universal planning with specific capabilities like feature planning, architecture, risk assessment) and 'when' with an explicit 'Use when:' clause listing specific triggers like planning features, designing architecture, creating roadmaps, setting goals.

3 / 3

Trigger Term Quality

Excellent coverage of natural terms users would say: 'implementation plan', 'roadmap', 'project plan', 'goal setting', 'milestones', 'timeline', 'action plan', 'SMART goals', 'sprint planning', 'task breakdown', 'OKRs'. These are terms users naturally use when requesting planning help.

3 / 3

Distinctiveness Conflict Risk

While the description is detailed, 'universal planning' is inherently broad and could overlap with many other skills — a dedicated architecture skill, a project management skill, a goal-setting skill, or a sprint planning skill could all conflict. The breadth across six domains (software, business, personal, creative, academic, events) increases conflict risk.

2 / 3

Total

11

/

12

Passed

Implementation

57%

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

This is a well-structured planning skill with good progressive disclosure and clear mode selection between technical and non-technical projects. Its main weaknesses are that most actionable content is deferred to reference files, leaving the main skill somewhat abstract, and it lacks validation/feedback loops in its workflows. Some generic advice and principles Claude already knows could be trimmed for better token efficiency.

Suggestions

Add a validation checkpoint to the technical workflow (e.g., 'Review plan against requirements checklist before finalizing') and a feedback loop for plan iteration - missing validation caps workflow clarity at 2.

Include at least one concrete, inline example of a completed plan section (e.g., a sample SMART goal or a sample phase breakdown) rather than deferring all examples to reference files.

Remove generic advice Claude already knows (YAGNI/KISS/DRY, 'Be thorough and specific', 'Simple, understandable structure') to improve token efficiency.

DimensionReasoningScore

Conciseness

Generally efficient with good use of tables and lists, but includes some unnecessary filler like 'Plan quality determines implementation success. Be comprehensive.' and restates principles Claude already knows (YAGNI, KISS, DRY). The quality standards section has some generic advice ('Be thorough and specific', 'Simple, understandable structure') that doesn't add value.

2 / 3

Actionability

Provides structured workflows and output formats, but most concrete guidance is deferred to reference files. The skill itself lacks executable examples - the code snippets shown are just directory structures and YAML templates rather than actionable commands. The pre-planning protocol with the shell command is a good concrete element, but overall the skill describes what to do rather than showing how.

2 / 3

Workflow Clarity

The technical implementation workflow has clear numbered steps with skip conditions, which is good. However, there are no validation checkpoints or feedback loops - no step to verify the plan's completeness, validate against requirements, or iterate on issues. The pre-planning protocol is a good checkpoint but it's placed after the main workflows rather than integrated into them.

2 / 3

Progressive Disclosure

Excellent use of progressive disclosure with a clear overview in the main file and well-signaled one-level-deep references to specific methodology files and templates. The references section provides a clean index, and the workflow steps clearly indicate which reference file to consult at each stage.

3 / 3

Total

9

/

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.

Validation11 / 11 Passed

Validation for skill structure

No warnings or errors.

Repository
majiayu000/claude-skill-registry
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.