CtrlK
BlogDocsLog inGet started
Tessl Logo

architecture-strategist

Analyzes code changes from an architectural perspective for pattern compliance and design integrity. Use when reviewing PRs, adding services, or evaluating structural refactors.

52

Quality

60%

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

Quality

Content

50%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 reads as a competent agent system prompt with a sensible four-phase analysis method and a defined output structure, but it has no concrete examples or commands and repeats its coupling/boundary/dependency concerns across three overlapping lists. Adding a short worked example of a violation report and consolidating the redundant lists would substantially improve it.

Suggestions

Consolidate the 'When conducting your analysis, you will', 'Your evaluation must verify', and 'architectural smells' bullet lists into a single deduplicated checklist — they restate coupling, boundaries, and dependency concerns three times.

Add one short worked example showing the five-part output format in action (e.g., a sample circular-dependency finding and its recommendation) to make the guidance concrete rather than purely descriptive.

Insert markdown section headers (e.g., '## Analysis process', '## Output format') to give the ~60-line body clear navigation structure.

DimensionReasoningScore

Conciseness

The body does not explain concepts Claude already knows, but it is noticeably redundant: the "When conducting your analysis, you will" bullet list, the "Your evaluation must verify" bullet list, and the "architectural smells" list restate overlapping coupling/boundary/dependency concerns three times over. This matches anchor 3 (mostly efficient but could be tightened); it is above anchor 2 because nothing is padded filler or basic tutorial prose, and below anchor 4 because the overlapping lists are unnecessary repetition that could be trimmed.

3 / 5

Actionability

As an instruction-only skill it gives some concrete direction ("Map component dependencies by examining import statements", "verify compliance with SOLID principles", the five-part output format), but there are no executable examples, commands, or concrete output templates beyond section headings. It sits at anchor 3 (some concrete guidance but incomplete); anchor 4 would require concrete code or commands with only minor gaps, and anchor 2 would mean only high-level hints, whereas here specific checks like import-depth analysis and circular-dependency detection are named.

3 / 5

Workflow Clarity

A clear four-step sequence is present (Understand System Architecture → Analyze Change Context → Identify Violations → Consider Long-term Implications) plus a structured five-section output format. However, no validation checkpoints exist — nothing tells the agent to verify a suspected violation against actual imports before reporting it. This matches anchor 3 (sequence present but checkpoints missing or implicit); the destructive/batch cap does not apply since this is read-only analysis, but the missing verification step keeps it below anchor 4.

3 / 5

Progressive Disclosure

The body is roughly 60 lines of continuous prose with no markdown section headers and no referenced bundle files (no references/, scripts/, or assets/ directories exist). The lists provide some internal structure, but content such as the examples block and the evaluation checklists could be better organized with headers or split out. This matches anchor 3 (some structure but could be better organized); it is below anchor 4 because organization is implicit rather than clearly signaled.

3 / 5

Total

12

/

20

Passed

Description

70%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 well-formed description with an explicit 'Use when' trigger clause covering natural scenarios (PR review, adding services, structural refactors). Its main weakness is that the capability statement stays abstract — 'pattern compliance and design integrity' — rather than naming concrete actions like checking coupling, service boundaries, or dependency violations.

DimensionReasoningScore

Specificity

The description names the domain ("architectural perspective") and one concrete action ("Analyzes code changes"), but the remaining phrases ("pattern compliance and design integrity") are abstract qualities rather than additional concrete actions. It matches anchor 3 (domain plus 1-2 concrete actions, not comprehensive); it is below anchor 4 because it does not list several specific actions, and above anchor 2 because it is more than a bare domain label.

3 / 5

Completeness

Both parts are present: the 'what' ("Analyzes code changes from an architectural perspective for pattern compliance and design integrity") and an explicit 'when' clause ("Use when reviewing PRs, adding services, or evaluating structural refactors"). It does not reach anchor 5 because the 'what' is stated at a fairly abstract level rather than with multiple concrete capabilities; it exceeds anchor 3 because the 'when' is explicit, not merely implied.

4 / 5

Trigger Term Quality

"Use when reviewing PRs, adding services, or evaluating structural refactors" covers good natural trigger phrases users would actually say. It falls short of anchor 5 because common variations like "architecture review", "design review", or "refactoring" as a standalone trigger term are missing; it is above anchor 3 because several relevant natural terms are present, not just some.

4 / 5

Distinctiveness Conflict Risk

"Analyzes code changes from an architectural perspective" carves out a recognizable niche distinct from generic code review or testing skills. There is minor overlap risk with closely related review skills (e.g., general PR review or design-pattern skills), which keeps it below anchor 5 but above anchor 3, where overlap with similar skills would be more likely.

4 / 5

Total

15

/

20

Passed

Validation

81%

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

Validation — 13 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_version

'metadata.version' is missing

Warning

metadata_field

'metadata' should map string keys to string values

Warning

frontmatter_unknown_keys

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

Warning

Total

13

/

16

Passed

Repository
udecode/plate
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.