From design-ops
Generates complete Markdown scaffolds for deliverable files like site-map-report.md, each including a standard header explaining purpose, target audience, and related files.
npx claudepluginhub opensesh/design-ops --plugin design-opslibrary/development/site-analysis-refs/# Output Templates
Complete Markdown scaffolds for the deliverable files. Each file includes a standard header explaining its purpose and target audience.
---
## site-map-report.md Template
mermaid
graph TD
A["{domain}"]:::root --> B["{section_1}"]:::nav
A --> C["{section_2}"]:::nav
A --> D["{section_3}"]:::nav
B --> B1["{subsection}"]:::content
B --> B2["{subsection}"]:::content
C --> C1["{subsection}"]:::content
C --> C2["{subsection}"]:::content
classDef root fill:#CDFE00,stroke:#141314,color:#141314,stroke-width:2px
classDef nav fill:#f5f5f5,stro.../analyze-siteAnalyzes a website for design inspiration by capturing desktop/mobile screenshots and extracting colors, fonts, typography, layout patterns, and UI elements into a structured markdown report.
/rank-competeCompares your site's SEO signals, tech stack, content depth, and conversion patterns against a competitor URL, producing score summary, side-by-side tables, quick wins, and strengths.
/siteAudits website for UX/UI design, marketing, SEO, accessibility, performance, conversion. Crawls all pages via cmux browser and generates detailed visual critiques with actionable recommendations.
/competeCompares your production site against a competitor's across tech stack, performance, SEO, and security. Produces a shareable comparison card.
/brandGenerates a full editorial brand-guidelines book from a URL across 13 chapters on color, typography, spacing, shape, icons, motion, components, voice, accessibility, tokens, and usage. Outputs print-ready HTML, MD summary, JSON.
/competitive-auditCaptures competitor website with Playwright on desktop/mobile, extracts design intel: colors, typography, layout, nav, hero, social proof, CTAs, unique patterns.
Share bugs, ideas, or general feedback.
Complete Markdown scaffolds for the deliverable files. Each file includes a standard header explaining its purpose and target audience.
# Site Intelligence Report: {domain}
> Generated: {date} | Mode: {Quick|Deep} | Pages analyzed: {n} | Confidence: {High|Medium|Low}
---
## About This Document
| | |
|---|---|
| **Target Audience** | Humans (strategists, PMs, designers) |
| **Purpose** | Bird's-eye view of site architecture, content strategy, and technical implementation |
| **Use Case** | Understanding scope and structure before building; answering "What exists and how is it organized?" |
| **Related Files** | `page-structure.md` (component hierarchy), `component-specs/*.yaml` (implementation specs), `agent-handoff.md` (build prompts) |
---
## Executive Summary
{2-3 paragraphs covering:
- Site purpose and target audience
- Key structural observations
- Most significant findings (positive and negative)
- Primary recommendation}
---
## Site Architecture
### Hierarchy Diagram
```mermaid
graph TD
A["{domain}"]:::root --> B["{section_1}"]:::nav
A --> C["{section_2}"]:::nav
A --> D["{section_3}"]:::nav
B --> B1["{subsection}"]:::content
B --> B2["{subsection}"]:::content
C --> C1["{subsection}"]:::content
C --> C2["{subsection}"]:::content
classDef root fill:#CDFE00,stroke:#141314,color:#141314,stroke-width:2px
classDef nav fill:#f5f5f5,stroke:#666,color:#141314
classDef content fill:#ffffff,stroke:#999,color:#141314
```
### Navigation Structure
| Level | Pages | Examples |
| -------------------- | ----- | ---------- |
| L0 (Root) | 1 | {homepage} |
| L1 (Primary nav) | {n} | {examples} |
| L2 (Section content) | {n} | {examples} |
| L3+ (Deep content) | {n} | {examples} |
### URL Structure Analysis
**Patterns observed:**
- {pattern observation 1}
- {pattern observation 2}
**Consistency notes:**
- {consistency observation}
---
## Content Clusters
| Cluster | URL Count | Sample Pages |
| ------------- | --------- | -------------- |
| Blog | {n} | {url1}, {url2} |
| Documentation | {n} | {url1}, {url2} |
| Products | {n} | {url1}, {url2} |
| Resources | {n} | {url1}, {url2} |
| Utility | {n} | {url1}, {url2} |
| Other | {n} | {url1}, {url2} |
{If >50 URLs total, use collapsible:}
<details>
<summary>Full URL list ({total} URLs)</summary>
**Blog ({n})**
- {url}
- {url}
**Documentation ({n})**
- {url}
- {url}
{...continue for each cluster}
</details>
---
## Template Families
| Template | Page Count | Dominant Sections | User Goal |
| --------------- | ---------- | ----------------- | --------- |
| {template_name} | {n} | {section_list} | {goal} |
| {template_name} | {n} | {section_list} | {goal} |
### {Template Name 1}
**Representative URLs:**
- {url1}
- {url2}
**Sections typically present:**
- {section}: {description}
- {section}: {description}
**User journey:** {description of what user does on this page type}
### {Template Name 2}
{repeat structure}
---
## Internal Linking
### Link Statistics
| Metric | Value |
| ----------------------------------- | ------------------------- |
| Average internal links per page | {n} |
| Most linked page | {url} ({n} inbound links) |
| Least linked content page | {url} ({n} inbound links) |
| Orphan pages (0 inbound) | {n} |
| Navigation links (in header/footer) | {n} |
### Link Graph Observations
- {observation about linking patterns}
- {observation about hub pages}
- {observation about potential issues}
{For Deep mode, optionally include link matrix or top pages:}
**Top 10 Most Linked Pages:**
| Page | Inbound Links |
| ----- | ------------- |
| {url} | {n} |
| {url} | {n} |
---
## SEO Overview
### Metadata Quality
| Element | Coverage | Quality Notes |
| ----------------- | ------------------ | ------------- |
| Title tags | {n}/{total} ({%}%) | {observation} |
| Meta descriptions | {n}/{total} ({%}%) | {observation} |
| H1 tags | {n}/{total} ({%}%) | {observation} |
| Open Graph tags | {n}/{total} ({%}%) | {observation} |
| Canonical tags | {n}/{total} ({%}%) | {observation} |
| Structured data | {n}/{total} ({%}%) | {observation} |
### SEO Strengths
- {strength 1}
- {strength 2}
### SEO Issues
| Issue | Severity | Pages Affected | Recommendation |
| ------- | -------------------------- | -------------- | -------------- |
| {issue} | {Critical/High/Medium/Low} | {n} | {fix} |
| {issue} | {severity} | {n} | {fix} |
### Technical SEO Signals
- **Indexability:** {observation}
- **Canonicalization:** {observation}
- **Redirects observed:** {observation}
- **Sitemap:** {present/not found}
- **Robots.txt:** {observation}
---
## Performance Observations
### Page Weight Indicators
| Indicator | Pages Affected | Notes |
| --------------------------- | -------------- | ------------- |
| Image-heavy (>20 images) | {n} | {urls if few} |
| Embedded video | {n} | {urls if few} |
| Many external scripts (>10) | {n} | {observation} |
| Third-party domains loaded | {n} domains | {list if <10} |
### Potential Concerns
- {concern 1 with specifics}
- {concern 2 with specifics}
### Positive Signals
- {positive observation}
---
## Statistics
| Metric | Value |
| ---------------------------- | ---------- |
| Total URLs discovered | {n} |
| Pages analyzed in detail | {n} |
| Template families identified | {n} |
| Maximum click depth | {n} levels |
| Pages with forms | {n} |
| Pages with CTAs | {n} |
| Pages with video | {n} |
| Average word count | {n} words |
| Total internal links | {n} |
| Total external links | {n} |
---
## Risks, Anomalies & Opportunities
### Risks
| Risk | Severity | Impact | Recommendation |
| ------------------ | -------------------------- | ----------------- | -------------- |
| {risk description} | {Critical/High/Medium/Low} | {business impact} | {action} |
| {risk description} | {severity} | {impact} | {action} |
### Anomalies
- {unexpected finding 1}
- {unexpected finding 2}
### Opportunities
| Opportunity | Impact | Effort | Recommendation |
| ------------- | ----------------- | ---------- | -------------- |
| {opportunity} | {High/Medium/Low} | {estimate} | {action} |
| {opportunity} | {impact} | {effort} | {action} |
---
## Methodology & Confidence
### Analysis Mode
**{Quick Mode | Deep Mode}**
{For Quick Mode:}
> This analysis used Web Search and WebFetch tools for reconnaissance. Structural details are inferred from content rather than DOM inspection. Results should be considered directional guidance.
{For Deep Mode:}
> This analysis used Firecrawl MCP for comprehensive crawling and HTML structure analysis. Section detection used semantic HTML tags and class name pattern matching.
### Data Sources
| Source | Details |
| ------------- | ----------------------------- |
| URL discovery | {firecrawl_map / web search} |
| Pages scraped | {n} |
| Formats used | {html, links, markdown, etc.} |
| Analysis date | {date} |
### Confidence Levels
| Analysis Area | Confidence | Basis |
| ----------------- | ----------------- | -------------------------------------------- |
| Site hierarchy | {High/Medium/Low} | {Observed from crawl / Inferred from search} |
| Template families | {High/Medium/Low} | {DOM fingerprinting / Content inference} |
| SEO coverage | {High/Medium/Low} | {Direct meta extraction / Partial data} |
| Internal linking | {High/Medium/Low} | {Full link graph / Sampled pages} |
| Performance | {High/Medium/Low} | {HTML analysis / Limited signals} |
### Limitations
- {limitation 1 - what couldn't be determined}
- {limitation 2 - JS-heavy content notes}
- {limitation 3 - auth-gated areas}
- {limitation 4 - sample size constraints}
---
_Report generated by Website Intelligence Skill_
# Page Structure Diagrams: {domain}
> Generated: {date} | Templates documented: {n}
---
## Diagram Legend
```
+==========================================+
|| SECTION-TYPE: description || ← Double border = page container
+==========================================+
+------------------------------------------+
| SECTION-TYPE: description | ← Section container
+------------------------------------------+
| [element] [element] [element] | ← Inline elements (buttons, links)
| +--------+ +--------+ +--------+ | ← Grid/card layouts
| | card 1 | | card 2 | | card 3 | |
| +--------+ +--------+ +--------+ |
| "Quoted text represents headlines" | ← Text content
| {variable content} | ← Dynamic/variable content
```
### Section Type Key
| Abbreviation | Full Name | Description |
| -------------- | -------------- | ------------------------------------- |
| `HEADER` | Site Header | Logo, primary navigation, utility nav |
| `NAV` | Navigation | Menu systems, breadcrumbs |
| `HERO` | Hero Section | Large banner with headline + CTA |
| `FEATURE` | Features | Feature grids, benefit lists |
| `CONTENT` | Content Area | Article body, text blocks |
| `SIDEBAR` | Sidebar | Secondary navigation, widgets |
| `CTA` | Call to Action | Conversion-focused blocks |
| `FORM` | Form Section | Input forms, contact forms |
| `SOCIAL-PROOF` | Social Proof | Testimonials, logos, reviews |
| `PRICING` | Pricing | Plans, pricing tables |
| `FAQ` | FAQ | Questions and answers |
| `FOOTER` | Site Footer | Links, legal, social |
| `ANNOUNCE` | Announcement | Banners, alerts, promos |
| `STATS` | Statistics | Numbers, metrics |
| `GRID` | Grid Layout | Card collections, galleries |
---
## Homepage
**URL:** {homepage_url}
**Template:** Homepage (unique)
**Purpose:** Primary landing page establishing brand and guiding visitors to key sections
**User Goal:** Understand what the product/service offers and find relevant section
```
+============================================================+
|| {domain} ||
+============================================================+
| ANNOUNCE: {promotional banner text if present} |
+------------------------------------------------------------+
| HEADER |
| [logo] [nav: {nav_items}] [CTA: {cta_text}] |
+------------------------------------------------------------+
| |
| HERO |
| "{main_headline}" |
| "{supporting_subheadline}" |
| |
| [Primary CTA: {text}] [Secondary CTA: {text}] |
| |
+------------------------------------------------------------+
| SOCIAL-PROOF |
| [logo] [logo] [logo] [logo] "{trust_text}" |
+------------------------------------------------------------+
| FEATURES |
| +----------------+ +----------------+ +----------------+ |
| | {feature_1} | | {feature_2} | | {feature_3} ||
| | [icon] | | [icon] | | [icon] ||
| | {description} | | {description} | | {description} ||
| +----------------+ +----------------+ +----------------+ |
+------------------------------------------------------------+
| CTA-SECTION |
| "{cta_headline}" |
| [CTA Button: {text}] |
+------------------------------------------------------------+
| FOOTER |
| [nav_column_1] [nav_column_2] [nav_column_3] |
| [social_icons] [legal_links] [copyright] |
+============================================================+
```
**Section Notes:**
- {observation about homepage structure}
- {observation about CTA placement}
---
## {Template Name}: {Template Description}
**Representative URLs:**
- {url_1}
- {url_2}
- {url_3}
**Template:** {template_name}
**Purpose:** {description of page purpose}
**User Goal:** {primary action user should take}
**Dominant Sections:** {comma-separated section list}
```
+============================================================+
|| {template_name} ||
+============================================================+
| HEADER |
| [logo] [nav] [search] [CTA] |
+------------------------------------------------------------+
| {section_1} |
| {content description} |
+------------------------------------------------------------+
| {section_2} |
| {content description} |
+------------------------------------------------------------+
| FOOTER |
| [links] [social] [legal] |
+============================================================+
```
**Section Notes:**
- {observation}
---
## Blog Post Template
**Representative URLs:**
- /blog/{example-post-slug}
- /blog/{another-post-slug}
**Template:** Blog Post
**Purpose:** Long-form content for thought leadership and SEO
**User Goal:** Read article, subscribe to newsletter, explore related content
**Dominant Sections:** header, breadcrumb, article, sidebar, cta, related, footer
```
+============================================================+
|| Blog Post ||
+============================================================+
| HEADER |
| [logo] [nav: Home Blog Products About] [search] |
+------------------------------------------------------------+
| NAV: BREADCRUMB |
| Home > Blog > {category} > {post_title} |
+----------------------------+-------------------------------+
| ARTICLE | SIDEBAR |
| | |
| [H1: {title}] | +-------------------------+ |
| [meta: {date} | {author}] | | AUTHOR | |
| [hero_image] | | [avatar] {name} | |
| | | {bio_snippet} | |
| {article_body} | +-------------------------+ |
| - paragraphs | |
| - subheadings (h2, h3) | +-------------------------+ |
| - images | | NEWSLETTER | |
| - code blocks | | [email] [Subscribe] | |
| - blockquotes | +-------------------------+ |
| | |
| [tags: {tag1} {tag2}] | +-------------------------+ |
| [share: social_buttons] | | CATEGORIES | |
| | | - {cat1} | |
+----------------------------+ | - {cat2} | |
| CTA +-------------------------+ |
| "{newsletter_headline}" | |
| [email_input] [Subscribe] | +-------------------------+ |
+----------------------------+ | RELATED POSTS | |
| RELATED | | - {post_title} | |
| +--------+ +--------+ +---| | - {post_title} | |
| | post_1 | | post_2 | | p | +-------------------------+ |
| +--------+ +--------+ +---+-------------------------------+
| FOOTER |
| [nav_columns] [social] [legal] [copyright] |
+============================================================+
```
**Section Notes:**
- Two-column layout with content and sidebar
- Author bio promotes credibility
- Related posts encourage continued engagement
---
## Documentation Template
**Representative URLs:**
- /docs/{section}/{page}
- /docs/getting-started
- /docs/api-reference/{endpoint}
**Template:** Documentation
**Purpose:** Technical reference and guides for product usage
**User Goal:** Find specific information, learn how to use feature, copy code examples
**Dominant Sections:** header, sidebar-nav, breadcrumb, content, toc, footer
+============================================================+
|| Documentation ||
+============================================================+
| HEADER |
| [logo] [product_nav] [search] [version_dropdown] |
+------------------+-----------------------------------------+
| SIDEBAR-NAV | CONTENT |
| | |
| {section_1} | NAV: BREADCRUMB |
| - {page} | Docs > {section} > {page} |
| - {page} | |
| - {page_active} | [H1: {page_title}] |
| | |
| {section_2} | {intro_paragraph} |
| - {page} | |
| - {page} | [H2: {section}] +----------+ |
| | {content} | TOC | |
| {section_3} | | - {h2} | |
| - {page} | | - {h2} | | | - {page} | {code_example} | - {h3} | | | | | - {h2} | |
| [collapse_all] | +----------+ |
| | [H2: {section}] |
| | {content} |
| | |
| | +-----------------------------------+ |
| | | NOTE/WARNING/TIP | |
| | | {callout_content} | |
| | +-----------------------------------+ |
| | |
| | [prev: {page}] [next: {page}] |
+------------------+-----------------------------------------+
| FOOTER |
| [edit_on_github] [feedback] [last_updated] |
+============================================================+
**Section Notes:**
- Three-column layout: sidebar nav, content, floating TOC
- Code blocks with syntax highlighting expected
- Prev/next navigation for sequential reading
---
## Listing/Index Template
**Representative URLs:**
- /blog
- /products
- /resources
- /docs
**Template:** Listing Page
**Purpose:** Browse and filter collection of items
**User Goal:** Find specific item, discover content, navigate to detail page
**Dominant Sections:** header, filters, grid, pagination, footer
```
+============================================================+
|| Listing Page ||
+============================================================+
| HEADER |
| [logo] [nav] [search] |
+------------------------------------------------------------+
| HERO (optional) |
| "{section_title}" |
| "{section_description}" |
+------------------------------------------------------------+
| FILTERS |
| [category_dropdown] [sort_dropdown] [search_input] |
+------------------------------------------------------------+
| GRID |
| +------------+ +------------+ +------------+ |
| | [image] | | [image] | | [image] | |
| | {title} | | {title} | | {title} | |
| | {excerpt} | | {excerpt} | | {excerpt} | |
| | [tag] [tag]| | [tag] [tag]| | [tag] [tag]| |
| +------------+ +------------+ +------------+ |
| |
| +------------+ +------------+ +------------+ |
| | [image] | | [image] | | [image] | |
| | {title} | | {title} | | {title} | |
| | {excerpt} | | {excerpt} | | {excerpt} | |
| +------------+ +------------+ +------------+ |
+------------------------------------------------------------+
| PAGINATION |
| [<] [1] [2] [3] [...] [10] [>] |
+------------------------------------------------------------+
| FOOTER |
| [links] [social] [legal] |
+============================================================+
```
**Section Notes:**
- Card grid is typically 3-4 columns on desktop
- Filters may be sidebar on content-heavy sites
---
## Pricing Template
**Representative URLs:**
- /pricing
**Template:** Pricing Page
**Purpose:** Present pricing options and drive conversion
**User Goal:** Compare plans, understand value, choose and purchase
**Dominant Sections:** header, hero, pricing-table, features, faq, cta, footer
```
+============================================================+
|| Pricing Page ||
+============================================================+
| HEADER |
| [logo] [nav] [CTA: Start Free] |
+------------------------------------------------------------+
| HERO |
| "{pricing_headline}" |
| "{pricing_subheadline}" |
| [toggle: Monthly / Annual] |
+------------------------------------------------------------+
| PRICING-TABLE |
| +---------------+ +---------------+ +---------------+ |
| | BASIC | | PRO | | ENTERPRISE | |
| | $X/mo | | $Y/mo | | Custom | |
| | | | [POPULAR] | | | |
| | - feature | | - feature | | - feature | |
| | - feature | | - feature | | - feature | |
| | - feature | | - feature | | - feature | |
| | | | - feature | | - feature | |
| | | | - feature | | - feature | |
| | | | | | - feature | |
| | [Get Started] | | [Get Started] | | [Contact] | |
| +---------------+ +---------------+ +---------------+ |
+------------------------------------------------------------+
| FEATURES (comparison table) |
| | Feature | Basic | Pro | Enterprise | |
| |------------------|-------|-----|------------| |
| | {feature_1} | [x] | [x] | [x] | |
| | {feature_2} | [ ] | [x] | [x] | |
| | {feature_3} | [ ] | [ ] | [x] | |
+------------------------------------------------------------+
| FAQ |
| [+] {question_1} |
| {answer_1} |
| [+] {question_2} |
| [+] {question_3} |
+------------------------------------------------------------+
| CTA |
| "{closing_headline}" |
| [Start Free Trial] |
+------------------------------------------------------------+
| FOOTER |
| [links] [social] [legal] |
+============================================================+
```
**Section Notes:**
- Middle plan often highlighted as "Popular" or "Recommended"
- Annual pricing toggle common for SaaS
---
## Contact/Form Template
**Representative URLs:**
- /contact
- /get-in-touch
- /demo
**Template:** Contact Page
**Purpose:** Capture leads or enable communication
**User Goal:** Submit inquiry, request demo, get support
**Dominant Sections:** header, hero, form, contact-info, footer
```
+============================================================+
|| Contact Page ||
+============================================================+
| HEADER |
| [logo] [nav] |
+------------------------------------------------------------+
| HERO |
| "{contact_headline}" |
| "{contact_subheadline}" |
+---------------------------+--------------------------------+
| FORM | CONTACT-INFO |
| | |
| [Name ] | EMAIL |
| [Email ] | {email_address} |
| [Company ] | |
| [Phone ] | PHONE |
| [Subject dropdown] | {phone_number} |
| [Message ] | |
| [ ] | ADDRESS |
| [ ] | {street} |
| | {city, state, zip} |
| [checkbox] Privacy | |
| | HOURS |
| [Submit] | {business_hours} |
| | |
+---------------------------+--------------------------------+
| MAP (optional) |
| [embedded_map] |
+------------------------------------------------------------+
| FOOTER |
| [links] [social] [legal] |
+============================================================+
```
**Section Notes:**
- Form fields vary by purpose (demo vs support vs general)
- Privacy checkbox increasingly required for GDPR
---
## Additional Template: {Name}
{Repeat the template structure for any additional unique templates discovered}
---
## Template Coverage Summary
| Template | Pages Using | Percentage |
| ------------ | ----------- | ---------- |
| Homepage | 1 | {%}% |
| {template} | {n} | {%}% |
| {template} | {n} | {%}% |
| {template} | {n} | {%}% |
| Unclassified | {n} | {%}% |
---
_Diagrams generated by Website Intelligence Skill_
This newer format provides hierarchical component trees with inline styling and motion annotations. Preferred for AI implementation and designer handoff.
# Page Structure: {domain}
> Generated: {date} | Format: V2 Tree-Style | Confidence: {High|Medium|Low}
---
## About This Document
| | |
|---|---|
| **Target Audience** | Humans (designers, developers) and AI agents |
| **Purpose** | Visual blueprint showing component hierarchy, nesting, and motion patterns for each template |
| **Use Case** | Understanding "what's inside what" at a glance; quick reference for structure and animations |
| **Related Files** | `site-map-report.md` (site overview), `component-specs/*.yaml` (machine-readable specs), `agent-handoff.md` (build prompts) |
---
## Annotation Legend
| Symbol | Meaning |
|--------|---------|
| `[classes]` | Observed/inferred Tailwind-style classes |
| `✦` | Animation/motion behavior |
| `├─` `└─` | Container nesting hierarchy |
| `───` | Section divider |
| `theme-dark` | Data attribute for theme switching |
---
## Global Tech Stack
| Layer | Technology |
|-------|------------|
| Framework | {framework} |
| Styling | {styling} |
| Animation | {animation_library} |
| Smooth Scroll | {scroll_library} |
| CMS | {cms} |
---
## Template 1: {Template Name}
**URL:** {full_url}
**Observed Tech:** {framework}, {styling}, {animation_library}, {scroll_library}
### Section Tree
{For each major section, use tree notation with annotations}
HERO [h-[150vh], relative, overflow-hidden]
├─ BG-IMAGE [absolute, inset-0, object-cover, z-0]
│ └─ parallax-scroll (GSAP ScrollTrigger)
├─ OVERLAY [absolute, inset-0, bg-gradient-to-b from-black/50]
└─ CONTENT [relative, z-10, pt-80, grid-container]
└─ (empty on scroll-in, typography animation at bottom)
PROJECT-NAME [absolute, bottom-0, overflow-hidden]
└─ TEXT "{title}" [text-[350px], font-bold, text-fg/40]
└─ ✦ letter-by-letter reveal on scroll (translateY 110%→0)
─────────────────────────────────────────────────────────────
OVERVIEW [pt-128, pb-128, bg-bg-primary, grid-layout]
├─ LEFT-COL [col-span-3, flex-col, justify-between]
│ ├─ TITLE "{title}" [text-h1]
│ │ └─ ✦ brand-rect wipe animation
│ ├─ LINK "{link_text}" [hover:translate-x-24]
│ │ └─ ✦ square icon rotation on hover (-90°→0°)
│ └─ META-LIST [border-t dividers]
│ ├─ "Timeline: {value}"
│ ├─ "Category: {value}"
│ ├─ "Techstack: {value}"
│ ├─ "Location: {value}"
│ └─ "Year: {value}"
│
└─ RIGHT-COL [col-span-5, col-start-7]
├─ TAGLINE "{tagline}" [text-h3]
├─ DIVIDER [border-t, my-64]
└─ PROSE [text-body]
└─ ✦ line-by-line reveal (split-line-mask)
─────────────────────────────────────────────────────────────
{Continue for each section...}
---
### Annotation Legend
| Symbol | Meaning |
| ------------ | ---------------------------------------- |
| `[classes]` | Observed/inferred Tailwind-style classes |
| `✦` | Animation/motion behavior |
| `├─` `└─` | Container nesting hierarchy |
| `───` | Section divider |
| `theme-dark` | Data attribute for theme switching |
| `(note)` | Implementation note or empty state |
---
### Observed Motion Patterns
| Pattern | Description | Trigger |
| ----------------- | ----------------------------------- | ------- |
| text-scramble | Characters randomize then resolve | on-load |
| brand-rect-wipe | Colored rectangle wipes across text | in-view |
| split-line-reveal | Each line slides up from below | in-view |
| parallax-scroll | Background moves at slower rate | scroll |
| letter-reveal | Letters animate in sequentially | scroll |
---
### Design Tokens (Extracted)
**Colors:**
- brand: {hex}
- background: {hex}
- foreground: {hex}
- foreground-muted: {rgba}
**Typography:**
- h1: {clamp_value}
- h2: {clamp_value}
- h3: {clamp_value}
- body: {size}
**Spacing:**
- section-gap: {responsive_value}
- grid-gap: {value}
---
_Structure analysis by Website Intelligence Skill V2_
Container Hierarchy:
PARENT [container-classes]
├─ CHILD-1 [child-classes]
│ └─ NESTED [nested-classes]
├─ CHILD-2 [child-classes]
└─ CHILD-3 [child-classes]
Motion Annotation:
ELEMENT [classes]
└─ ✦ {motion-type} ({trigger}: {transform})
Grid/Column Layout:
CONTAINER [grid-cols-12, gap-16]
├─ COL-LEFT [col-span-4]
│ └─ CONTENT
└─ COL-RIGHT [col-span-8]
└─ CONTENT
+=====+ Double line: Page container
+-----+ Single line: Section container
| | Vertical lines: Section boundaries
[element] Clickable element (button, link)
[CTA: text] Call-to-action button with label
[nav: item item] Navigation with items listed
[icon] Icon placeholder
"Text in quotes" Headline or display text
{variable} Dynamic/variable content
{description} Description of content type
Two columns:
+------------------+------------------+
| Column 1 | Column 2 |
+------------------+------------------+
Three columns:
+------------+------------+------------+
| Col 1 | Col 2 | Col 3 |
+------------+------------+------------+
Cards/Grid:
+--------+ +--------+ +--------+
| card 1 | | card 2 | | card 3 |
+--------+ +--------+ +--------+
Nested sections:
+----------------------------------------+
| OUTER SECTION |
| +----------------------------------+ |
| | INNER SECTION | |
| +----------------------------------+ |
+----------------------------------------+
Important: Use light fills with explicit text colors to ensure visibility in both light and dark mode (e.g., Obsidian, VS Code dark themes).
%% Class definitions for accessible colors
classDef root fill:#CDFE00,stroke:#141314,color:#141314,stroke-width:2px
classDef nav fill:#f5f5f5,stroke:#666,color:#141314
classDef content fill:#ffffff,stroke:#999,color:#141314
classDef utility fill:#e5e5e5,stroke:#666,color:#141314,stroke-dasharray:3
Avoid: Dark fills like fill:#333 or fill:#5E6AD2 which make text invisible in dark mode.
graph TD
A["domain.com"]:::root --> B["/section1"]:::nav
A --> C["/section2"]:::nav
A --> D["/section3"]:::nav
B --> B1["/section1/page1"]:::content
B --> B2["/section1/page2"]:::content
C --> C1["/section2/page1"]:::content
classDef root fill:#CDFE00,stroke:#141314,color:#141314,stroke-width:2px
classDef nav fill:#f5f5f5,stroke:#666,color:#141314
classDef content fill:#ffffff,stroke:#999,color:#141314
pie title Page Templates
"Homepage" : 1
"Blog Post" : 45
"Documentation" : 30
"Landing Page" : 10
"Other" : 14
graph LR
A[Homepage] --> B[Product Page]
A --> C[Pricing]
B --> C
C --> D[Signup]
B --> D
This file provides ready-to-use prompt templates for handing off to AI agents to build wireframes, code, or designs.
# Agent Handoff: {domain}
> Generated: {date} | Website Intelligence Skill V2
---
## About This Document
| | |
|---|---|
| **Target Audience** | AI agents (Claude, GPT, etc.) |
| **Purpose** | Ready-to-use prompt templates for building wireframes, code, or designs from the intelligence files |
| **Use Case** | Copy a prompt below, fill in the file paths, and hand off to an AI agent |
| **Related Files** | `site-map-report.md`, `page-structure.md`, `component-specs/*.yaml` |
---
## Quick Start
1. Choose a prompt template below based on your goal
2. Replace the `{{FILE_PATH}}` placeholders with absolute paths to your files
3. Copy the entire prompt and paste it into your AI agent
4. Attach/upload the referenced files if your agent supports file uploads
---
## File Paths (Fill These In)
```
SITE_MAP_REPORT: {{PASTE_ABSOLUTE_PATH_HERE}}
PAGE_STRUCTURE: {{PASTE_ABSOLUTE_PATH_HERE}}
COMPONENT_SPEC: {{PASTE_ABSOLUTE_PATH_HERE}}
```
**Example:**
```
SITE_MAP_REPORT: /path/to/your/output/site-map-report.md
PAGE_STRUCTURE: /path/to/your/output/page-structure.md
COMPONENT_SPEC: /path/to/your/output/component-specs/homepage.yaml
```
---
## Prompt Templates
### Template 1: Generate Figma Wireframe Structure
```markdown
# Task: Generate Figma Wireframe
## Context
I have website intelligence files from analyzing a reference site. I want you to help me create a wireframe structure in Figma based on these specs.
## Reference Files
- Site Overview: {{SITE_MAP_REPORT}}
- Component Hierarchy: {{PAGE_STRUCTURE}}
- Implementation Spec: {{COMPONENT_SPEC}}
## Instructions
1. **Read the component spec YAML first** - this has the exact structure
2. **Create frames for each section** listed in the `sections:` array
3. **Use the layout grid** specified (typically 12-column, 1280px max)
4. **For each section:**
- Create a frame with the specified height
- Add placeholder rectangles for each layer/column
- Label elements with their `id` from the spec
- Add text annotations for motion patterns (prefix with "Motion: ")
5. **Apply design tokens:**
- Background colors from `design_tokens.colors`
- Use the typography scale from `design_tokens.typography.sizes`
## Template to Build
{{SPECIFY_TEMPLATE: homepage | case-study | pricing}}
## Start with section:
{{SPECIFY_SECTION: hero | all}}
```
---
### Template 2: Generate React/Next.js Components
```markdown
# Task: Generate Next.js Page Component
## Context
I have website intelligence files from analyzing a reference site. Generate a Next.js page component that matches this structure.
## Reference Files
- Site Overview: {{SITE_MAP_REPORT}}
- Component Hierarchy: {{PAGE_STRUCTURE}}
- Implementation Spec: {{COMPONENT_SPEC}}
## Tech Stack (from analysis)
- Framework: Next.js (App Router)
- Styling: Tailwind CSS
- Animation: GSAP + ScrollTrigger
- Smooth Scroll: Lenis
## Instructions
1. **Read the YAML spec** - follow the `sections` array order exactly
2. **Generate a page component** with all sections as separate components
3. **Apply Tailwind classes** from the `style` properties in the spec
4. **Implement motion patterns** from `motion_patterns` using GSAP
5. **Use design tokens** - create CSS variables or Tailwind config from `design_tokens`
6. **Add data placeholders** matching the `data_schema` if present
## Output Format
- Single page component file
- Separate component files for reusable sections
- Include GSAP animation hooks
- TypeScript preferred
## Template to Build
{{SPECIFY_TEMPLATE: homepage | case-study | pricing}}
```
---
### Template 3: Generate HTML/CSS Prototype
```markdown
# Task: Generate HTML/CSS Prototype
## Context
I have website intelligence files from analyzing a reference site. Generate a static HTML/CSS prototype.
## Reference Files
- Component Hierarchy: {{PAGE_STRUCTURE}}
- Implementation Spec: {{COMPONENT_SPEC}}
## Instructions
1. **Generate semantic HTML** following the tree structure in page-structure.md
2. **Use inline Tailwind classes** or generate a CSS file
3. **Include CSS custom properties** for the design tokens
4. **Add comments** marking where animations would be implemented
5. **Make it responsive** using the breakpoints from the spec
## Template to Build
{{SPECIFY_TEMPLATE: homepage | case-study | pricing}}
```
---
### Template 4: Design System Extraction
```markdown
# Task: Extract Design System
## Context
I have website intelligence files. Extract a reusable design system.
## Reference Files
- Implementation Spec: {{COMPONENT_SPEC}}
## Instructions
Extract and organize:
1. **Color Tokens** - Primary, secondary, background, foreground
2. **Typography Scale** - Font families, sizes, line heights
3. **Spacing System** - Section padding, grid gaps, container widths
4. **Motion Patterns** - Document each animation pattern
5. **Component Patterns** - Button styles, card patterns, link styles
## Output Format
{{SPECIFY: tailwind-config | css-variables | design-tokens-json | all}}
```
---
### Template 5: Section-by-Section Build
```markdown
# Task: Build Single Section
## Context
I'm building a website section-by-section based on analyzed specs.
## Reference Files
- Component Hierarchy: {{PAGE_STRUCTURE}}
- Implementation Spec: {{COMPONENT_SPEC}}
## Current Section
{{SPECIFY_SECTION_ID: hero | overview | pricing-cards | etc}}
## Instructions
1. **Find this section** in the YAML spec under `sections:`
2. **Build exactly what's specified:**
- Layout (columns, spans, positioning)
- Content elements (headings, text, buttons)
- Motion pattern (reference `motion_patterns` section)
3. **Use the design tokens** for colors, typography, spacing
4. **Handle responsive behavior** from the `responsive` section
## Previous Sections Completed
{{LIST_COMPLETED_SECTIONS}}
```
---
## Tips for Best Results
1. **Always start with the YAML spec** - it's the most precise
2. **Use page-structure.md for visual reference** when the hierarchy is unclear
3. **Reference site-map-report.md** for overall context and tech stack
4. **Be specific about output format** (React, HTML, Figma, etc.)
5. **Build incrementally** - one section at a time produces better results
---
## Example: Complete Handoff
Here's a filled-out example ready to copy:
```markdown
# Task: Generate Next.js Page Component
## Context
I have website intelligence files from analyzing {domain}. Generate a Next.js page component that matches the {template_name} template.
## Reference Files
- Site Overview: /path/to/your/output/site-map-report.md
- Component Hierarchy: /path/to/your/output/page-structure.md
- Implementation Spec: /path/to/your/output/component-specs/{template}.yaml
## Tech Stack
- Framework: Next.js 14 (App Router)
- Styling: Tailwind CSS v3
- Animation: GSAP 3 + ScrollTrigger
- Smooth Scroll: Lenis
## Instructions
1. Read the {template}.yaml spec and follow the sections array exactly
2. Generate a page component at the appropriate route
3. Create separate components for each major section
4. Implement the motion patterns using GSAP
5. Use the design tokens to create a tailwind.config.js extension
6. Add TypeScript interfaces for the data
## Focus Area
Full page - all sections
## Output
Provide the complete implementation with all files.
```
---
_Generated by Website Intelligence Skill V2_
For YAML component spec files, include this header comment:
# =============================================================================
# {TEMPLATE_NAME} COMPONENT SPEC - {domain}
# =============================================================================
#
# TARGET AUDIENCE: AI agents, developers
# PURPOSE: Machine-readable spec with exact layout, sections, motion
# patterns, and design tokens for implementation
# USE CASE: Feed to AI agent to generate code, wireframes, or Figma designs
# RELATED FILES: site-map-report.md, page-structure.md, agent-handoff.md
#
# =============================================================================
When generating reports in Quick Mode, include these modifications:
Add confidence caveat in header:
Note: This analysis used Web Search reconnaissance. Structural details are inferred from content rather than DOM inspection.
Reduce template family detail (content-based inference only)
Mark uncertain sections with:
Inferred from content patterns
Simplify internal linking section (no full link graph)
Add to Limitations section:
Generate diagrams only for homepage and 2-3 major templates
Use simpler section detection (content-based)
Add note:
Diagrams based on content analysis. Actual page structure may vary.
Mark uncertain sections with {?}:
| {?} FEATURES (inferred) |