TheGoat395/Codex-Skills / skills/website-blueprint-first
website-blueprint-first
VerifiedSpecify missing pages, sections and assets.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 1.0 KB |
| agents/openai.yaml | config | 258 B |
| references/website-blueprint-first-guide.md | markdown | 2.7 KB |
references/website-blueprint-first-guide.md
View on GitHub# Website Blueprint First Guide
## Purpose
Lock the plan before coding so the build does not drift into generic filler.
## Use When
- The user asks to create, redesign, or heavily rework a site.
- The brief includes strong taste goals but weak structure.
- The user wants to avoid previous bad outputs and start from a clean direction.
## Do Not Use When
- The user explicitly asks for a tiny implementation change.
- A full approved design spec already exists and only needs coding.
## Discovery Questions
- What is the exact repo/path and source of truth?
- What pages and sections are needed?
- What assets exist and which need generation or placeholders?
- What are the primary references and anti-references?
- What commands will verify the build?
## Decision Tree
- If the site category is unclear, classify it before writing a blueprint.
- If assets are missing, define asset slots and acceptable generation/search strategy.
- If the user asked to proceed, keep blueprint brief and immediately implement.
- Ask only when an unresolved consequential choice or actual authorization boundary blocks the next action; otherwise proceed within existing authorization.
## Implementation Rules
- Blueprint must include audience, offer, page map, section order, visual lane, type, color, media, motion, responsive behavior, and QA.
- Each section needs purpose, content, layout, asset need, and interaction/motion notes.
- Define what will not be built to avoid scope creep.
- For visual-first work, consider a generated image or mockup only when it clarifies the direction.
## Useful Patterns
- Homepage blueprint: hero, proof, offer/value, detail sections, conversion, footer.
- Product blueprint: product UI hero, workflow proof, use cases, integrations, pricing, docs/trust.
- Portfolio blueprint: selected work, case study rhythm, about, process, contact.
- Luxury blueprint: scene, material detail, story, gallery, offering, booking/purchase.
## Anti-Patterns
- Blueprints that list generic sections without visual instructions.
- Starting image generation before defining the page purpose.
- Building from old/bad context when the user requested a fresh start.
## QA Checklist
- Compare final page to blueprint section by section.
- Confirm visual lane, asset strategy, and motion model survived implementation.
- Report intentional deviations.
## Acceptance Criteria
- Another agent could build from the blueprint and land in the same direction.
- The user can approve/reject the direction before large edits.
## Scoped execution
Apply the [shared web contract](../../website-operating-rules/references/scoped-web-contract.md) once when execution crosses phases; reuse it if already read. Load only the specialist guidance relevant to the requested surface and deliverable.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |