Installation
$npx skills add irismaker/ai-agent-skills-hub --skill website-structureSummary
The agent can map pages needed for a website (new or existing), prioritize them for development, and align structure to growth strategy and UX goals. Invoke when the user asks about site planning, which pages to build, page priority, or how structure supports SEO and conversion.
SKILL.MD
Strategy: Website Structure
Guides website structure planning: which pages to build, page priority, and how structure supports UX, SEO, and growth. Structure is the organization and connection of pages; it affects user navigation, Google's understanding of content importance, crawlability, and sitelinks in SERPs. See serp-features for sitelinks and SERP optimization.
When invoking: On first use, if helpful, open with 1–2 sentences on what this skill covers and why it matters, then provide the main output. On subsequent use or when the user asks to skip, go directly to the main output.
Initial Assessment
Check for product marketing context first: If .claude/product-marketing-context.md or .cursor/product-marketing-context.md exists, read it for product type, audience, and growth goals.
Identify:
- Website type: Product/SaaS, B2B, E-commerce, Portfolio, Forum, Directory
- Stage: New site (plan from scratch) vs. existing (extend or audit)
- Growth strategy: Affiliate, education, multi-language, community, B2B, developer
- Constraints: Team size, budget, tech stack
Page Priority Framework
Plan pages by priority for development scheduling. See page-taxonomy for full page types and website-type mapping.
| Priority | Pages | Notes |
|---|---|---|
| Must Have | Home, Product/Features, Pricing, Blog, About, Privacy, Terms, Contact | Essential for trust and conversion |
| Great to Have | Testimonials, FAQ, Sitemap (HTML), 404, Refund/Returns | Support UX and SEO |
| Optional | Search Results, News, Careers, Disclosure | Situational |
| Traffic-driven | Category/Collection pages | For content-heavy or e-commerce; needs Category + Tags |
Generic Template Structure
Applicable to SaaS, tools, and content sites. Adapt by removing unused nodes (e.g. no API → drop API) and adding specific modules (e.g. industry, region).
| Section | Typical Paths | Page Skills |
|---|---|---|
| Root | /, /features, /pricing, /demo, /contact | homepage-generator, features-page-generator, pricing-page-generator |
| Resources | /blog, /changelog, /glossary, /faq, /tutorials | blog-page-generator, changelog-page-generator, glossary-page-generator, faq-page-generator |
| Partnership | /affiliate, /startups, /ambassadors | affiliate-page-generator, landing-page-generator |
| Legal | /terms, /privacy, /careers | terms-page-generator, privacy-page-generator, careers-page-generator |
| Competitor | /alternatives, /compare, /migrate | alternatives-page-generator, migration-page-generator |
| Standalone | /dashboard, /login, /docs, /api, /status, /support | docs-page-generator, api-page-generator, status-page-generator |
Growth Strategy → Structure Mapping
Structure reflects growth strategy. Subdirectories signal channels:
| Goal | Path Example | Page/Channel |
|---|---|---|
| Affiliate conversion | /affiliate | affiliate-page-generator |
| Education/student plan | /education, /startups | startups-page-generator |
| Multi-language | /zh-CN, /ja | localization-strategy |
| Community | /ambassadors, /showcase | creator-program, landing-page-generator |
| B2B / Enterprise | Customer stories, Use cases, Solutions | use-cases-page-generator, solutions-page-generator, customer-stories-page-generator |
| Developer product | /api, /docs, /status | api-page-generator, docs-page-generator, status-page-generator |
| User feedback | Feedback, Roadmap | feedback-page-generator; External (Canny, FeatureBase) |
| Plugins/Integrations | /integrations, /plugins | integrations-page-generator, category-page-generator |
| Giveaway/Contest | /giveaway | contest-page-generator |
Planning Workflow
- Choose template: Start from generic structure; map to page-taxonomy website types
- Trim modules: Remove irrelevant nodes (e.g. no API → drop /api, /docs)
- Add specifics: Industry pages, region, product variants
- Assign URLs: Per node; follow url-structure (lowercase, hyphens, short, keyword-rich)
- Export list: "Page type + URL + Priority" for dev scheduling
- Tech stack: Match page types to services (DNS, auth, CMS, status page, etc.)
- Iterate: Expand with new features, markets; keep structure clear
Structure Principles
| Principle | Guideline |
|---|---|
| Flat structure | Max 4 clicks from homepage to any page; improves crawlability and weight distribution |
| Early planning | Plan structure before growth; can start right after domain purchase |
| Sitelinks | Good structure + TOC + authoritative internal links → natural sitelinks in SERP (cannot be forced via schema); see serp-features |
| Orphan prevention | Every page needs internal links; see site-crawlability and internal-links |
Homepage Module Reference
Common modules to combine: Headline, Subheadline, Primary CTA, Supporting Image/Demo, Benefits Section, Social Proof, Search Box (if applicable), Secondary CTA, Banner. Navigation: Horizontal Bar, Dropdown, Hamburger (mobile), Sidebar, Footer; ensure Desktop + Mobile parity. See homepage-generator and hero-generator.
Output Format
- Page list with priority (Must Have / Great to Have / Optional)
- URL structure (paths per section)
- Website-type fit (which pages apply per page-taxonomy)
- Growth mapping (which paths support which channels)
- Next steps: url-structure for URL rules; xml-sitemap for submission; site-crawlability for audit
References
- Website structure SEO guide — Alignify: structure importance, page priority, generic template, planning workflow, growth mapping, homepage modules
Related Skills
- seo-strategy: SEO workflow order, prioritization; structure planning fits before Technical phase
- page-taxonomy: Full page types, website-type matrix, core vs extended; use for page selection
- url-structure: URL optimization, hierarchy, slugs; apply after structure is defined
- site-crawlability: Crawlability, orphan pages, redirects; audit existing structure
- internal-links: Link strategy, hub-spoke; implement after pages exist
- xml-sitemap: Sitemap creation; include planned URLs
- breadcrumb-generator: Breadcrumb for hierarchy; large sites, e-commerce
- navigation-menu-generator: Nav design; primary, footer, mobile
- category-page-generator: Category/hub pages; content-heavy, e-commerce
- content-strategy: Content clusters, pillar pages; complements structure planning
- homepage-generator: Homepage structure and modules
- localization-strategy: Multi-language structure; subdomain vs subfolder