CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

architecture-planning

Plan the future architecture of a new or materially changing system before implementation. Use for greenfield products, planned platform changes, and technical blueprints spanning components, data, APIs, deployment, and delivery trade-offs. Do not use to audit an existing repository, review a PR, or diagnose an incident.

Quality

89%

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

SKILL.md
Quality
Evals
Security

Quality

Content

88%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.

An exceptionally well-structured instruction skill: phased workflow with validation gates, a concrete output template, an enforced quality checklist, and disciplined on-demand references. The two weaknesses are minor: slight redundancy between the routing section and the frontmatter description, and Base Framework / workflow-contract links that resolve to no file in the bundle as shipped.

Suggestions

Ship or inline the Base Framework policy files: the nine `shared/base/*.md` links in the 'Base Framework' section and `shared/workflow-contract.md` are referenced as 'required packaged policies' but no `shared/` directory exists in the bundle, so those paths dangle.

Trim the 'Routing Boundary' section — its do-not-use list substantially repeats the frontmatter description's negative triggers; keep only the routing note and the sibling-skill mapping that add new information.

Fix the mojibake quotation marks in the routing note ('?Design a new SaaS?' and '?review our current architecture?') so the examples read as intended quoted phrases.

DimensionReasoningScore

Conciseness

The body is dense and judgment-laden ("Microservices require justification by real constraints... a 3-person team cannot run 12 services"; "a justification that could be pasted into any project's plan... is not a justification") with no padding explaining concepts Claude already knows. It is not 5 because sections like the seven judgment principles and the Routing Boundary (which largely repeats the frontmatter's do-not-use list) could each be tightened without losing content.

4 / 5

Actionability

Guidance is copy-paste concrete for an instruction-only skill: an exact 18-section output template, an ordered Phase 2 decision sequence, a capped intake-question protocol ("ask up to 5 focused questions"), a specified assumption format ("number the assumptions (A1, A2, ...) in a table... reference them by id"), per-decision reference pointers, and a worked example of expected behavior. Per the rubric's code-vs-instruction note, the absence of code is not penalized; the guidance is fully executable as written.

5 / 5

Workflow Clarity

Five phases are explicitly ordered and scoped ("Phases 1–2 are thinking; 3–5 fill in the plan"), each phase has a defined output, and validation checkpoints are explicit: the ask-before-assuming loop with numbered assumptions and open-question-to-decision mapping, plus a final checklist enforced as a quality gate ("an unchecked box with a reason beats a dishonest tick"). This matches anchor 5's clear sequence with explicit validation and a checklist for a complex process.

5 / 5

Progressive Disclosure

The body stays an overview with well-signaled, one-level-deep references — inline at point of need ("Use the decision framework in `references/styles.md`") plus a "Read | When the engagement involves" reference map — and all 7 referenced `references/*.md` files exist in the bundle. It is not 5 because the 9 linked `shared/base/*.md` policy paths and `shared/workflow-contract.md` do not exist anywhere in the provided bundle, leaving dangling reference targets.

4 / 5

Total

18

/

20

Passed

Description

87%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: third person, explicit what/when with concrete positive and negative triggers, and a well-fenced niche that separates it from review/debugging skills. The only soft spot is that capability coverage is expressed as one planning action plus a scope enumeration rather than multiple distinct concrete actions.

DimensionReasoningScore

Specificity

Concrete scope is stated — "Plan the future architecture of a new or materially changing system before implementation" with deliverable coverage of "components, data, APIs, deployment, and delivery trade-offs" — but the action set centers on a single planning verb rather than several distinct concrete actions, so it sits noticeably above anchor 3 without fully matching anchor 5's multiple discrete actions.

4 / 5

Completeness

The "what" is explicit ("Plan the future architecture of a new or materially changing system before implementation") and the "when" is an explicit trigger clause ("Use for greenfield products, planned platform changes, and technical blueprints..."), further reinforced with negative triggers ("Do not use to audit an existing repository, review a PR, or diagnose an incident"). It is not below 5 because nothing in the when-clause is implicit or generic.

5 / 5

Trigger Term Quality

Natural user phrasings are present — "greenfield products", "planned platform changes", "technical blueprints", "architecture" — that a user planning a system would plausibly say; a few common synonyms ("design a new system", "system design", "tech stack decisions") are missing, keeping it below anchor 5's comprehensive synonym coverage.

4 / 5

Distinctiveness Conflict Risk

A clear niche — forward-looking, pre-implementation planning — is staked out, and the do-not-use list explicitly fences off adjacent skills (repo audit, PR review, incident diagnosis), giving minimal conflict risk. It fits anchor 5's "clear niche with distinct triggers" exactly.

5 / 5

Total

18

/

20

Passed

Validation

93%

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

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

relative_links

Relative link issues: 9 missing, 8 deeper-than-1-level

Warning

Total

15

/

16

Passed

Repository

Noorkhalel/saas-ai-skills

Path

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