CtrlK
BlogDocsLog inGet started
Tessl Logo

information-architecture

Design the structure of a website or product including sitemap, navigation, URL structure, content types, taxonomy, and labeling. Use this skill whenever the user asks to plan a sitemap, design navigation, structure URLs, define content types, build taxonomies, design site search, or organize content at the system level. Triggers on sitemap, site structure, navigation, IA, information architecture, URL structure, content types, taxonomy, categorization, breadcrumbs, hub pages, faceted navigation, site search, labeling. Also triggers when content is being created without a structural plan, or when an existing site's structure is being audited or restructured.

63

Quality

75%

Does it follow best practices?

Impact

No eval scenarios have been run

SecuritybySnyk

Passed

No known issues

Optimize this skill with Tessl

npx tessl skill review --optimize ./skills/information-architecture/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Discovery

100%

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

This is an excellent skill description that clearly defines the scope of information architecture work, provides comprehensive trigger terms covering both technical and common user language, and explicitly states both what the skill does and when to use it. The inclusion of edge-case triggers (content without a structural plan, auditing existing structures) adds valuable completeness. The description uses proper third-person voice throughout.

DimensionReasoningScore

Specificity

Lists multiple specific concrete actions: 'plan a sitemap, design navigation, structure URLs, define content types, build taxonomies, design site search, organize content at the system level.' Also mentions auditing and restructuring existing sites.

3 / 3

Completeness

Clearly answers both 'what' (design sitemap, navigation, URL structure, content types, taxonomy, labeling) and 'when' with an explicit 'Use this skill whenever...' clause plus a detailed triggers list and additional contextual triggers (content without structural plan, auditing existing structure).

3 / 3

Trigger Term Quality

Excellent coverage of natural trigger terms including both formal ('information architecture', 'faceted navigation', 'taxonomy') and common user language ('sitemap', 'site structure', 'navigation', 'categorization', 'breadcrumbs', 'hub pages', 'URL structure'). The abbreviation 'IA' is also included.

3 / 3

Distinctiveness Conflict Risk

Occupies a clear niche around information architecture and site structure planning. The specific triggers like 'sitemap', 'IA', 'faceted navigation', 'taxonomy', 'breadcrumbs', and 'hub pages' are highly distinctive and unlikely to conflict with general content writing, UX design, or web development skills.

3 / 3

Total

12

/

12

Passed

Implementation

50%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

This is a comprehensive, well-structured information architecture skill that covers the domain thoroughly with clear frameworks and useful failure patterns. Its main weaknesses are moderate verbosity (explaining concepts an AI would know), lack of concrete executable examples or inline templates, and missing validation/feedback loops in the workflow. The referenced bundle files don't exist, undermining the progressive disclosure strategy.

Suggestions

Add an inline example of a completed mini-sitemap or IA document snippet so Claude has a concrete output template to follow, improving actionability.

Add explicit feedback loops to the workflow, e.g., 'After step 3, review sitemap against mental models from step 2; if misaligned, revise before proceeding.'

Trim sections that explain well-known concepts (e.g., what breadcrumbs are, basic URL hygiene) to improve conciseness — focus on the decision framework rather than definitions.

Provide the referenced bundle files (ia-document-template.md, url-pattern-library.md) or inline the most critical template content to ensure references are functional.

DimensionReasoningScore

Conciseness

The skill is well-organized but includes some content Claude already knows (URL principles like 'lowercase, hyphen-separated', general label advice). The mental models section explains card sorting and tree testing methods at length, which is somewhat verbose for an AI audience. However, most content earns its place as domain-specific guidance.

2 / 3

Actionability

The skill provides concrete frameworks, patterns, and specific URL examples, but lacks executable code or copy-paste-ready artifacts. The guidance is specific (e.g., '5 to 7 items maximum' for nav, '5 to 15' categories) but the workflow steps are descriptive rather than executable — there are no concrete templates inline, no example sitemap output, and no sample taxonomy structure to work from.

2 / 3

Workflow Clarity

The 9-step workflow is clearly sequenced and logical, but lacks explicit validation checkpoints or feedback loops. Step 7 mentions validation via tree testing, but there's no 'if validation fails, go back to step X' guidance. For a skill that produces structural deliverables affecting downstream work, the absence of review/iteration gates is a gap.

2 / 3

Progressive Disclosure

The skill references two external files (ia-document-template.md and url-pattern-library.md) which is good progressive disclosure design, but no bundle files were provided, meaning those references are broken. The main file itself is quite long (~200+ lines) and some sections (like the detailed URL patterns or navigation subsections) could be split into reference files to keep the overview leaner.

2 / 3

Total

8

/

12

Passed

Validation

90%

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

Validation10 / 11 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

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

Warning

Total

10

/

11

Passed

Repository
rampstackco/claude-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.