Communitygithub.com

Homepage Blueprint

Plan the section order and content slots of a service homepage before any visual design or code.

What is Homepage Blueprint?

A reusable planning skill for agency, freelancer, studio, and service homepages. It starts from the visitor, the one action, the proof, and the offers, then orders sections by the questions a visitor actually asks and drops any section the business cannot answer honestly.

Works with~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/imperfec-t/webcraft/tree/main/skills/homepage-blueprint

Ask in your favorite AI

Open a new chat with this agent skill pre-loaded.

Documentation

What does Homepage Blueprint do?

Decide what goes on the page, in what order, and why, before choosing colors or writing code. A homepage that is structured around the visitor's questions converts better than one structured around what the business wants to say.

Start with four answers

Ask for these if they are missing. Without them the blueprint is generic.

  1. Who is the visitor, and what did they just search for or click?
  2. What is the one action the page should produce (enquiry, call, purchase, signup)?
  3. What proof exists (reviews, client logos, numbers, case studies)?
  4. What services or offers must appear?

The visitor's question order

Each section answers the next question a visitor has. Order sections by this sequence and drop any section whose question the business cannot answer honestly.

Visitor asksSectionMinimum content
Am I in the right place?HeroWhat you do, for whom, one CTA
Can I trust this?Proof stripRating, logos or one number
Who are you?AboutTwo short paragraphs, one image
What exactly do you do?Services3 to 6 cards, each with a link
Why you over others?Differentiators3 to 5 concrete points
How does it work?Process3 to 4 steps
What will it cost?Pricing or engagement modelsRanges or "how we scope"
Did it work for others?TestimonialsReal quotes with names and roles
What if I have doubts?FAQ6 to 10 real objections
What do I do now?ContactShort form, alternative channels

A blog preview and a closing CTA band are optional extras after the FAQ.

Rules that keep the page honest and effective

  • One primary action. Repeat the same CTA label through the page. Competing CTAs split attention.
  • Real proof only. Never invent testimonials, client names, ratings or statistics. If proof is thin, use a process or guarantee section instead, and say what the person should collect.
  • Number the sections in the design (01, 02) only if there are five or more; it helps long pages feel navigable.
  • Each section has one job. If a section answers two questions, split it.
  • Above the fold: headline, one supporting line, CTA, and one proof element. Nothing else is required there.

Output format

Produce a table, then notes.

# Homepage blueprint: [Business]

Goal: [single action]   Visitor: [who]

| # | Section | Job | Content slots | CTA |
|---|---------|-----|---------------|-----|

## Content the business still needs to supply
- ...

## Sections deliberately left out, and why
- ...

The "left out" list matters: it shows the structure was a choice, and tells the person what to add when they have the material.

Variations

  • Solo freelancer: merge About into the hero, lead with portfolio pieces instead of a services grid.
  • Local service business: add service area and opening hours near the contact section; put the phone number in the header.
  • Product or SaaS: replace Services with a feature walkthrough and Process with "how it works" screenshots.
  • E-commerce: this skill does not fit; category and product discovery lead instead.

Individual skills in this repo

This repo contains 8 individual skills — each has its own dedicated page.

design-tokens

Create a website's visual system as CSS custom properties, covering color palette, typography scale, spacing, radius and shadows, with contrast checked. Use this whenever someone asks for a color scheme, a palette from one brand color, font pairing, a type scale, "make it look consistent", dark mode, a rebrand of an existing site into new colors, or starts a build with no defined styles.

hero-section

Design and build the hero (first screen) of a website, including headline layout, media treatment, CTA, proof badge, marquee and entrance animation. Use this whenever someone asks for a hero section, a landing page header, "the top of my homepage", a cinematic or animated intro, a video background, a text marquee, or says their first screen looks plain or generic.

launch-qa

Run a pre-launch quality check on a website covering performance, accessibility, SEO basics, forms, cross-device behavior and content, and report findings ranked by severity with fixes. Use this whenever someone says a site is "ready to launch", "going live", asks "can you check my site", wants a QA pass, a website audit, a Lighthouse-style review, or wants to know why a page is slow or scoring badly.

responsive-layout

Build page layouts that work from phones to wide desktops using CSS grid, flexbox, container queries and fluid sizing, including card grids, bento grids, split sections, sticky sidebars and navigation that collapses. Use this whenever someone says their site "breaks on mobile", asks for a responsive grid, a bento layout, a mobile menu, fixing horizontal scroll or overflow, or is laying out any multi-column section.

scroll-motion

Add scroll-driven and entrance animation to a website with GSAP, ScrollTrigger and Lenis, including reveals, parallax, pinned sections, horizontal scroll, line drawing, counters and preloaders. Use this whenever someone wants a site to "feel premium", asks for smooth scrolling, scroll animations, parallax, text reveals, a pinned or sticky scroll section, an animated preloader, or names GSAP, ScrollTrigger, Lenis, Locomotive or AOS.

site-teardown

Analyze a live website and turn it into a section-by-section build brief that another person or AI can rebuild from, with brand name, colors, fonts and images swapped for placeholders. Use this whenever someone shares a URL and says "analyze this site", "make something like this", "give me a prompt to build this", "recreate this effect", "clone the layout with my branding", or asks how a page's animation or structure works, even if they never say "teardown".

website-workflow

Plan and sequence a whole website build, from structure through design, code, WordPress and launch, by routing each stage to the right webcraft skill. Use this when someone asks to "build me a website", "design my site from scratch", "redo our homepage", wants an end-to-end plan for a marketing, agency, studio or service site, or the request spans more than one of structure, look, layout, motion, CMS and QA.

wordpress-theme-build

Turn a static HTML/CSS/JS design into a custom WordPress theme that the client can edit, covering theme structure, theme.json, enqueueing scripts, block patterns, custom post types and editable content. Use this whenever someone wants to convert a design or static site to WordPress, build a custom or block theme, make sections editable in Gutenberg, add GSAP or other scripts to a theme properly, or asks why their theme edits are lost or their content is hard-coded.

Related Skills