Communitygithub.com

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".

What is site-teardown?

site-teardown is a Claude Code agent skill that 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".

Works with~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/imperfec-t/webcraft/tree/HEAD/skills/site-teardown

Ask in your favorite AI

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

Documentation

Site teardown

Turn a page someone admires into a brief precise enough to rebuild from, without copying the original's brand, copy or media.

Why the output is a brief, not a copy

Layout patterns, section order and motion techniques are common craft and free to learn from. The original's wording, logo, photos, illustrations and code belong to its owner. So the brief describes structure and behavior, and replaces everything brand-specific with placeholders. This also makes the brief reusable: one teardown can seed many differently branded sites.

Workflow

  1. Fetch the page. Read the rendered text and, if you can, the HTML source, linked stylesheets and scripts. If a browser tool is available, also scroll the page and note what moves. If the webcraft CLI is available, webcraft teardown URL (MCP: teardown_site) drafts the section inventory, stack and placeholder brief from the markup, and webcraft detect URL lists libraries with versions. Use the draft as the skeleton and fill in what it marks as inferred.
  2. Say what you could not see. A text fetch gives structure and copy but not CSS or JS. State plainly which parts of the brief are observed and which are inferred, so the reader knows where to verify. Guessing silently produces a brief that looks confident and builds wrong.
  3. Inventory the sections in order. For each: purpose, layout (columns, grid, alignment), content slots (eyebrow, headline, body, CTA, media), and count of repeated items.
  4. Identify recurring patterns. Section label format, button style, card style, reveal animation. Describe each once under "Global patterns" rather than repeating it per section.
  5. Detect the stack. Look for library fingerprints in source: gsap, ScrollTrigger, lenis, swiper, splide, three, locomotive, aos, framer-motion, barba. Check meta generator, theme and plugin paths for the CMS.
  6. Specify motion in numbers. Trigger, property, from and to values, duration, easing, stagger. "Fades in nicely" cannot be built; "y 40px to 0, opacity 0 to 1, 0.8s, power3.out, 0.1s stagger, on enter at 80% viewport" can.
  7. Replace brand specifics with placeholders in square brackets: [BRAND NAME], [ACCENT], [HERO IMAGE], [Headline, 6 to 8 words]. Keep the shape of the copy (line count, rough length) because that drives layout.
  8. Write the brief using the template below.

Brief template

Build [page type] as [stack]. [Theme: light/dark]. Fully responsive.
Respect prefers-reduced-motion.

BRAND
- Name, colors (background, text, accent, surface, border), fonts, image list

GLOBAL PATTERNS
- Section label format, headline reveal, button behavior, card behavior

SECTIONS (numbered, in page order)
N. NAME
   Layout: ...
   Content slots: ...
   Motion: ...

QUALITY BAR
- Performance, accessibility, breakpoints

Checks before handing over

  • Every section on the page appears in the brief, in order.
  • No sentence of original copy, no original image URL, no brand name survives.
  • Each animation has trigger, values, duration and easing.
  • Observed versus inferred is stated in one line near the top.
  • The brief is paste-ready: one code block, no commentary inside it.

When the person owns the site

If they say it is their own site, you can keep their real copy and asset names in a separate "current content" appendix. Still keep the main brief placeholder-based so it works for the rebrand they asked for.

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.

homepage-blueprint

Plan the section structure and content slots of a homepage for an agency, freelancer, studio or service business before any design or code. Use this whenever someone asks "what sections should my homepage have", "plan my website", "structure a landing page for my business", wants a wireframe or sitemap for a service site, or starts building a homepage without a clear outline.

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.

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