Skip to main content
skill CX Codex

information-architecture-reviewer — Claude Code skill: setup & use

information-architecture-reviewer is a Claude Code skill that audits navigation and content hierarchy against user tasks. It identifies dead ends and ambiguous labels along target flows.

MIT ★ 529 updated 2026-11-17

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add ShuaiMXu/happyhands --skill information-architecture-reviewer -a claude-code
Open on GitHub

What information-architecture-reviewer does

The skill checks navigation structures, category groupings, and labels against a specific critical task. It consumes landmark counts and heading hierarchies from captured DOM to spot structural barriers that block user progress.

A single capture of the homepage is insufficient to evaluate information architecture. The review requires representative routes, interface states, and full navigation hierarchy. When inputs are missing, the skill marks findings as needs-evidence. It outputs directly into the ongoing audit run instead of generating a separate report, and it forbids invented experience scores.

What it helps with

  • identify navigation dead ends and ambiguous categories
  • trace the user path to complete a critical product task
  • inspect heading hierarchy and landmark counts from DOM
  • record route evidence and consequences of structural defects

Example prompts for the agent

  • Review navigation hierarchy for the checkout flow
  • Trace the user route to password reset and flag dead ends
  • Inspect headings and menu grouping for the report export task

How to install information-architecture-reviewer

1Skills CLI (Vercel)

npx skills add ShuaiMXu/happyhands --skill information-architecture-reviewer -a claude-code

2Manually: put the files in place

~/.claude/skills/information-architecture-reviewer/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/information-architecture-reviewer/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about information-architecture-reviewer

How to install information-architecture-reviewer in Claude Code?

Run npx skills add ShuaiMXu/happyhands --skill information-architecture-reviewer -a claude-code.

What does information-architecture-reviewer do?

It inspects navigation labels, page hierarchies, and DOM landmarks to locate obstacles in critical user paths.

What evidence does information-architecture-reviewer require?

The review requires a defined critical task, representative routes, screen states, and navigation labels. A single homepage capture is not enough.

Source text

SKILL.md · MIT
---
name: information-architecture-reviewer
description: "Review navigation, grouping and content structure against a product critical task."
---

# Information Architecture Reviewer

Find structural obstacles that prevent users from locating or understanding the next step.

## Required evidence

- critical task
- representative routes and states
- navigation labels and hierarchy

## Decisions

- Trace the path to the task
- Identify ambiguous categories and dead ends
- Cite route and state evidence

## Boundary

A single homepage capture cannot establish full information architecture.

Return structured evidence, findings, proposed updates and limitations. Use `needs-evidence` when required inputs or professional review are missing. Never invent an Experience Score or promote a project observation into a universal rule.

## Execution contract and admission

The bounded handler supplies: Landmark counts and heading-order candidates from reached capture DOM.

The professional method still requires: Inspect the task navigation, grouping, labels and recovery on original pages; counts do not demonstrate an information-architecture defect.

Deliver into the current Run's existing experience audit or decision; do not create a competing report. Cite the frozen Skill path and exact rule, original state and source, observed failure, task consequence and the reasoning connecting them. Record preservation/counterevidence. With no demonstrated defect, keep the candidate unadmitted and make no change. `complete` describes this handler's bounded output, not professional review or human acceptance.

© ShuaiMXu · MIT · ShuaiMXu/happyhands

Similar skills

All skills for Design →

From the same set34

The whole set →
judgment-distiller judgment-distiller is a Claude Code skill that turns an accept-or-reject decision and its rationale into a project-scoped learning candidate. It keeps observations separate from broader principles. CX Codex +1 ★ 529repo stars component-reuse-planner component-reuse-planner is a Claude Code skill that decides whether to reuse, extend, or create UI components. The decision relies on the governed project inventory and approved states. CX Codex +1 ★ 529repo stars content-design-reviewer content-design-reviewer is a Claude Code skill that checks interface labels and guidance for clarity and consistency. It ties findings to a user task and its outcome. CX Codex +1 ★ 529repo stars interaction-reviewer interaction-reviewer is a Claude Code skill that reviews interaction flow and control behavior. It detects missing feedback, unnecessary steps, and unsafe UI state transitions. CX Codex +1 ★ 529repo stars foundation-extractor Foundation-extractor is a Claude Code skill that builds an inventory of design tokens and component sources. It maps existing design elements in a repository before proposing foundation updates. CX Codex +1 ★ 529repo stars component-inventory component-inventory is a Claude Code skill that maps components to source paths, variants, composition, and known consumers. It supports reuse decisions and drift analysis. CX Codex +1 ★ 529repo stars visual-qa-evaluator Visual-qa-evaluator is a Claude Code skill that prepares evidence for visual QA and regression analysis. It supports matching interface states to evaluate design changes. CX Codex +1 ★ 529repo stars brand-foundation-extractor brand-foundation-extractor is a Claude Code skill that gathers candidate brand principles, voice cues, and visual assets from project files and rendered content. It keeps each finding tied to its source. CX Codex +1 ★ 529repo stars

Project sponsors

Companies that keep this analytics open