CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

architecture-interview

Analyze, review, and plan architecture alternatives through a structured interview. Use when the user needs tradeoffs surfaced before implementation or a Linear decision note instead of an ADR.

Quality

75%

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/product-strategy/architecture-interview/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 has a coherent interview workflow with an explicit fail-fast feedback loop, but suffers from three duplicated sections (Failure Mode, Gotchas, Execution Boundaries), a missing decision-note template, and Progressive Disclosure pointers to files that do not exist in the bundle. Fixing the duplication and dangling Infrastructure/ paths would materially raise quality.

Suggestions

Remove the duplicated 'Failure Mode' and 'Gotchas' sections and the repeated 'Execution Boundaries' bullets — each pair says nearly the same thing, so merge into one section each.

Add a short template or worked example of the Linear-ready decision note (decision, alternatives considered, sacrifice, assumptions, validation criteria) so the primary output artifact is concrete.

Fix the Progressive Disclosure pointers: the cited Infrastructure/references/software-literature-expert-lens-pack.md and software-literature-skill-expertise-map.md paths do not exist in this bundle — either include the files or correct the paths — and de-duplicate the disclosure bullets.

DimensionReasoningScore

Conciseness

The body is mostly lean bullet-style guidance, but 'Failure Mode' and 'Gotchas' each appear twice with near-identical text, and 'Execution Boundaries' repeats its bullets verbatim ('Produce interview questions...' and 'Do not create ADRs...' each appear twice). The duplication exceeds the minor trimming of the 4 anchor but is not pervasive enough for the 2 anchor's 'several padded sections'.

3 / 5

Actionability

Directives are concrete ('frame the decision in one sentence', 'Compare 2-4 viable alternatives', 'Name the sacrifice and the non-obvious consequence'), but the skill's primary output artifact — the Linear-ready decision note — has no template or example showing its structure. The guidance is actionable but incomplete, matching the 3 anchor's 'missing key details' rather than the 4 anchor's minor gaps.

3 / 5

Workflow Clarity

The six-step workflow is clearly sequenced (frame, ask, compare, name sacrifice, produce note, fail fast) and the Validation section supplies a real feedback loop ('stop at the first failed gate; do not proceed until it is fixed and rerun'). Not 5 because validation checkpoints are generic — no concrete validator, check, or command is named for any step.

4 / 5

Progressive Disclosure

Sections are well-organized and the local references (references/contract.yaml, references/evals.yaml, references/task-profile.json) resolve in the bundle, but the primary 'Read when' pointers — Infrastructure/references/software-literature-expert-lens-pack.md and Infrastructure/references/software-literature-skill-expertise-map.md — do not exist in this bundle, and the Progressive Disclosure bullets are themselves duplicated. Dangling primary references and duplication place this at the 3 anchor's 'could be better organized' rather than the 4 anchor's 'references mostly clear'.

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: third-person voice, explicit 'Use when' trigger clause, and a distinctive Linear-decision-note-vs-ADR framing. The main gap is trigger-term breadth — common synonyms like 'design decision' or 'system design' are absent, so a user phrasing the need differently might not surface this skill.

DimensionReasoningScore

Specificity

Names several specific actions and artifacts — 'Analyze, review, and plan architecture alternatives through a structured interview', 'tradeoffs surfaced', 'Linear decision note instead of an ADR' — though the leading verbs are somewhat generic. It lists several specific actions with minor gaps rather than the comprehensive coverage of the 5 anchor, and exceeds the 1-2 concrete actions of the 3 anchor.

4 / 5

Completeness

Explicitly answers both what ('Analyze, review, and plan architecture alternatives through a structured interview') and when ('Use when the user needs tradeoffs surfaced before implementation or a Linear decision note instead of an ADR') with concrete trigger phrases, matching the 5 anchor pattern exactly. Not 4, because the 'when' clause is fully explicit rather than merely adequate.

5 / 5

Trigger Term Quality

Good natural keyword coverage: 'architecture', 'tradeoffs', 'implementation', 'ADR', 'Linear decision note'. A few natural terms users might say are missing, such as 'design decision', 'system design', or 'compare options', keeping it below the comprehensive synonym coverage of the 5 anchor.

4 / 5

Distinctiveness Conflict Risk

A clear niche — pre-implementation architecture decision interviews with Linear-vs-ADR output capture — with distinct triggers, but 'tradeoffs surfaced before implementation' has minor overlap with general planning or code-review skills. Mostly distinct rather than minimal-conflict like the 5 anchor.

4 / 5

Total

17

/

20

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 — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

jscraik/Agent-Skills

Path

Skills/product-strategy/architecture-interview/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.