ghaida/intent/organize

Claude Code and agent skill by ghaida/intent

Trust tier 2
  • community
Source check pending

Checking that the SKILL.md file is still in the repository.

Structure information so people can find what they need, understand where they are, and navigate confidently. Covers navigation pattern design, taxonomy, labeling systems, search and browse strategy, wayfinding, and IA research methods. Trigger when designing navigation structures, categorization schemes, site maps, taxonomies, labeling systems, search experiences, or asking "how should we organize this?" Also trigger for card sorting, tree testing, information findability problems, or when users report they can't find things. Use this skill any time the structural organization of information is the problem — not the flow through it, not the words in it, not the visual presentation of it.

Install

npx vskill@latest install ghaida/intent/organize

SKILL.md

Organize

Overview

Information architecture is the structural design of shared information environments. It determines whether users can find what they need, understand where they are, and navigate confidently. Good IA is invisible — users just "get it." Bad IA makes everything harder: more support tickets, more bounce, more confusion, more time wasted.

IA is not navigation design (that's one output of IA). It's not content strategy (that's what fills the structure). It's not visual design (that's how the structure looks). IA is the underlying organization — the categories, hierarchies, relationships, and labels that make a product's information findable and understandable.

Trigger this skill when users ask about:

  • Designing or restructuring navigation (top-level, secondary, contextual)
  • Organizing content into categories, sections, or taxonomies
  • Site maps, content inventories, or structural audits
  • Labeling and naming conventions for navigation, categories, or features
  • Search strategy, filtering, or browse experiences
  • Users reporting they "can't find things" or feel lost
  • Card sorting, tree testing, or other IA research
  • "How should we organize this?" or "Where should this live?"
  • Merging or restructuring product areas after growth or acquisition

Skill family

You work alongside complementary skills that handle interconnected concerns:

  • `/strategize` — Their audience definition and solution fit inform your IA decisions. Who are you organizing for, and how do they think? Their five foundational questions tell you whether the product's scope is stable enough to build a lasting structure, or likely to shift.
  • `/investigate` — Card sorts, tree tests, and user interviews reveal how users actually categorize and find information. Without their research, your IA is based on internal assumptions about how people think — and those assumptions are almost always wrong.
  • `/journey` — Your IA provides the structure their flows navigate through. They design the sequence of steps; you design the space those steps move through. When a flow keeps hitting dead ends, the problem is often structural, not sequential.
  • `/wireframe` — Places your structure on actual screens. You decide the taxonomy, navigation model, and labels; they decide where those structures sit on each screen and how prominent they are. If users can't find things, that's yours; if the structure is sound but the screen is illegible, that's theirs.
  • `/articulate` — Labels are where IA and content strategy meet. Clarity of naming is critical — a perfectly structured taxonomy with unclear labels fails just as badly as a flat dump of clearly named items. Collaborate closely on naming decisions.
  • `/blueprint` — System architecture constrains and enables IA possibilities. The data model, API structure, and content management system determine what organizational structures are technically feasible. A beautiful taxonomy that the CMS can't represent is useless.
  • `/evaluate` — Tests whether users can actually find things in your structure. Their heuristic evaluation catches IA problems that tree tests miss — inconsistent patterns, misleading groupings, orphaned content.
  • `/localize` — IA decisions that work in one language or culture may fail in another. Category boundaries, label meanings, and navigation conventions vary across markets.
  • `/philosopher` — A cross-cutting cognitive mode for when categories feel natural but users keep getting lost. Enter when: the structure mirrors the org chart instead of user mental models, inherited IA assumptions need questioning, or you suspect the categorization scheme itself is the problem. The philosopher helps you ask whether the organizing principle is right, not just whether the organization is tidy.

Collaborate explicitly with each when their domain matters. What is left to another discipline goes in the decision log, or is said in conversation as a next step.

Visualization

When the user invokes /organize, decide whether the deliverable should include a site map / IA diagram, and if so, in what format. Ask the user up front — before producing the markdown deliverable.

Ask first

Open the response with this question, with HTML as the default:

Would you like a visualization of this IA?
- HTML (default) — self-contained code block, opens in any browser
- Figma — created in your Figma file via MCP
- pencil — created in pencil.dev via MCP
- No — markdown only

Skip the question if the request already states a preference — "with a diagram", "with figma", "in pencil", "no diagram", "html only" all preempt the prompt. Default to HTML if the user says yes without naming a format.

HTML output

Write one self-contained HTML file to the working directory, or where the user says (sitemap-<topic>.html), and open it. No external CSS, no external fonts, no JS. Always include the full token block + per-pattern CSS below in an inline <style> tag.

Required style block — paste verbatim into <style>:

css
:root {
--bg: #fafafc; --surface: #ffffff; --fg: #18182b; --fg-muted: #65657a;
--border: #d8d8e4; --accent: #4338ca;
--sans: "Hanken Grotesk", Inter, system-ui, -apple-system, sans-serif;
--mono: ui-monospace, "SF Mono", Menlo, monospace;
--s1: 4px; --s2: 8px; --s3: 12px; --s4: 16px;
--s5: 20px; --s6: 24px; --s7: 32px; --s8: 48px;
}
@media (prefers-color-scheme: dark) {
:root:not([data-theme="light"]) {
--bg: #18182b; --surface: #1f1f36; --fg: #f0f0f8; --fg-muted: #8888a8;
--border: #2a2a44; --accent: #7c6ff0;
}
}
:root[data-theme="dark"] {
--bg: #18182b; --surface: #1f1f36; --fg: #f0f0f8; --fg-muted: #8888a8;
--border: #2a2a44; --accent: #7c6ff0;
}
* { box-sizing: border-box; }
body {
font-family: var(--sans); background: var(--bg); color: var(--fg);
padding: var(--s7); line-height: 1.5; margin: 0;
}
.visual-diagram {
margin: 0; padding: var(--s5);
background: var(--surface); border-radius: 8px;
border: 1px solid var(--border); overflow-x: auto;
}
.visual-label {
font-family: var(--mono); font-size: 10px; font-weight: 600;
color: var(--fg-muted); letter-spacing: 0.06em;
margin-bottom: var(--s4); text-transform: uppercase;
}
.sitemap-tabbar {
display: flex; align-items: center; justify-content: space-around;
padding: var(--s2) var(--s3);
background: var(--bg); border: 1px solid var(--border);
border-radius: 8px; margin-bottom: var(--s4);
}
.sitemap-tab {
display: flex; flex-direction: column; align-items: center;
gap: 2px; font-size: 10px; color: var(--fg-muted);
padding: var(--s1) var(--s2);
}
.sitemap-tab svg { color: var(--fg-muted); }
.sitemap-tab-active { color: var(--accent); }
.sitemap-tab-active svg { color: var(--accent); }
.sitemap-tab-post {
background: var(--accent); border-radius: 50%;
width: 32px; height: 32px;
display: flex; align-items: center; justify-content: center; padding: 0;
}
.sitemap-tab-post svg { color: white; }
.sitemap-tree { padding: var(--s2) 0; }
.sitemap-root { margin-bottom: var(--s3); }
.sitemap-root .sitemap-node-label {
font-family: var(--mono); font-size: 11px; font-weight: 700; color: var(--fg);
}
.sitemap-branches { display: flex; gap: var(--s2); flex-wrap: wrap; }
.sitemap-branch { flex: 1; min-width: 85px; }
.sitemap-node {
padding: var(--s2); background: var(--bg);
border: 1px solid var(--border); border-radius: 4px;
font-size: 11px; font-weight: 600; color: var(--fg);
margin-bottom: var(--s2);
display: flex; align-items: center; gap: var(--s1);
}
.sitemap-node-primary { border-color: var(--accent); border-width: 2px; }
.sitemap-node-action {
background: var(--accent); color: white; border-color: var(--accent);
}
.sitemap-node-tag {
font-family: var(--mono); font-size: 9px;
color: var(--fg-muted); font-weight: 400; margin-left: auto;
}
.sitemap-node-action .sitemap-node-tag { color: rgba(255,255,255,0.7); }
.sitemap-children {
padding-left: var(--s3); border-left: 1px dashed var(--border);
}
.sitemap-leaf {
font-size: 10.5px; color: var(--fg-muted);
padding: 2px 0; line-height: 1.4;
}

Structure template — fill with the real IA:

html
<div class="visual-diagram">
<div class="visual-label">Information Architecture: [PRODUCT NAME]</div>
<!-- Optional tab bar mockup (skip if the IA isn't a tabbed mobile shell). -->
<div class="sitemap-tabbar">
<div class="sitemap-tab sitemap-tab-active">
<svg width="16" height="16" viewBox="0 0 24 24" fill="none"
stroke="currentColor" stroke-width="2" stroke-linecap="round"
stroke-linejoin="round"><!-- icon path --></svg>
<span>[TAB 1 — ACTIVE]</span>
</div>
<div class="sitemap-tab">
<svg ...><!-- icon --></svg>
<span>[TAB 2]</span>
</div>
<!-- Centered accent action tab (e.g., Post, Pay, +) — round indigo button -->
<div class="sitemap-tab sitemap-tab-post">
<svg width="20" height="20" viewBox="0 0 24 24" fill="none"
stroke="currentColor" stroke-width="2.5" stroke-linecap="round"
stroke-linejoin="round">
<line x1="12" y1="5" x2="12" y2="19"/>
<line x1="5" y1="12" x2="19" y2="12"/>
</svg>
</div>
<div class="sitemap-tab">
<svg ...><!-- icon --></svg>
<span>[TAB 4]</span>
</div>
<div class="sitemap-tab">
<svg ...><!-- icon --></svg>
<span>[TAB 5]</span>
</div>
</div>
<!-- Site map tree -->
<div class="sitemap-tree">
<div class="sitemap-root">
<span class="sitemap-node-label">[PRODUCT]</span>
</div>
<div class="sitemap-branches">
<!-- Primary / default branch — accent 2px border, "default" tag -->
<div class="sitemap-branch">
<div class="sitemap-node sitemap-node-primary">
<span>[SECTION]</span>
<span class="sitemap-node-tag">default</span>
</div>
<div class="sitemap-children">
<div class="sitemap-leaf">[CHILD SCREEN]</div>
<div class="sitemap-leaf">[CHILD SCREEN]</div>
<!-- 2–4 leaves per branch -->
</div>
</div>
<!-- Default branch -->
<div class="sitemap-branch">
<div class="sitemap-node">
<span>[SECTION]</span>
<span class="sitemap-node-tag">toggle</span>
</div>
<div class="sitemap-children">
<div class="sitemap-leaf">[CHILD]</div>
</div>
</div>
<!-- Action branch — solid accent fill, white text -->
<div class="sitemap-branch">
<div class="sitemap-node sitemap-node-action">
<span>[ACTION] (+)</span>
</div>
<div class="sitemap-children">
<div class="sitemap-leaf">[CHILD]</div>
</div>
</div>
</div>
</div>
</div>

Rules:

This is the start of the file. Read the full SKILL.md on GitHub.

Security

  • Security scanPassed, 100 of 100Pattern checks on the skill's files.
  • Model reviewPassed

Quality evaluation

  • Task evaluationNot runNo evaluation yet. Run one in Skill Studio.

Source

Popularity

Repository stars
97
Repository forks
8
7-day trend score
23

Stars and forks are for the whole GitHub repository, not this skill alone. Refreshed 26 May 2026, 5 months ago.

Works with

Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.

  • Claude Code
  • Cursor
  • GitHub Copilot
  • Windsurf
  • Codex
  • Gemini CLI
  • Cline
  • Amp
  • Roo Code
  • Goose
  • Continue
  • Kilo Code
  • Junie
  • Trae
  • OpenHands
  • Qwen Code
  • AI Agent
  • Tabnine Chat
  • Sourcegraph Cody
  • Amazon Q
  • Firebase Genkit
  • Sweep
  • Devin
  • Phind
  • Mentat
  • Claude Desktop
  • Aider
  • GPT Pilot
  • Plandex
  • bolt.new
  • v0
  • Replit Agent
  • Anse
  • TypingMind
  • BetterChatGPT
  • LibreChat
  • Warp AI
  • Pieces
  • Fig AI
Embed badge
vskill VERIFIED badge
[![vskill VERIFIED](https://verified-skill.com/api/v1/skills/ghaida/intent/organize/badge)](https://verified-skill.com/skills/ghaida/intent/organize)

Something wrong with this skill or its page? Tell us.