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
75%
Does it follow best practices?
Impact
—
No eval scenarios have been run
Passed
No known issues
Optimize this skill with Tessl
npx tessl skill review --optimize ./skills/information-architecture/SKILL.mdQuality
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.
| Dimension | Reasoning | Score |
|---|---|---|
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.
| Dimension | Reasoning | Score |
|---|---|---|
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.
Validation — 10 / 11 Passed
Validation for skill structure
| Criteria | Description | Result |
|---|---|---|
frontmatter_unknown_keys | Unknown frontmatter key(s) found; consider removing or moving to metadata | Warning |
Total | 10 / 11 Passed | |
8e70d03
Table of Contents
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.