information-architecture · aj-geddes — Claude Code skill: setup and overview
Structures content, sitemaps, and taxonomies for web apps and documentation hubs. It guides your AI agent through a four-stage process from card sorting to tree testing.
npx skills add aj-geddes/useful-ai-prompts --skill information-architecture -a claude-codeWhat information-architecture does
The skill organizes complex content spaces like documentation libraries and online stores. Instead of guessing navigation labels, it walks the AI through four clear stages: research into user mental models, structure development, wireframing, and prototype validation. It points to reference guides in the references/ directory for card sorting, sitemap design, and search discovery.
Hierarchy depth is capped at three levels max. If a navigation tree goes deeper, users get lost, so the skill tells the assistant to flatten deep branches early. It also forbids relying solely on menus, requiring clear non-technical labels alongside working search functionality.
What it helps with
- design sitemaps and navigation hierarchies for large websites
- set up open and closed card sorting sessions
- create clear taxonomies without internal technical jargon
- plan user flows and search discovery systems
Example prompts for the agent
- Help me design a sitemap for an e-commerce platform capped at three levels of depth.
- Review our documentation hierarchy and prepare an open card sorting plan.
- Build a content taxonomy and user flow following the IA Process guide.
How to install information-architecture
1Skills CLI (Vercel)
npx skills add aj-geddes/useful-ai-prompts --skill information-architecture -a claude-code2Manually: put the files in place
~/.claude/skills/information-architecture/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/information-architecture/
1Skills CLI (Vercel)
npx skills add aj-geddes/useful-ai-prompts --skill information-architecture -a codex2Manually: put the files in place
.agents/skills/information-architecture/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add aj-geddes/useful-ai-prompts --skill information-architecture -a cursor2Manually: put the files in place
.cursor/skills/information-architecture/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install aj-geddes/useful-ai-prompts information-architecture2Manually: put the files in place
.github/skills/information-architecture/SKILL.md1Skills CLI (Vercel)
npx skills add aj-geddes/useful-ai-prompts --skill information-architecture -a gemini-cli2Platform CLI
gemini skills install https://github.com/aj-geddes/useful-ai-prompts --path skills/information-architectureManually: put the files in place
.devin/skills/information-architecture/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add aj-geddes/useful-ai-prompts --skill information-architecture -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about information-architecture
How do I install information-architecture in Claude Code?
Run npx skills add aj-geddes/useful-ai-prompts --skill information-architecture -a claude-code. The skill file is placed in ~/.claude/skills/information-architecture/SKILL.md.
What does the information-architecture skill do?
It structures content planning across four phases: user research, taxonomy development, wireframing with sitemaps, and prototype validation via tree testing.
What hierarchy constraints does the skill enforce?
It limits navigation depth to a maximum of three levels. It also requires straightforward labels without jargon and insists on offering search alongside standard menus.
Source text
SKILL.md · MIT
--- name: information-architecture description: > Organize and structure information for clarity and discoverability. Design navigation systems, hierarchies, and mental models that match user needs. --- # Information Architecture ## Table of Contents - [Overview](#overview) - [When to Use](#when-to-use) - [Quick Start](#quick-start) - [Reference Guides](#reference-guides) - [Best Practices](#best-practices) ## Overview Information Architecture creates logical structures that help users find and understand information easily. ## When to Use - Website or app redesign - Large information spaces (documentation, e-commerce) - Navigation structure planning - Taxonomy and categorization - Search functionality design - User journey mapping ## Quick Start Minimal working example: ```yaml IA Process: 1. Research & Discovery - Interview users about mental models - Card sorting sessions (open and closed) - Analyze current usage patterns - Competitive analysis 2. Structure Development - Create organization scheme (hierarchical, faceted, etc.) - Define categories and relationships - Build taxonomy - Plan navigation 3. Wireframing - Sitemap creation - Navigation structure - Page templates - User flows 4. Validation - User testing with prototypes - Tree testing (navigation only) - Iterate based on feedback // ... (see reference guides for full implementation) ``` ## Reference Guides Detailed implementations in the `references/` directory: | Guide | Contents | |---|---| | [Card Sorting & Taxonomy](references/card-sorting-taxonomy.md) | Card Sorting & Taxonomy | | [Sitemap & Navigation Structure](references/sitemap-navigation-structure.md) | Sitemap & Navigation Structure | | [Search & Discovery](references/search-discovery.md) | Search & Discovery | ## Best Practices ### ✅ DO - Start with user research - Conduct card sorting studies - Use user mental models - Keep hierarchy 3 levels deep max - Use clear, simple labels - Enable multiple ways to find content - Test navigation with users - Update based on usage data - Document taxonomy - Provide search functionality ### ❌ DON'T - Impose organizational structure without research - Use jargon or technical terms - Make hierarchy too deep - Bury important content - Rely only on navigation (provide search) - Change navigation frequently - Create ambiguous labels - Forget about edge cases - Ignore accessibility - Assume desktop-only navigation
© aj-geddes · MIT · aj-geddes/useful-ai-prompts
Similar skills
Everything for Design →information-architecture by other authors comes first.