website-structure
When the user wants to plan website structure, decide which pages to build, or prioritize pages for a new or existing site. Also use when the user mentions "website structure," "site structure," "which pages do I need," "page planning," "sitemap planning," "Must Have pages," "website architecture," or "site hierarchy." For a specific page template (e.g. homepage), use homepage-generator or landing-page-generator as appropriate. Not for organic SEO roadmap alone; use seo-strategy.
- Installs
- 1.3K
- Last 24h
- —
- Trending rank
- —
- Security
- Not audited
Install
Works with every agent the skills CLI supports.
npx skills add https://github.com/kostja94/marketing-skills --skill website-structure- 01
Install
Run the command in your project. The CLI asks which agents to install for.
- 02
Describe the task
Ask your agent for something this skill covers. It loads website-structure automatically when relevant.
- 03
Review the result
The agent follows the SKILL.md steps, scripts and references bundled with the skill.
SKILL.md
The instructions your agent reads when the skill is triggered.
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
Project context: Read root contextus.md when present and load only the modules relevant to this task. Without Contextus, use available project material or user-provided facts and ask for missing information; do not create a parallel context system.
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 skills-reference §2 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; Pricing: public page in nav for self-serve; enterprise-only may use "Contact sales" instead; see pricing-page-generator (Visibility & Placement) |
| 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 |
| Tools | /tools, /free-tools; hub + per-tool pages | tools-page-generator; free tools for lead gen; often SPA; programmatic; see programmatic-seo |
| 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, /signup, /docs, /api, /status, /support | signup-login-page-generator, 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, /student-discount | education-program, startups-page-generator |
| Multi-language | /zh-CN, /ja | localization-strategy |
| Community | /ambassadors, /showcase | creator-program, landing-page-generator |
| B2B / Enterprise | Solutions (industry-first), Use cases (scenario-first; can be sub-pages), Customer stories | solutions-page-generator, use-cases-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 |
Domain Structure (Multiple Products)
When planning for multiple products or brands, see domain-architecture for subfolder vs subdomain vs independent domain. This skill covers page structure within a single domain. For initial domain choice (Brand vs PMD vs EMD, TLD), see domain-selection.
Planning Workflow
- Choose template: Start from generic structure; map to skills-reference §2 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 |
| Features vs Use cases | /features = capability-first; /use-cases = scenario-first; differentiate content angle, link between, avoid overlap; see features-page-generator, use-cases-page-generator |
| Clear navigation | Clear hierarchy and nav improve task completion; users find what they need faster; see navigation-menu-generator |
| Pricing placement | Marketing site: /pricing in main nav for prospects; in-app: Settings → Billing in sidebar for logged-in users (subscription management). Enterprise-only: "Contact sales" may replace public pricing page; see pricing-page-generator |
Homepage Module Reference
See homepage-generator for common modules (Headline, Subheadline, CTA, Benefits, Social Proof, etc.), navigation options, and hero-generator for hero design.
Output Format
- Page list with priority (Must Have / Great to Have / Optional)
- URL structure (paths per section)
- Website-type fit (which pages apply per skills-reference §2)
- 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
- skills-reference §2 (docs/skills-reference.md#2-page-taxonomy) — Full page types, website-type matrix, core vs extended; use for page selection
Related Skills
- seo-strategy: SEO workflow order; structure planning fits before Technical phase
- domain-selection: Initial domain choice; do before structure when choosing domain
- domain-architecture: Subfolder vs subdomain vs independent; do before structure if domain decision pending
- 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
- content-strategy: Content clusters, pillar pages; complements structure planning
FAQ
What does the website-structure skill do?
When the user wants to plan website structure, decide which pages to build, or prioritize pages for a new or existing site. Also use when the user mentions "website structure," "site structure," "which pages do I need," "page planning," "sitemap planning," "Must Have pages," "website architecture," or "site hierarchy." For a specific page template (e.g. homepage), use homepage-generator or landing-page-generator as appropriate. Not for organic SEO roadmap alone; use seo-strategy.
How do I install website-structure?
Run npx skills add https://github.com/kostja94/marketing-skills --skill website-structure in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/website-structure/ (personal) or .claude/skills/website-structure/ (project).
Which AI agents can use website-structure?
Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.
Is website-structure safe to install?
No partner security audit is available yet. Skills can run commands and scripts, so read the SKILL.md and any bundled files before installing.
Who maintains website-structure?
It is published by kostja94 in kostja94/marketing-skills. It has 1,301 recorded installs.
More from kostja94/marketing-skills
copywriting
kostja94/marketing-skills
When the user wants to write or optimize short-form marketing copy—headlines, CTAs, ad copy, landing page copy, email copy. Also use when the user mentions "copywriting," "headline," "CTA copy," "ad copy," "landing page copy," "sales copy," "conversion copy," "PAS," "AIDA," "BAB," "copy formula," or "differentiation." For long-form article bodies (blog posts, guides), use article-content.
linkedin-posts
kostja94/marketing-skills
When the user wants to create LinkedIn post copy or optimize for LinkedIn. Also use when the user mentions "LinkedIn post," "LinkedIn article," "professional post," "post to LinkedIn," "LinkedIn content," "LinkedIn copy," "B2B LinkedIn," "LinkedIn engagement," "LinkedIn feed," "share box," "document post," "poll," "Newsletter," "reshare," or "LinkedIn marketing." For LinkedIn ads, use linkedin-ads.
youtube-seo
kostja94/marketing-skills
When the user wants to optimize YouTube videos for search, create video descriptions, or improve channel visibility. Also use when the user mentions "YouTube SEO," "YouTube description," "YouTube tags," "YouTube thumbnail," "YouTube title," "YouTube channel," or "video SEO." For YouTube ads, use youtube-ads.
video-marketing
kostja94/marketing-skills
When the user wants to plan video marketing, create video scripts, or optimize for short-form or long-form video. Also use when the user mentions "video marketing," "video script," "short-form video," "long-form video," "TikTok script," "Reels script," "YouTube script," "video hook," or "video content strategy." For on-site video SEO, use video-optimization.
tiktok-captions
kostja94/marketing-skills
When the user wants to create TikTok video captions, scripts, or optimize for TikTok. Also use when the user mentions "TikTok post," "TikTok caption," "TikTok video," "post to TikTok," "TikTok script," "TikTok content," "TikTok copy," "TikTok hashtags," or "TikTok marketing." For TikTok ads, use tiktok-ads.
local-seo
kostja94/marketing-skills
When the user wants to optimize for local search, set up Google Business Profile, or build local citations. Also use when the user mentions "local SEO," "Google Business Profile," "Google Maps," "NAP," "citations," "local search," "local business," or "service area." For location pages, use programmatic-seo.
Popular code quality & workflow skills
grill-me
mattpocock/skills
A relentless interview to sharpen a plan or design.
improve-codebase-architecture
mattpocock/skills
Scan a codebase for deepening opportunities, present them as a visual HTML report, then grill through whichever one you pick.
handoff
mattpocock/skills
Compact the current conversation into a handoff document for another agent to pick up.
domain-modeling
mattpocock/skills
Build and sharpen a project's domain model. Use when discussing codebase terminology, writing or editing a GLOSSARY.md, or recording or editing an ADR.
codebase-design
mattpocock/skills
Shared vocabulary for designing deep modules. Use when the user wants to design or improve a module's interface, find deepening opportunities, decide where a seam goes, make code more testable or AI-navigable, or when another skill needs the deep-module vocabulary.
diagnosing-bugs
mattpocock/skills
Diagnosis loop for hard bugs and performance regressions. Use when the user says "diagnose"/"debug this", or reports something broken/throwing/failing/slow.