CtrlK
BlogDocsLog inGet started
Tessl Logo

architecture

Architectural decision-making framework. Requirements analysis, trade-off evaluation, ADR documentation. Use when making architecture decisions or analyzing system design.

52

Quality

59%

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/architecture/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

43%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 body is a lean, well-intentioned overview that correctly assumes Claude's intelligence, but it delegates all substantive guidance to five referenced files that are missing from the bundle, leaving no executable framework, template, or ordered workflow inline. It functions as a table of contents for a book that was never shipped.

Suggestions

Create the five referenced files (context-discovery.md, trade-off-analysis.md, pattern-selection.md, examples.md, patterns-reference.md) under references/ and point the content map at real paths, or remove the table and inline the essential decision framework.

Add a numbered core workflow (e.g. gather requirements -> classify project -> shortlist patterns -> trade-off analysis -> write ADR) with explicit validation checkpoints instead of relying solely on the unordered checklist.

Delete the boilerplate 'When to Use' line and trim the generic Limitations section to limitations specific to architectural decision-making.

DimensionReasoningScore

Conciseness

The body is short and lean, assumes Claude's intelligence (no explaining what architecture is), and is mostly tables and terse principles. Not 5 because the boilerplate "This skill is applicable to execute the workflow or actions described in the overview" and the generic Limitations section are filler that could be trimmed; not 3 because the padding is minor in token terms and the rest is efficient.

4 / 5

Actionability

Concrete executable substance is minimal: "Start simple / Add complexity ONLY when proven necessary" and a validation checklist are high-level hints, with the actual how-to delegated to referenced files ("Decision trees, anti-patterns", "ADR templates") that contain the steps. Not 3 because there is no inline procedure, template, or decision framework a reader could execute; not 1 because the checklist and file map give some direction rather than pure abstraction.

2 / 5

Workflow Clarity

No sequenced workflow exists; the content map's When-to-Read column only implies a rough order ("Starting architecture design" before "Choosing patterns" before "Documenting decisions"), and the checklist is an unordered gate rather than steps. Not 3 because even the implied sequence has gaps with no stated step order or entry point; not 1 because a rough progression is discernible from the table and the checklist acts as a partial pre-finalization checkpoint.

2 / 5

Progressive Disclosure

The "Read ONLY files relevant to the request!" content-map table (File | Description | When to Read) is good navigation design, but the five referenced files (e.g. "context-discovery.md", "trade-off-analysis.md") do not exist — there are no references/, scripts/, or assets/ directories — so the navigation leads nowhere, and the names are bare filenames rather than resolvable paths/links. Not 4 because well-signaled references must actually resolve for structure to be considered appropriately placed; not 2 because the overview itself is properly slim and the reference map is clearly signaled rather than buried.

3 / 5

Total

11

/

20

Passed

Description

75%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 solid description that explicitly covers what the skill does and when to use it, in third person, with three concrete capability statements and natural trigger phrases. Its main weaknesses are a circular 'when' clause and missing common trigger synonyms.

DimensionReasoningScore

Specificity

"Requirements analysis, trade-off evaluation, ADR documentation" lists three concrete activities, matching the anchor for several specific actions with minor gaps. Not 5 because "Architectural decision-making framework" is an abstract descriptor rather than an action and coverage is not comprehensive; not 3 because multiple concrete actions are named beyond just the domain.

4 / 5

Completeness

It answers 'what' ("Requirements analysis, trade-off evaluation, ADR documentation") and 'when' ("Use when making architecture decisions or analyzing system design") in third person. Not 5 because the 'when' clause is circular (restates the skill's own domain) rather than giving concrete, varied trigger phrases; not 3 because both what and when are explicitly present.

4 / 5

Trigger Term Quality

"making architecture decisions" and "analyzing system design" are natural phrases users would say, alongside "trade-off" and "requirements". Not 5 because common variations like "tech stack", "design review", or "choosing between X and Y" are missing; not 3 because keyword coverage goes beyond a single generic term to several natural phrasings.

4 / 5

Distinctiveness Conflict Risk

ADRs, trade-off evaluation, and architecture decision-making carve a fairly distinct niche with low conflict risk. Not 5 because "analyzing system design" is broad enough to overlap with adjacent design/code-review skills; not 3 because the ADR and trade-off triggers are clearly specific to this skill.

4 / 5

Total

16

/

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

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

15

/

16

Passed

Repository
sickn33/agentic-awesome-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.