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
74%
Does it follow best practices?
Impact
90%
1.60xAverage score across 3 eval scenarios
Passed
No known issues
Optimize this skill with Tessl
npx tessl skill review --optimize ./skills/data/0-planning/SKILL.mdQuality
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').
| Dimension | Reasoning | Score |
|---|---|---|
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.
| Dimension | Reasoning | Score |
|---|---|---|
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.
Validation — 11 / 11 Passed
Validation for skill structure
No warnings or errors.
c8a8050
Table of Contents
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.