Agent skill

Information Architecture

by rampstackco in rampstackco/claude-skills

Design the structure of a website or product including sitemap, navigation, URL structure, content types, taxonomy, and labeling.

MITAuto-check passedFrontend & Design

Install Information Architecture

skills CLI
$ npx skills add rampstackco/claude-skills --skill information-architecture -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install rampstackco/claude-skills information-architecture --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/rampstackco/claude-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/information-architecture .claude/skills/information-architecture && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
information-architecture
GitHub stars
940
Token cost
~2.6k tokens
SKILL.md length
1,214 words
Files
4 (incl. references)
Skills in repo
103
Repo updated
First seen
Licence
MIT

At a glance

Design the structure of a website or product including sitemap, navigation, URL structure, content types, taxonomy, and labeling.

  • Works in 6 steps: Mental models → Sitemap → URL structure → …
  • The user asks to plan a sitemap
  • SKILL.md covers When to use, When NOT to use, Required inputs and The framework: 6 layers, plus 5 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Information Architecture is an agent skill from rampstackco/claude-skills. 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…

Its SKILL.md is about 2.6k tokens, which your agent loads only when the skill is triggered. The skill folder holds 4 other files, including reference files (for example `README.md`, `references/ia-document-template.md` and `references/url-pattern-library.md`).

It sits in Frontend & Design, covering UX design and Search implementation. The repository describes itself as: Stack-agnostic Claude Skills covering the full website lifecycle: brand, design, content, SEO, dev, ops, growth, and research. Build, ship, audit, optimize. The licence is MIT.

When your agent uses it

  • The user asks to plan a sitemap
  • Design navigation
  • Define content types
  • Build taxonomies

Example prompts

  • “/information-architecture”

Workflow steps

6 steps, taken from the step headings in SKILL.md.

  1. Mental models
  2. Sitemap
  3. URL structure
  4. Navigation
  5. Taxonomy and metadata
  6. Labeling

What it can do on your machine

Read from SKILL.md and the folder at commit 482c9bf. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Information Architecture loads about 2.6k tokens when it runs, and up to ~6.5k if it reads all its reference files. Until then it costs about 173 tokens; SKILL.md has 1,214 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~173
When it runs · the whole SKILL.md, loaded when a task matches
~2.6k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~6.5k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from rampstackco/claude-skills at commit 482c9bf, republished under its MIT licence (© rampstackco). 1,214 words, ~2,614 tokens.

