Skip to content

TheGoat395/Codex-Skills / skills/website-blueprint-first

website-blueprint-first

Verified

Specify missing pages, sections and assets.

FileKindSize
SKILL.mdskill md1.0 KB
agents/openai.yamlconfig258 B
references/website-blueprint-first-guide.mdmarkdown2.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.
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: 198kUpdated Claude CodeCodexVerifiedInstall
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: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
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: 194kUpdated Claude CodeCodexVerifiedInstall