CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

planning-architect

Comprehensive skill development planning. Analyzes requirements, chooses organizational patterns (workflow/task/reference/capabilities), defines structure, estimates complexity, identifies dependencies, and creates detailed implementation plan. Use when planning new skills, converting documentation to skills, or architecting complex skill systems.

Quality

73%

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

Fix and improve this skill with Tessl

tessl review fix ./skills/planning-architect/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

56%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 teaches a genuinely useful, well-sequenced six-step planning process with strong per-step actionability and a sound progressive-disclosure design, and it practices what it preaches by shipping four real reference guides and an automation script. Its main defects are significant redundancy in the body (duplicated and internally contradictory Quick Reference content) and three broken bundle references, including the missing output template the skill directs users to.

Suggestions

Deduplicate the body: remove or drastically trim the Quick Reference section so the four patterns, the decision tree, and the 6-step list each appear once — the current duplicate step table contradicts the actual Step 4-6 (Estimate Complexity, Identify Dependencies, Define Validation) and risks misleading the reader.

Fix the broken bundle references: create templates/skill-plan-template.md (referenced as the structured output format) and either add or correct the paths for references/content-specification-guide.md and references/complexity-assessment-guide.md.

Reconcile the contradictory progressive-disclosure numbers into one set of guidelines (e.g., pick one SKILL.md size target and one references/ file-size target) — the body currently states four mutually inconsistent limits.

DimensionReasoningScore

Conciseness

The ~4,800-word body noticeably duplicates itself: the four organizational patterns are fully described twice (Step 2 and the Quick Reference table), the pattern-selection decision tree appears twice, the progressive-disclosure rules are restated with contradicting numbers ("<5,000 words / ~1,000-1,500 lines" vs "<1,200 lines ideal"; "references/ 10,000+ words okay" vs "300-600 lines per file"), and the Quick Reference's 6-step table lists different steps ("4. Plan Content", "6. Create Plan Document") than the actual workflow (Estimate Complexity, Identify Dependencies, Define Validation). Sections like Success Criteria, Planning Output, and the generic question lists restate guidance Claude can infer or that appears earlier. This matches anchor 2 (several unnecessary/padded sections) rather than 3, because whole sections are redundant rather than individual sentences needing tightening.

2 / 5

Actionability

As an instruction-only skill it provides concrete, executable guidance: question templates for each step, defined output formats, a worked estimation formula with three calibrated examples, a dependency documentation format, ready-to-run script commands (`python scripts/plan-skill.py --interactive`), and full worked planning examples. It stops short of a 5 because the referenced output template (templates/skill-plan-template.md) does not exist in the bundle, and the pattern-complexity multipliers (1.2x, 1.3x) appear only in worked examples, not in the factor definitions.

4 / 5

Workflow Clarity

The six steps are clearly sequenced, each with a stated Objective, Process, Output, Example, and See Also link, and checkpoints exist via the estimation checklist, quick planning checklist, and the dedicated validation-criteria step. It does not reach 5 because the duplicated Quick Reference step table contradicts the authoritative step list (different steps 4-6), and plan review/validation is described as a follow-up activity rather than an explicit in-workflow checkpoint.

4 / 5

Progressive Disclosure

The architecture is well designed — per-step "See Also" links, a central References section with descriptive summaries, one-level-deep reference files that exist for all four core guides, plus a real scripts/plan-skill.py. However, three of the eight referenced bundle paths are broken: templates/skill-plan-template.md (the skill's own output format), references/content-specification-guide.md, and references/complexity-assessment-guide.md do not exist, and there is no templates/ directory at all despite the skill prescribing one. References are clearly signaled (better than anchor 3's wording), but the broken paths — including the missing output template — are a substantial navigation failure that drops it below anchor 4's "minor organization gaps".

3 / 5

Total

13

/

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 pairs a concrete multi-action capability statement with an explicit "Use when..." trigger clause covering three distinct scenarios. Its only weaknesses are mild abstraction in a couple of the listed actions, a slightly padded opener, and a small risk of overlapping with sibling skill-building skills.

DimensionReasoningScore

Specificity

The description lists six concrete actions ("Analyzes requirements", "chooses organizational patterns (workflow/task/reference/capabilities)", "defines structure", "estimates complexity", "identifies dependencies", "creates detailed implementation plan"), covering the full planning pipeline. It falls short of a 5 because several actions remain abstract ("defines structure", "creates detailed implementation plan" name no artifacts) and the opener "Comprehensive skill development planning" is padded phrasing rather than a concrete capability.

4 / 5

Completeness

It explicitly answers both questions: the "what" is the enumerated pipeline of actions, and the "when" is an explicit "Use when planning new skills, converting documentation to skills, or architecting complex skill systems" clause with three concrete trigger scenarios — matching the anchor-5 example structure.

5 / 5

Trigger Term Quality

Natural trigger phrases are present: "planning new skills", "converting documentation to skills", "architecting complex skill systems" — phrasings a user would plausibly say. A few natural synonyms are missing (e.g., "design a skill", "build a skill", "skill structure"), so it does not reach the comprehensive synonym coverage of a 5.

4 / 5

Distinctiveness Conflict Risk

It occupies a clear niche (skill development planning) with distinct triggers unlikely to fire for unrelated skills. There is minor overlap risk with closely related skill-building skills (e.g., a skill-builder or task-breakdown skill could also plausibly trigger on "planning new skills"), keeping it just below a 5.

4 / 5

Total

17

/

20

Passed

Validation

75%

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

Validation — 12 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

skill_md_line_count

SKILL.md is long (1330 lines); consider splitting into references/ and linking

Warning

allowed_tools_field

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

Warning

relative_links

Relative link issues: 1 missing

Warning

referenced_paths_exist

Referenced path issues: 2 missing

Warning

Total

12

/

16

Passed

Repository

fernandezbaptiste/Skrillz

Path

skills/planning-architect/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.