Download SKILL.mdSave it as .claude/skills/information-architecture/SKILL.md (or your agent's skills folder). This skill also uses 3 other files; get the full folder from GitHub.
name
information-architecture
description
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.
category
strategy-and-discovery
catalog_summary
Sitemap, navigation, URL structure, content types, taxonomy
display_order
4

Information Architecture

Design the structure that holds the content. Stack-agnostic. Applies to marketing sites, product surfaces, knowledge bases, e-commerce, and editorial content.

A well-designed IA makes the rest of the project easier. A poorly-designed IA forces every downstream decision to fight the structure.


When to use

  • Designing a new site or major section from scratch
  • Restructuring an existing site
  • Adding a new content type or category
  • Designing site navigation or menu systems
  • Defining URL structure and slug patterns
  • Building taxonomies or tag systems
  • Auditing an existing IA for problems

When NOT to use

  • Single-page design (use design-standards)
  • Content production (use content-and-copy)
  • SEO-driven content planning (use seo-keyword)
  • Initial brand and audience discovery (use brand-discovery)

Required inputs

  • The site or product scope
  • The audience and what they're trying to do
  • The content that exists or is planned
  • Any constraints (parent IA, regulatory, technical)

If audience is unclear, run brand-discovery first. If content scope is unclear, run content-strategy first.


The framework: 6 layers

Information architecture has six layers. Each builds on the one below.

1. Mental models

Before structure, understand how the audience thinks about the domain.

  • What concepts do they group together naturally?
  • What words do they use? (Often different from what the company uses.)
  • What is the dominant frame of reference? (By task? By role? By topic? By time?)
  • What do they expect to find where, based on conventions in similar products?

Methods:

  • Card sorting (open or closed): Give the audience the content items, ask them to group them. Open card sorts surface natural groupings. Closed card sorts validate proposed groupings.
  • Tree testing: Give a proposed structure, ask users to find specific items. Surfaces where the structure breaks down.
  • First-click testing: Given a goal, where do users click first? If first clicks are wrong, the labels and structure are wrong.
2. Sitemap

The map of all pages and how they relate.

Sitemap deliverables:

  • A hierarchy diagram showing parent-child relationships
  • Indication of page types (static, dynamic, listing, detail)
  • Cross-references showing how pages relate beyond the hierarchy
  • Sometimes a separate user-flow overlay for key journeys

Sitemap types:

  • Hub-and-spoke (cornerstone content + supporting content): Common for content marketing
  • Tree (strict hierarchy, every page has one parent): Common for product documentation
  • Faceted (content lives in many overlapping categories): Common for e-commerce
  • Flat (everything reachable from the home): Common for small sites

Most sites blend types. Pick the dominant pattern and document the exceptions.

3. URL structure

URLs are part of the IA. They are user-facing, indexed by search engines, and shape how content is referenced.

URL principles:

  • Reflect the content hierarchy
  • Lowercase, hyphen-separated
  • Predictable (same pattern across same content type)
  • Stable (URLs don't change without redirects)
  • Short (under 60 characters where possible)
  • Descriptive (slug indicates the content)
  • Free of dates unless time-bound
  • Free of session IDs and tracking parameters in canonical form

Common patterns:

/                                   home
/[section]                          section landing
/[section]/[subsection]             subsection landing
/[section]/[subsection]/[item]      detail page
/blog                               blog index
/blog/[slug]                        blog post
/blog/category/[category]           category index
/blog/tag/[tag]                     tag index
/products                           product catalog
/products/[category]                category page
/products/[category]/[product]      product detail

Pick a pattern and stick to it. Inconsistent URL patterns confuse users, crawlers, and analytics.

4. Navigation

The chrome that gets users where they need to go.

Primary navigation:

  • The top-level structure of the site
  • Should reflect what the audience cares about, not what the org chart looks like
  • 5 to 7 items maximum (more becomes cognitively heavy)
  • Each label is recognizable in 2 to 3 words
  • Order matters (left/first gets the most attention)

Secondary navigation:

  • Within-section navigation
  • Often shown as sidebars, sub-menus, or in-page tabs
  • Supports the primary nav, doesn't duplicate it

Utility navigation:

  • Account, search, login, support
  • Visually subordinate to primary nav
  • Often top-right (LTR languages)

Breadcrumbs:

  • For nested hierarchies (3+ levels deep)
  • Always linked except the current page
  • Match the URL hierarchy or the conceptual hierarchy
  • Marked up with BreadcrumbList schema

Footer navigation:

  • Comprehensive; sometimes includes everything
  • Organized by category for findability
  • Includes secondary content (privacy, terms, contact)
5. Taxonomy and metadata

The classification system applied to content.

Categories:

  • A small, controlled list (typically 5 to 15)
  • Mutually exclusive ideal (one item, one category)
  • Used for structural navigation

Tags:

  • A larger, often growing list (50+)
  • Multi-assignment (one item, many tags)
  • Used for cross-cutting connections, related-content, and long-tail discovery

Metadata fields:

  • Author, date, content type, audience segment
  • Whatever is useful for filtering, sorting, and surfacing

Common failures:

  • Categories that overlap (item could go in 3 different categories)
  • Tags that are unmaintained (sprawl into thousands, become useless)
  • Metadata fields that get filled inconsistently
  • Different content types using different taxonomies for the same thing (chaos)
Show full SKILL.md (491 more words)Show less
6. Labeling

What you call things.

Label principles:

  • Audience language, not internal language
  • Specific enough to be useful, short enough to scan
  • Consistent across the site (call it "Product" or "Solutions" but not both)
  • Tested with real users (closed card sort or tree test surfaces label problems)

Common label problems:

  • "Solutions" (vague; usually means "products with marketing copy")
  • "Resources" (catch-all; everything ends up there)
  • Internal jargon ("PRD," "OKRs") that doesn't match user vocabulary
  • Labels that change meaning across the site

Workflow

  1. Understand the audience and content. Use existing discovery and content strategy if available.
  2. Card sort or interview to surface mental models.
  3. Draft the sitemap. Hierarchy, page types, cross-references.
  4. Define URL patterns. One pattern per content type.
  5. Design navigation. Primary, secondary, utility, footer, breadcrumbs.
  6. Build taxonomy. Categories (controlled, small) and tags (open, large).
  7. Validate labels. Tree test or closed card sort with target users, or state the gap per the data-availability rule.
  8. Document. Use the template in references/ia-document-template.md.
  9. Hand off to design and development. IA decisions inform navigation components, URL routing, and taxonomy implementation.

Failure patterns

  • IA designed by org chart. "Engineering" and "Marketing" sections make sense to the company, not to the audience.
  • Categories that proliferate. Every team adds a category for their thing. Becomes unscannable. Hold the line at 5 to 15.
  • Tags that sprawl. No tag governance. Tags become a junk drawer.
  • Inconsistent URL patterns. Some posts at /blog/[slug], some at /[slug], some at /articles/[slug]. Pick one.
  • Navigation that hides primary content. The most important pages should be one click from home.
  • Search as a substitute for IA. "Just use search" is not a structure. Search supports IA, doesn't replace it.
  • No validation. Card sorts, tree tests, and first-click tests are cheap and surface huge problems early.
  • Treating IA as a one-time deliverable. IA evolves with content. Plan for evolution.

Output format

Default output is an IA document at information-architecture.md plus visual assets:

  1. Executive summary
  2. Audience and mental models (synthesized)
  3. Sitemap (hierarchical diagram)
  4. URL structure (per content type)
  5. Navigation specification (primary, secondary, utility, footer, breadcrumbs)
  6. Taxonomy (categories and tag governance)
  7. Labels (validated wording for navigation, categories, content types)
  8. Implementation notes for design and development

Visual deliverables:

  • Sitemap diagram (Whimsical, Figma, OmniGraffle, etc.)
  • Navigation wireframes for primary surfaces
  • Optional: card sort and tree test results

If required data is unavailable

This skill's output depends on data, measurements, or tool results it cannot generate on its own. When a required input, tool, or data source is unavailable or unverifiable, the sanctioned output is the deliverable with the gap stated: what was needed, what was actually obtained or verified, and which parts of the output are affected. Fabricating, estimating, or interpolating a required number to complete the deliverable is never sanctioned. A stated gap is a complete answer.


Reference files

© rampstackco, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 3 other files (references) in skills/information-architecture of rampstackco/claude-skills.

  • SKILL.md
  • README.md
  • references/ia-document-template.md
  • references/url-pattern-library.md

Open the folder on GitHubat commit 482c9bf

Compare with similar skills

Information Architecture next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Information Architecture compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Information Architecture this skillrampstackco/claude-skills940—~2.6kAutomated safety check: PassMIT
Impeccablebestofjs/bestofjs3.1k27 repos~2.6kAutomated safety check: PassMIT
Interface Design for Dashboards and Appsholaboss-ai/holaOS11k3 repos~6kAutomated safety check: PassMIT
Animategrowupanand/ConvoForm1016 repos~1.9kAutomated safety check: PassApache-2.0
Migrate Content Iadocker/docs4.7k—~5.1kAutomated safety check: PassApache-2.0
UX WalkthroughXiaoMi/hiui877—~1.3kAutomated safety check: PassMIT

Similar skills

  • Impeccable

    bestofjs/bestofjs

    A skill your agent uses when the user wants to design, redesign, shape, critique, audit, polish, clarify, distill, harden, optimize, adapt, animate, colorize, extract, or otherwise improve a…

    3.1k GitHub starsUsed in 27 repos~2.6k tokens
    Frontend & DesignAuto-check passed
  • Pushes an agent past generic defaults when designing dashboards, admin panels, SaaS apps and tools, with attention to structure, type, navigation and how data is shown.

    11k GitHub starsUsed in 3 repos~6k tokens
    Frontend & DesignAuto-check passed
  • Animate

    growupanand/ConvoForm

    Review a feature and enhance it with purposeful animations, micro-interactions, and motion effects that improve usability and delight.

    101 GitHub starsUsed in 6 repos~1.9k tokens
    Frontend & DesignAuto-check passed
  • Official

    Handle Hugo docs information-architecture moves: discover old vs new URLs, add front matter aliases (Phase 1), update in-repo links (Phase 2), interactive List 2 resolution and fragment validation…

    4.7k GitHub stars~5.1k tokensUpdated today
    Frontend & DesignAuto-check passed
  • UX Walkthrough

    XiaoMi/hiui

    体验走查 skill。适用于代码库、URL、截图三种输入,输出结构化体验问题报告,并同步生成本地 docx 报告。触发词:体验走查、UX review、交互走查、界面审查、体验问题。

    877 GitHub stars~1.3k tokensUpdated 2 mo ago
    Frontend & DesignAuto-check passed
  • Color Audit

    rome-os/rome

    Audit a design system's color palette against measurable color-science disciplines — WCAG/APCA contrast of declared token pairs, perceptual (OKLCH) ramp uniformity, color-blindness safety of…

    725 GitHub stars~2.7k tokensUpdated today
    Frontend & DesignAuto-check passed

More from rampstackco/claude-skills

All 103 skills in this repo
  • After Action Report

    rampstackco/claude-skills

    Run a structured after-action review (postmortem, retrospective) on a launch, incident, or completed project to capture timeline, root cause analysis, contributing factors, and actionable lessons.

    940 GitHub starsUsed in 1 repo~2.5k tokens
    Auto-check passed
  • Analytics Strategy

    rampstackco/claude-skills

    Design measurement frameworks including event taxonomy, KPI hierarchy, dashboard architecture, attribution models, and analytics implementation strategy.

    940 GitHub starsUsed in 1 repo~2.4k tokens
    Auto-check passed
  • Brand Style Guide

    rampstackco/claude-skills

    Build or audit a comprehensive brand style guide that documents the full brand system including story, logo system, color, typography, imagery, voice, applications, and dos/don'ts.

    940 GitHub stars~2.1k tokensUpdated yesterday
    Auto-check passed
  • Brand Voice

    rampstackco/claude-skills

    Develop or document a complete brand voice and tone system covering voice attributes, tone shifts by context, vocabulary preferences, grammar rules, and copy examples.

    940 GitHub stars~2.2k tokensUpdated yesterday
    Auto-check passed
  • Content And Copy

    rampstackco/claude-skills

    Write or edit website copy, blog content, and editorial pieces with attention to voice, structure, and goal.

    940 GitHub stars~2.1k tokensUpdated yesterday
    Auto-check passed
  • Content Strategy

    rampstackco/claude-skills

    Develop a content strategy covering editorial positioning, content pillars, formats, calendar, governance, and topical authority planning.

    940 GitHub stars~2.6k tokensUpdated yesterday
    Auto-check passed

Questions about Information Architecture

What does Information Architecture do?

Design the structure of a website or product including sitemap, navigation, URL structure, content types, taxonomy, and labeling. Information Architecture is an agent skill from rampstackco/claude-skills. Design the structure of a website or product including sitemap, navigation, URL structure, content types, taxonomy, and labeling.

When should I use Information Architecture?

Information Architecture fits situations like: the user asks to plan a sitemap; design navigation; define content types; build taxonomies.

How do I install Information Architecture in Claude Code?

Run `npx skills add rampstackco/claude-skills --skill information-architecture -a claude-code`. Or copy the skill folder (skills/information-architecture in rampstackco/claude-skills) into .claude/skills/information-architecture in your project. Claude Code loads it when a task matches its description.

How do I install Information Architecture in Codex?

Run `npx skills add rampstackco/claude-skills --skill information-architecture -a codex`. Or copy the skill folder (skills/information-architecture in rampstackco/claude-skills) into .agents/skills/information-architecture in your project. Codex loads it when a task matches its description.

Can I use Information Architecture in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add rampstackco/claude-skills --skill information-architecture -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/information-architecture, .gemini/skills/information-architecture, .github/skills/information-architecture and .opencode/skills/information-architecture in your project.

What does Information Architecture need to run?

SKILL.md names no scripts, command-line tools or credentials: Information Architecture is instructions for the agent only.

Does Information Architecture access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Information Architecture safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Information Architecture use?

Information Architecture is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Information Architecture use?

About 2.6k tokens (SKILL.md is roughly 10k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 3.9k tokens, read only when the agent opens those files.

What are the alternatives to Information Architecture?

Skills that share tags, products or a category with Information Architecture: Impeccable (bestofjs/bestofjs, 3.1k stars), Interface Design for Dashboards and Apps (holaboss-ai/holaOS, 11k stars), Animate (growupanand/ConvoForm, 101 stars) and Migrate Content Ia (docker/docs, 4.7k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Information Architecture?

rampstackco (a GitHub organization) maintains it in rampstackco/claude-skills, which has 940 GitHub stars. The repository holds 103 skills in this directory. The repository was last updated on October 7, 2026.

Source: rampstackco/claude-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.