CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

aif-architecture

Generate architecture guidelines for the project. Analyzes tech stack from DESCRIPTION.md, recommends an architecture pattern, and creates .ai-factory/ARCHITECTURE.md. Use when setting up project architecture, asking "which architecture", or after /aif setup.

Quality

91%

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

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

A well-engineered workflow skill: concrete, sequenced, and validation-aware, with an appropriately split single reference file that exists and is clearly signaled. The only notable weakness is localized redundancy in the skill-context guidance, which is stated twice and could be consolidated to save tokens.

DimensionReasoningScore

Conciseness

The body is almost entirely procedural — exact paths, config keys, an argument mapping table, and templates — with no re-teaching of concepts Claude already knows. Minor trimmable redundancy exists: skill-context precedence rules are explained both in the "Shared project skill-context" section and again across Step 0's ~19-line application block, and "CRITICAL" warnings repeat. Not 3 because the padding is localized (<10% of the body) rather than pervasive.

4 / 5

Actionability

Fully concrete guidance for an instruction-only skill: config resolution order with explicit defaults, a complete argument→pattern mapping (including legacy aliases and suffixed variants), copy-paste AskUserQuestion prompts, a full output template, and a verified one-level reference for pattern details. Not 4 because the common cases (configured, default, and missing-input invocations) are all covered with executable specifics.

5 / 5

Workflow Clarity

Steps 0→5 are clearly sequenced with explicit user-decision gates ("Wait for their answer before generating"), a missing-file fallback with a ready-to-show message, a pre-generation alignment check (Step 1.5), and a validate→fix feedback loop ("After generating any output artifact, verify it against all skill-context rules... fix the output before presenting it"). The skill writes documentation rather than performing destructive/batch operations, so the validation cap does not apply.

5 / 5

Progressive Disclosure

The 700-line pattern knowledge base is correctly split into references/architecture.md (a real file), clearly signaled three times in the body and at exactly one level of depth, while SKILL.md retains only the workflow and the output template it needs inline. Not 4 because there is no misplaced inline content and navigation to the reference is explicit and repeated.

5 / 5

Total

19

/

20

Passed

Description

88%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, concrete named actions and file paths, and an explicit "Use when" clause with natural trigger phrases. Trigger synonym coverage is good but not exhaustive, and the broad "setting up project architecture" trigger leaves minor overlap risk with sibling workflow skills.

DimensionReasoningScore

Specificity

The description lists multiple concrete actions with named artifacts — "Analyzes tech stack from DESCRIPTION.md", "recommends an architecture pattern", "creates .ai-factory/ARCHITECTURE.md" — covering the skill's capabilities comprehensively; unmentioned side effects (DESCRIPTION.md/AGENTS.md pointer updates) are incidental, not capability gaps.

5 / 5

Completeness

It explicitly answers both questions: the "what" is concrete (analyze tech stack, recommend pattern, create .ai-factory/ARCHITECTURE.md) and the "when" is an explicit "Use when" clause with three concrete trigger scenarios. Matches the anchor-5 pattern of what + when with concrete triggers; not 4 because the when-clause is specific rather than generic.

5 / 5

Trigger Term Quality

Triggers "setting up project architecture", "which architecture", and "after /aif setup" are phrases users would naturally say, but common variations such as "system design", "architecture pattern", or "monolith vs microservices" are absent. Not 3 because several genuinely natural trigger phrases are present; not 5 because synonym coverage is incomplete.

4 / 5

Distinctiveness Conflict Risk

The niche (architecture guideline generation within the /aif workflow, anchored by ".ai-factory/ARCHITECTURE.md" and "/aif setup") is mostly distinct, with only minor overlap risk against sibling aif-* skills like setup or roadmap that also touch project context files. Not 5 because "setting up project architecture" is still somewhat broad as a standalone trigger.

4 / 5

Total

18

/

20

Passed

Validation

87%

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

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

allowed_tools_field

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

Warning

frontmatter_unknown_keys

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

Warning

Total

14

/

16

Passed

Repository

lee-to/ai-factory

Path

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