[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7DYGWT3XP55V6CSPGM47XCM":3,"skill-same:01M7DYGWT3XP55V6CSPGM47XCM":54},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":24,"commitSha":25,"skillDirectory":26,"forksCount":27,"repositoryHtmlUrl":28,"repositoryHomepageUrl":29,"ownerHtmlUrl":30,"ownerBlogUrl":31,"ownerDescription":32,"updatedAt":33,"install":34,"resources":47},"01M7DYGWT3XP55V6CSPGM47XCM","site-architecture",null,"Use when planning or restructuring what pages a site has and how they connect: hierarchy, navigation, URL patterns, breadcrumbs, and internal linking. Not for XML sitemaps, which are in seo-audit.","vercel\u002Feve","vercel","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F14985020?v=4","01M75TEEHHNJR9E6CG84ENB3MS","Vercel","01M75TEEJ5BJVTCPRH9YAWSMW4",5902,"Apache-2.0","https:\u002F\u002Fgithub.com\u002Fvercel\u002Feve\u002Fblob\u002Fmain\u002Fapps\u002Ftemplates\u002Fmarketing-team-eve-template\u002Fagent\u002Fsubagents\u002Fseo\u002Fskills\u002Fsite-architecture\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\ndescription: \"Use when planning or restructuring what pages a site has and how they connect: hierarchy, navigation, URL patterns, breadcrumbs, and internal linking. Not for XML sitemaps, which are in seo-audit.\"\n---\n\n# Site architecture\n\nArchitecture is one decision repeated: how does someone get from the homepage to the page that answers their question, and how does a crawler follow the same path. Depth, navigation, URLs, and internal links are four views of that one structure, so change them together or they drift.\n\n## Depth\n\nAim to put any page that matters within three clicks of the homepage. It isn't a law, but a critical page four or more levels down is a symptom worth chasing.\n\n| Shape              | Fits                        | Costs                                            |\n| ------------------ | --------------------------- | ------------------------------------------------ |\n| Flat, 2 levels     | Small sites, portfolios     | Stops scaling once a nav item has 20 children    |\n| Moderate, 3 levels | Most SaaS and content sites | Usually the right answer                         |\n| Deep, 4 or more    | Large catalogs, big docs    | Scales, but buries things without strong linking |\n\nGo as flat as the navigation tolerates. When a dropdown passes roughly 20 items, that's the signal to add a level rather than keep the list flat.\n\nLevels: L0 is the homepage, L1 is a primary section (`\u002Ffeatures`, `\u002Fblog`), L2 is a page within it (`\u002Ffeatures\u002Fanalytics`), L3 and beyond are detail pages (`\u002Fdocs\u002Fapi\u002Fauthentication`).\n\n## Site types as starting points\n\n| Type              | Depth  | Sections                             | URL shape                               |\n| ----------------- | ------ | ------------------------------------ | --------------------------------------- |\n| SaaS marketing    | 2 to 3 | Home, Features, Pricing, Blog, Docs  | `\u002Ffeatures\u002F{name}`, `\u002Fblog\u002F{slug}`      |\n| Content site      | 2 to 3 | Home, Blog, Categories, About        | `\u002Fblog\u002F{slug}`, `\u002Fblog\u002Fcategory\u002F{slug}` |\n| Ecommerce         | 3 to 4 | Home, Categories, Products           | `\u002F{category}\u002F{subcategory}\u002F{product}`   |\n| Documentation     | 3 to 4 | Home, Guides, Reference              | `\u002Fdocs\u002F{section}\u002F{page}`                |\n| SaaS plus content | 3 to 4 | Home, Product, Blog, Resources, Docs | `\u002Fproduct\u002F{feature}`, `\u002Fblog\u002F{slug}`    |\n| Small business    | 1 to 2 | Home, Services, About, Contact       | `\u002Fservices\u002F{name}`                      |\n\n## URLs\n\nReadable, lowercase, hyphenated, mirroring the hierarchy, with one trailing-slash policy enforced everywhere. Short but still descriptive: `\u002Fblog\u002Flanding-page-conversions` beats `\u002Fblog\u002Fhow-to-improve-your-landing-page-conversion-rates`.\n\nThe mistakes that cost the most:\n\n- Dates in blog URLs. `\u002Fblog\u002F2026\u002F07\u002F25\u002Ftitle` adds nothing and ages the post visibly.\n- IDs or query strings carrying content. `\u002Fproduct\u002F12345` and `\u002Fblog?id=123` should be slugs.\n- Over-nesting past what the hierarchy needs.\n- Mixing parents for the same kind of page, like `\u002Ffeatures\u002Fanalytics` alongside `\u002Fproduct\u002Fautomation`.\n- Changing a URL without a 301. Every old URL needs one, or the links pointing at it stop counting and anyone who bookmarked it gets a 404. This is the single most common cause of traffic loss after a redesign.\n\n`references\u002Fpatterns.md` has the URL pattern per page type, navigation layouts, and the diagram formats to hand back.\n\n## Navigation\n\nPrimary navigation holds 4 to 7 items, ordered by importance, with the logo linking home and the call to action rightmost. Past 7, people stop reading the list and start hunting.\n\nFooters group into columns: product, resources, company, legal. Sidebars carry within-section navigation for docs and long content. Breadcrumbs mirror the URL path exactly, with every segment linked except the current page, and they pair with `BreadcrumbList` schema.\n\nBreadcrumbs are the cheapest structural win available: they add internal links on every page, they make hierarchy legible to a crawler, and they can earn a richer result.\n\n## Internal linking\n\n- No orphans. Every page needs at least one internal link pointing at it, and the sitemap is not a link.\n- Anchor text describes the destination. Never \"click here\" or \"read more\".\n- How many contextual links a single page carries is a decision for whoever owns that page's format, so recommend the connections worth making rather than a density target.\n- Link the pages that matter more often. Inbound internal links are how you tell a crawler what's important.\n- Hub and spoke for content clusters: one comprehensive hub, spokes covering sub-topics, each spoke linking back to the hub, the hub linking to all spokes, and spokes cross-linking where a reader would actually want it.\n\nHub and spoke is what makes a set of posts add up to more than its pages, because it concentrates the signal on the hub rather than spreading it across a dozen equal posts competing with each other.\n\n## What to hand back\n\nAn ASCII tree of the hierarchy with the URL at each node, a URL map table (page, URL, parent, where it appears in navigation, priority), the redirect list when anything moves, and a Mermaid diagram when the structure is worth seeing rather than reading. `references\u002Fpatterns.md` has the formats.\n\n## Sources\n\n- Google Search Central, URL structure best practices: https:\u002F\u002Fdevelopers.google.com\u002Fsearch\u002Fdocs\u002Fcrawling-indexing\u002Furl-structure\n- Google Search Central, Redirects and Google Search: https:\u002F\u002Fdevelopers.google.com\u002Fsearch\u002Fdocs\u002Fcrawling-indexing\u002F301-redirects\n- Google Search Central, Breadcrumb structured data: https:\u002F\u002Fdevelopers.google.com\u002Fsearch\u002Fdocs\u002Fappearance\u002Fstructured-data\u002Fbreadcrumb\n- Nielsen Norman Group, Flat vs deep website hierarchies: https:\u002F\u002Fwww.nngroup.com\u002Farticles\u002Fflat-vs-deep-hierarchy\u002F\n","# Site architecture\n\nArchitecture is one decision repeated: how does someone get from the homepage to the page that answers their question, and how does a crawler follow the same path. Depth, navigation, URLs, and internal links are four views of that one structure, so change them together or they drift.\n\n## Depth\n\nAim to put any page that matters within three clicks of the homepage. It isn't a law, but a critical page four or more levels down is a symptom worth chasing.\n\n| Shape              | Fits                        | Costs                                            |\n| ------------------ | --------------------------- | ------------------------------------------------ |\n| Flat, 2 levels     | Small sites, portfolios     | Stops scaling once a nav item has 20 children    |\n| Moderate, 3 levels | Most SaaS and content sites | Usually the right answer                         |\n| Deep, 4 or more    | Large catalogs, big docs    | Scales, but buries things without strong linking |\n\nGo as flat as the navigation tolerates. When a dropdown passes roughly 20 items, that's the signal to add a level rather than keep the list flat.\n\nLevels: L0 is the homepage, L1 is a primary section (`\u002Ffeatures`, `\u002Fblog`), L2 is a page within it (`\u002Ffeatures\u002Fanalytics`), L3 and beyond are detail pages (`\u002Fdocs\u002Fapi\u002Fauthentication`).\n\n## Site types as starting points\n\n| Type              | Depth  | Sections                             | URL shape                               |\n| ----------------- | ------ | ------------------------------------ | --------------------------------------- |\n| SaaS marketing    | 2 to 3 | Home, Features, Pricing, Blog, Docs  | `\u002Ffeatures\u002F{name}`, `\u002Fblog\u002F{slug}`      |\n| Content site      | 2 to 3 | Home, Blog, Categories, About        | `\u002Fblog\u002F{slug}`, `\u002Fblog\u002Fcategory\u002F{slug}` |\n| Ecommerce         | 3 to 4 | Home, Categories, Products           | `\u002F{category}\u002F{subcategory}\u002F{product}`   |\n| Documentation     | 3 to 4 | Home, Guides, Reference              | `\u002Fdocs\u002F{section}\u002F{page}`                |\n| SaaS plus content | 3 to 4 | Home, Product, Blog, Resources, Docs | `\u002Fproduct\u002F{feature}`, `\u002Fblog\u002F{slug}`    |\n| Small business    | 1 to 2 | Home, Services, About, Contact       | `\u002Fservices\u002F{name}`                      |\n\n## URLs\n\nReadable, lowercase, hyphenated, mirroring the hierarchy, with one trailing-slash policy enforced everywhere. Short but still descriptive: `\u002Fblog\u002Flanding-page-conversions` beats `\u002Fblog\u002Fhow-to-improve-your-landing-page-conversion-rates`.\n\nThe mistakes that cost the most:\n\n- Dates in blog URLs. `\u002Fblog\u002F2026\u002F07\u002F25\u002Ftitle` adds nothing and ages the post visibly.\n- IDs or query strings carrying content. `\u002Fproduct\u002F12345` and `\u002Fblog?id=123` should be slugs.\n- Over-nesting past what the hierarchy needs.\n- Mixing parents for the same kind of page, like `\u002Ffeatures\u002Fanalytics` alongside `\u002Fproduct\u002Fautomation`.\n- Changing a URL without a 301. Every old URL needs one, or the links pointing at it stop counting and anyone who bookmarked it gets a 404. This is the single most common cause of traffic loss after a redesign.\n\n`references\u002Fpatterns.md` has the URL pattern per page type, navigation layouts, and the diagram formats to hand back.\n\n## Navigation\n\nPrimary navigation holds 4 to 7 items, ordered by importance, with the logo linking home and the call to action rightmost. Past 7, people stop reading the list and start hunting.\n\nFooters group into columns: product, resources, company, legal. Sidebars carry within-section navigation for docs and long content. Breadcrumbs mirror the URL path exactly, with every segment linked except the current page, and they pair with `BreadcrumbList` schema.\n\nBreadcrumbs are the cheapest structural win available: they add internal links on every page, they make hierarchy legible to a crawler, and they can earn a richer result.\n\n## Internal linking\n\n- No orphans. Every page needs at least one internal link pointing at it, and the sitemap is not a link.\n- Anchor text describes the destination. Never \"click here\" or \"read more\".\n- How many contextual links a single page carries is a decision for whoever owns that page's format, so recommend the connections worth making rather than a density target.\n- Link the pages that matter more often. Inbound internal links are how you tell a crawler what's important.\n- Hub and spoke for content clusters: one comprehensive hub, spokes covering sub-topics, each spoke linking back to the hub, the hub linking to all spokes, and spokes cross-linking where a reader would actually want it.\n\nHub and spoke is what makes a set of posts add up to more than its pages, because it concentrates the signal on the hub rather than spreading it across a dozen equal posts competing with each other.\n\n## What to hand back\n\nAn ASCII tree of the hierarchy with the URL at each node, a URL map table (page, URL, parent, where it appears in navigation, priority), the redirect list when anything moves, and a Mermaid diagram when the structure is worth seeing rather than reading. `references\u002Fpatterns.md` has the formats.\n\n## Sources\n\n- Google Search Central, URL structure best practices: https:\u002F\u002Fdevelopers.google.com\u002Fsearch\u002Fdocs\u002Fcrawling-indexing\u002Furl-structure\n- Google Search Central, Redirects and Google Search: https:\u002F\u002Fdevelopers.google.com\u002Fsearch\u002Fdocs\u002Fcrawling-indexing\u002F301-redirects\n- Google Search Central, Breadcrumb structured data: https:\u002F\u002Fdevelopers.google.com\u002Fsearch\u002Fdocs\u002Fappearance\u002Fstructured-data\u002Fbreadcrumb\n- Nielsen Norman Group, Flat vs deep website hierarchies: https:\u002F\u002Fwww.nngroup.com\u002Farticles\u002Fflat-vs-deep-hierarchy\u002F\n",{"description":7},"main","2e99dc3564dd243224e74b970a3c990b625cc8c0","apps\u002Ftemplates\u002Fmarketing-team-eve-template\u002Fagent\u002Fsubagents\u002Fseo\u002Fskills\u002Fsite-architecture",656,"https:\u002F\u002Fgithub.com\u002Fvercel\u002Feve","https:\u002F\u002Feve.dev","https:\u002F\u002Fgithub.com\u002Fvercel","https:\u002F\u002Fvercel.com","Agentic infrastructure for every app and agent.","2026-11-15 05:08:34",{"source":8,"skillName":5,"commands":35,"prompt":45,"zipAvailable":46},[36,39,42],{"tool":37,"command":38},"npx","npx skills add vercel\u002Feve --skill site-architecture",{"tool":40,"command":41},"bunx","bunx skills add vercel\u002Feve --skill site-architecture",{"tool":43,"command":44},"pnpm","pnpm dlx skills add vercel\u002Feve --skill site-architecture","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fvercel\u002Feve\u002Fblob\u002Fmain\u002Fapps\u002Ftemplates\u002Fmarketing-team-eve-template\u002Fagent\u002Fsubagents\u002Fseo\u002Fskills\u002Fsite-architecture\u002FSKILL.md",true,[48],{"path":49,"resourceType":50,"resourceTypeDesc":51,"sizeBytes":52,"sourceHtmlUrl":53},"references\u002Fpatterns.md","REFERENCE","参考文档",6269,"https:\u002F\u002Fgithub.com\u002Fvercel\u002Feve\u002Fblob\u002Fmain\u002Fapps\u002Ftemplates\u002Fmarketing-team-eve-template\u002Fagent\u002Fsubagents\u002Fseo\u002Fskills\u002Fsite-architecture\u002Freferences\u002Fpatterns.md",[55,62,68,75,82,89],{"skillNo":56,"name":57,"nameZh":6,"description":58,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":59,"categories":60,"keywords":61,"publishedAt":19},"01M7DYJETPKENT6T9THCB7WKFD","writing-quality","The review rubric: writing-quality rules and reference lists for judging a content draft, covering AI-sounding phrasing, bloated wording, structure, and web-content specs. Load at the start of every review.","https:\u002F\u002Fgithub.com\u002Fvercel\u002Feve\u002Fblob\u002Fmain\u002Fapps\u002Ftemplates\u002Fsanity-copilot-eve-template\u002Fagent\u002Fsubagents\u002Freviewer\u002Fskills\u002Fwriting-quality\u002FSKILL.md",[],[],{"skillNo":63,"name":57,"nameZh":6,"description":64,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":65,"categories":66,"keywords":67,"publishedAt":19},"01M7DYJAZM6Y5VNF2PCM01N145","Writing-quality guardrails for any prose the agent drafts or edits: blog posts, page copy, Notion drafts, release notes, marketing text. Use this skill whenever writing or revising content meant for humans to read, to keep the prose natural, plain, and free of AI-sounding phrasing. Not needed for code, queries, or structural CMS work.","https:\u002F\u002Fgithub.com\u002Fvercel\u002Feve\u002Fblob\u002Fmain\u002Fapps\u002Ftemplates\u002Fsanity-copilot-eve-template\u002Fagent\u002Fskills\u002Fwriting-quality\u002FSKILL.md",[],[],{"skillNo":69,"name":70,"nameZh":6,"description":71,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":72,"categories":73,"keywords":74,"publishedAt":19},"01M7DYJ40G4YADA5P8YAEQ7W7F","seo-aeo-best-practices","SEO and AEO best practices for metadata, Open Graph, sitemaps, robots.txt, hreflang, JSON-LD structured data, EEAT, and content optimized for search engines and AI answer surfaces. Use this skill when implementing page SEO, technical SEO, schema markup, international SEO, AI-overview readiness, or improving content for Google, ChatGPT, Perplexity, and similar assistants.","https:\u002F\u002Fgithub.com\u002Fvercel\u002Feve\u002Fblob\u002Fmain\u002Fapps\u002Ftemplates\u002Fsanity-copilot-eve-template\u002Fagent\u002Fskills\u002Fseo-aeo-best-practices\u002FSKILL.md",[],[],{"skillNo":76,"name":77,"nameZh":6,"description":78,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":79,"categories":80,"keywords":81,"publishedAt":19},"01M7DYHX5JXJFHF2DZV64VFC13","sanity-best-practices","Sanity development best practices for schema design, GROQ queries, TypeGen, Visual Editing, images, Portable Text, Studio structure, localization, migrations, Sanity Functions, Blueprints, and framework integrations such as Next.js, Nuxt, Astro, Remix, SvelteKit, Angular, Hydrogen, and the App SDK. Use this skill whenever working with Sanity schemas, defineType or defineField, GROQ or defineQuery, content modeling, Presentation or preview setups, Sanity-powered frontend integrations, Sanity Functions, documentEventHandler, defineDocumentFunction, defineMediaLibraryAssetFunction, @sanity\u002Ffunctions, @sanity\u002Fblueprints, sanity.blueprint.ts, event-driven content automation, or when reviewing and fixing a Sanity codebase.","https:\u002F\u002Fgithub.com\u002Fvercel\u002Feve\u002Fblob\u002Fmain\u002Fapps\u002Ftemplates\u002Fsanity-copilot-eve-template\u002Fagent\u002Fskills\u002Fsanity-best-practices\u002FSKILL.md",[],[],{"skillNo":83,"name":84,"nameZh":6,"description":85,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":86,"categories":87,"keywords":88,"publishedAt":19},"01M7DYHQG96APC7EV3FANC90WX","portable-text-serialization","Render and serialize Portable Text to React, Svelte, Vue, Astro, HTML, Markdown, and plain text. Use when implementing Portable Text rendering in any frontend framework, building custom serializers for non-standard block types, converting Portable Text to HTML strings server-side, converting Portable Text to Markdown, extracting plain text from Portable Text, or troubleshooting rendering issues with marks, blocks, lists, or custom types.","https:\u002F\u002Fgithub.com\u002Fvercel\u002Feve\u002Fblob\u002Fmain\u002Fapps\u002Ftemplates\u002Fsanity-copilot-eve-template\u002Fagent\u002Fskills\u002Fportable-text-serialization\u002FSKILL.md",[],[],{"skillNo":90,"name":91,"nameZh":6,"description":92,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":93,"categories":94,"keywords":95,"publishedAt":19},"01M7DYHJJ89WGRXXVWJAQNQW9M","portable-text-conversion","Convert HTML and Markdown content into Portable Text blocks for Sanity. Use when migrating content from legacy CMSs, importing HTML or Markdown into Sanity, building content pipelines that ingest external content, converting rich text between formats, or programmatically creating Portable Text documents. Covers @portabletext\u002Fmarkdown (markdownToPortableText), @portabletext\u002Fblock-tools (htmlToBlocks), custom deserializers, and the Portable Text specification for manual block construction.","https:\u002F\u002Fgithub.com\u002Fvercel\u002Feve\u002Fblob\u002Fmain\u002Fapps\u002Ftemplates\u002Fsanity-copilot-eve-template\u002Fagent\u002Fskills\u002Fportable-text-conversion\u002FSKILL.md",[],[]]