new-page
Skill9 starsChanged todayMITView on GitHub
Add a new page to the website with the standard layout shell and correct navigation wiring. Use when asked to add or create a new page on the site.
10 other projects use a version of this, 1 of them edited.
Adopted by
Most recently taken up by
- 5hirish/ducttheir own version, first seen Nov 8, 2026
- robritacca-dotcom/design-systemedited, first seen Oct 28, 2026
- Anglesite/anglesite-skillstheir own version, first seen Oct 27, 2026
- fangyuting/skillstheir own version, first seen Oct 11, 2026
- justrach/merjstheir own version, first seen Oct 8, 2026
- fpindej/netrocktheir own version, first seen Oct 8, 2026
Other versions10 projects use a version of this.
Word for word · 0
None found.
Edited · 1
- robritacca-dotcom/design-system★ 164% same
Wrote their own version · 9
- ethereum/ethereum-org-website★ 6ksame name
- justrach/merjs★ 357same name
- fpindej/netrock★ 234same name
- Anglesite/anglesite-skills★ 15same name
- 5hirish/duct★ 8same name
- kkhh26864/claude-skills★ 3same name
- agamarora/second-brain★ 2same name
- fangyuting/skills★ 1same name
- mark2685/agent-tools★ 0same name
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository38 other files it gives its agents.
- CLAUDE.mdCLAUDE.md
- accessibility-auditSkill
- animation-jump-checkSkill
- api-consistencySkill
- chat-qualitySkill
- checkpointSkill
- component-consistency-auditSkill
- component-doc-pageSkill
- content-auditSkill
- dependency-advisorySkill
- design-qaSkill
- dogfoodSkill
- drift-auditSkill
- figma-paritySkill
- figma-tokensSkill
- first-deploySkill
- landSkill
- link-rotSkill
- new-backgroundSkill
- new-componentSkill
- new-figma-componentSkill
- new-figma-templateSkill
- new-presetSkill
- new-templateSkill
- new-tokenSkill
- new-validatorSkill
- parkSkill
- pre-deploySkill
- release-postSkill
- releaseSkill
- responsive-sweepSkill
- security-auditSkill
- seo-auditSkill
- shipSkill
- super-shipSkill
- token-auditSkill
- token-renameSkill
- visual-reviewSkill
The file
We split this skill into the rules it gives an agent
6 rules. 0 are common, 3 are distinctive, and 3 are very specific to this project.
0
Common
Most of the 8 edited versions we read keep these.
3
Distinctive
This author's own choices. Worth a look.
3
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 13
Add a new page to the website with the standard layout shell and correct navigation wiring.
- Distinctive: line 17
Use this skill when asked to add or create a new page on the website — phrases like "add a page for [X]", "create a [section] page", "add …
- Distinctive: line 23
Gather requirements: if not already provided:
- Very specific: line 40
All copy on the page (tagline, intro, body, metadata description) follows content-design.md — voice, register, and the words-to-avoid tables
- Very specific: line 57
Only component pages are build-enforced (scripts/validate-page-titles.mjs requires componentPageMetadata("<slug>") there).
- Very specific: line 58
Default export wraps {children} in a fragment
“Common” is measured: kept by at least 6 in 10 of the 8 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
new-page
Add a new page to the website with the standard layout shell and correct navigation wiring.
When invoked
Use this skill when asked to add or create a new page on the website — phrases like "add a page for [X]", "create a [section] page", "add [X] to the site".
For a component documentation page, use the component-doc-page skill instead — it covers the variant showcase and component-specific registrations. For a template screen, use the new-template skill — it owns the family's composition conventions and the full registration checklist.
Instructions
- Gather requirements if not already provided:
- Page URL path (e.g.
/foundations/motion) - Which section it belongs to — the sidebar arrays in
website/src/config/navigation.tsare the authoritative list of sections (components, foundations, the docs cluster, templates; standalone pages like/playgroundlive in no sidebar array and declare their metadata as a literal). Components are the exception:componentsSidebarLinksis derived fromsrc/components/registry.json(merged with the chat widget'ssrc/chat/registry.jsonthroughwebsite/src/data/component-pages.ts), so a component page is registered by adding a registry entry, not by editing the array — use thecomponent-doc-pageskill for those. Component categories have no pages of their own; a registry category entry becomes an index section and a sidebar accordion automatically./blueprints/<slug>pages are another exception: each reads its body from a synced spec copy inwebsite/public/, so a new one starts by registering the root spec (see step 4). - Page title, a short
subDisplaytagline, and a 1–2 sentence description (for metadata and the intro block) - Storybook path (optional) — for
PageLinks. A Figma link needs no URL:PageLinksreads the route's frame fromwebsite/src/data/figma-nodes.json
- Page URL path (e.g.
- Read the exemplars before writing anything. The live pages are the source of truth for structure — mirror them rather than writing a shell from memory:
website/src/app/skills/page.tsx— a standard content page (layout shell, sidebar wiring, header/intro blocks, entry animations)website/src/app/components/button/page.tsx+page.module.css+layout.tsx— the richest example, withPageLinksand per-page CSSwebsite/src/config/navigation.ts— nav config (single source of truth for sidebars, mega menu, and breadcrumbs; the sitemap derives its routes from the sidebar configs)
- Create the directory
website/src/app/<path>/with three files, mirroring the exemplar:
File 1: page.tsx
- Copy the exemplar's shell exactly — same components, same nesting, same class names. Don't improvise structure.
- Invariants the exemplar can't teach:
subDisplayis a tagline inside the intro block (e.g. the Skills page's "Reusable AI instructions, tuned for this project") — not the section name; the breadcrumb already shows where you are- All copy on the page (tagline, intro, body, metadata description) follows
content-design.md— voice, register, and the words-to-avoid tables - Sidebar links come from
getSidebarLinks(<section>SidebarLinks, "<your path>") - Include
PageLinksonly if the page has a Storybook path or a frame inwebsite/src/data/figma-nodes.json - The on-this-page rail is automatic, not part of the shell.
SiteAnchorRailin the root layout reads every page's h2 headings after navigation and floats the rail on the right viewport edge, so a new page gets one with no wiring — never mount an anchor nav of your own by default. The gates live inwebsite/src/config/anchor-nav.ts, whose doc block owns the rules: an index or landing page registers inANCHOR_NAV_EXCLUDED_ROUTES; a page whose items must be derived server-side (markdown-extracted sections, labels that are not headings) mountsFloatingAnchorNavitself and registers inANCHOR_NAV_SELF_MANAGED_ROUTESso it never carries two — the blueprints are the exemplar; and an immersive or chromeless surface also registers inANCHOR_NAV_EXCLUDED_ROUTESeven though chromeless routes are skipped anyway, so the intent survives if its chrome status ever changes (/playgroundand/graphare the precedent). Demo or furniture h2s that are not sections of the page sit insidedata-anchor-ignore(or an<aside>); the discovery rules live in the doc block ofwebsite/src/components/FloatingAnchorNav/SiteAnchorRail.tsx - Do not render a background.
BlurBackgroundis mounted once in the root layout and covers every route; adding it per page would build a second canvas and a second GL context on top of the first.scripts/validate-single-background-mount.mjsfails the build if you do
File 2: page.module.css
- Copy the exemplar's layout classes; add page-specific classes as needed
- Semantic design tokens only — no hardcoded colours or magic values
- Page assembly is a spec, not taste: design.md's Composition section owns the rhythm ladder and the assembly rules (parent owns spacing, one level of chrome, dividers last, prose never width-capped) — read it before laying out sections; the exemplar shows the pattern, the spec owns the rules
- No
ch-basedmax-widthon prose — doc paragraphs run the full content column; the layout column is the only width constraint (build-enforced byscripts/validate-page-titles.mjs) - Mobile type and section rhythm collapse at the token layer (display sizes and section-gap tokens step down system-wide —
design.md's responsive spec owns the breakpoint) — do not add per-page@mediaoverrides for tokenized values; when a page genuinely needs a breakpoint, use a width fromsrc/tokens/breakpoints.ts(or the site families inwebsite/src/config/breakpoints.ts); a content-driven width outside the set needs/* ds-allow(breakpoint): <reason> */directly above the query, orscripts/validate-breakpoints.mjsfails the build
File 3: layout.tsx
- Sidebar-registered pages export
metadatavia the shared helper:export const metadata = pageMetadata("<your path>", "<one-line description>")(import from@/config/navigation) - Standalone pages (
/playground,/graph— pages in no sidebar array) export a literalMetadataobject instead, with an explicitalternates.canonical— seewebsite/src/app/playground/layout.tsx - Deliberately hidden pages are the exception to both rules — and "hidden" has two independent halves. Hidden from crawlers: sets
robots: { index: false, follow: false }, skips the canonical and the sitemap entirely, and records why in a comment beside that metadata. Hidden from visitors: appears in no nav surface. A page can take one without the other — the labs pages take both (/labs/marketingis the live example). Either way the page records why — in itslayout.tsx(/labs/marketingis the precedent), or in thepage.tsxitself when the page needs no layout of its own. A full-viewport or immersive page that should also render none of the shared chrome (the layout-mounted footer, chat panel, and command palette) additionally adds its route toCHROMELESS_ROUTESinwebsite/src/config/chromeless.ts— the set in that file is the authoritative list of what has taken the exception. A hidden page also needs an entry inEXCLUDED_ROUTESinscripts/generate-site-corpus.mjswith a written reason, orvalidate-chat-coverage.mjsfails the build for an uncovered route. Suppressing chrome does not make the background full-bleed: by default every page gets the fixed-height band that fades into the page floor (the doc block ofwebsite/src/components/BlurBackground/BlurBackground.tsxowns the modes and the number). An immersive page must also render<FullBleedBackground />(exported fromwebsite/src/components/BlurBackground/BlurBackground.tsx), a hidden marker that CSS inglobals.cssreads to drop the fade and fill the viewport. Skip it and the page is chrome-free but band-limited, which looks wrong with nothing to explain why. The immersive stages take a third mode: a page whose panels float on the dotted working-canvas ground renders<DotBackground />(website/src/components/DotBackground/) beside<HiddenBackground />(exported from the same BlurBackground module), so the ambient layer stands down instead of glowing through the dots —/playgroundand/graphare the precedent (that doc block owns the background-mode contract). Pick exactly one: the default band, the home page's extended band (<ExtendedBackground />, same marker mechanism), full-bleed ambient, or hidden-plus-dots - Only component pages are build-enforced (
scripts/validate-page-titles.mjsrequirescomponentPageMetadata("<slug>")there); for everything else the helper is convention, not a gate — follow it anyway - Default export wraps
{children}in a fragment
- Register the page everywhere the site tracks pages:
- Sidebar (only if the page belongs to a section): add
{ href, label }to the section's array inwebsite/src/config/navigation.ts, matching that array's existing order convention (foundations and docs are curated in reading order; templates keep the index link first, then one entry per screen; components are derived from the registry — see the exception in step 1). A/templates/<slug>screen also renders full-viewport, so it takes aCHROMELESS_ROUTESentry and a corpusEXCLUDED_ROUTESreason — both covered in File 3 - Blueprint pages are a second exception: a
/blueprints/<slug>page reads its body fromwebsite/public/<name>.mdat build time viafs.readFileSync, and that copy only exists once the root spec is added toFILESinscripts/sync-blueprints.mjs(the authoritative list;scripts/validate-website-surfaces.mjsholds it to the pages in both directions, so a synced file without a page, or a page without a synced file, fails the build) - Standalone pages (no sidebar section): no array to edit — but the sitemap then knows nothing about the route, so add it as a top-level literal in
website/src/app/sitemap.ts(the/playgroundentry is the pattern), and if the page should be reachable from a header section's mega panel, add it to that section'smega.groupsinbuildNavSections()(same file) and widen the section'sisActivepredicate to match the new path — the drawer, footer, palette, breadcrumbs and sitemap all derive fromgetNavSections()/getSectionItems(), so a new item goes into a section's groups, never into a second list. If it is a top-level site page a visitor should reach from anywhere, also add it to thesiteLinksarray inwebsite/src/components/SiteFooter/SiteFooter.tsx— the one footer column that is hand-maintained (of the other four, three derive from the nav config and Elsewhere fromPROJECT_LINKSinwebsite/src/config/social.ts) — and to the command palette's hand-writtennavigationgroup inwebsite/src/components/SitePalette/SitePaletteMount.tsx, or the page is unreachable from Cmd+K (a docs-cluster page instead ridesdocsSidebarLinksautomatically there; no validator covers either). Crawler-hidden pages (see File 3) never enter the sitemap; whether they enter the nav is a separate call — a fully hidden page registers nowhere, while a crawler-hidden page a visitor should still find (no live page currently takes this shape) takes the normal nav entries plusdesktopOnly: trueon itsMegaItemwhen the page needs a pointer and a wide viewport: that flag hides the link at and below the tablet step (BREAKPOINT_TABLET_PXinsrc/tokens/breakpoints.ts, the number's one home; design.md's Responsive → Breakpoints section owns what the step does) on the surfaces that render at every width (the footer and the command palette), and the drawer omits desktop-only pages outright (MegaNav.tsxfiltersdesktopOnlyitems out of each section'sdrawerItems, so the flag alone is enough) - Mega panel for sidebar-registered pages: automatic for membership. The Docs and Foundations panels derive their groups from
docsSidebarLinksandfoundationsSidebarLinks(the Docs panel's Learn group takes every docs page no other group or the showcase claims), and the mobile drawer derives from the panels, so never add a hand list of hrefs to a panel group. The page does need an icon: an entry inDOC_ITEM_ICONSorFOUNDATION_ICONSinwebsite/src/config/navigation.ts(the docs table also feeds the command palette's rows).scripts/validate-nav-panels.mjsfails the build on a missing or orphaned icon - Sitemap for sidebar-registered pages: automatic — it derives from the sidebar configs, so the entry above covers it
- Breadcrumbs: sub-pages of an existing section resolve automatically from the sidebar entry. Only if the page starts a new section: add a
breadcrumbSectionsentry, and a newNavSectioninbuildNavSections()— with itsisActivepredicate, andmega.groupsif the section should open a panel. A standalone immersive page that mountsStageToolbar(whose trail comes fromgetBreadcrumbs) resolves through neither path: add a literal branch for it ingetBreadcrumbsinwebsite/src/config/navigation.ts—/playgroundand/graphare the precedent — or the toolbar renders an empty trail and nothing fails the build - The site-chat corpus has a ceiling, and a visible page counts against it:
scripts/generate-site-corpus.mjsextracts every indexed page's prose automatically, so there is nothing to register — but a substantial page can push the corpus pastTOKEN_BUDGETand fail the build with an over-budget error before any validator runs. That constant's own doc block owns the call between raising the budget and trimming a section; read it, and runnode scripts/generate-site-corpus.mjs --sizesto see which section actually grew before deciding. A value the page writes into its prose ({SOME_COUNT} components) must resolve too, or generation fails rather than leave a hole in the sentence: the Inline values block in that script owns the rules,INLINE_VALUESfor a value computed from published data andRUNTIME_EXPRESSIONSfor one that only exists while the page runs - The AI-summary panel: every page with the shared chrome gets the chat FAB, and hovering it opens a per-page summary with prompt chips. Add the page's entry to
website/src/data/page-summaries.json(routesmap: atitle, a super-concisetext, and 1 chip for a simple page, 2 for a dense one — the validator's field grammar is authoritative: text length and full stop, every chip carryingid/label/prompt, labels inside the suggestion budget, no em dashes), plus astarterspool: more questions than the chat's welcome screen draws (the validator reads the number), each{ id, label }, written about this page so the chat opens on its subject rather than its section's, answerable from the page's own prose (read it back in the corpus), and naming roles rather than theme values (validate-chat-starters.mjsfails a colour family or the base typeface) —scripts/validate-page-summaries.mjsfails the build for a route without one, so this cannot be skipped silently. Component pages derive theirs from the component registry and need nothing here; a chromeless page has no FAB and is exempt automatically - A drag grip: a page that mounts something a visitor can drag (a split pane, a compare handle, a pannable map) adds an entry to
scripts/gestures.jsonwith the setup that reaches the grip, so the gesture stress check drives it inverifyand CI (CLAUDE.md's Gestures row owns the registry). No validator notices a missing entry
- Sidebar (only if the page belongs to a section): add
- Verify: load the page in the browser and confirm the sidebar highlights it, the breadcrumb trail is correct, and both themes render properly.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

