PTENES
MODULE 4.4 · LAST MODULE

🔭 website-intelligence

Competitive intelligence engine: scrapes the client's site, analyzes the top 5 competitors via Firecrawl MCP, produces a PDF-ready HTML report, and builds a premium scroll-animated site informed by real market data.

6
Topics
35
Minutes
Practical
Level
Support
Category
🔭 CLIENT mcp__firecrawl__scrape mcp__firecrawl__map REPORT competitive-analysis .html (PDF-ready) Instrument Serif Top 5 competitors C1 C2 C3 C4 C5 PREMIUM SITE scroll-animated Apple/Stripe quality Powered by Firecrawl MCP · 6 Phases · PDF-Ready Report
1

🧩 What it is / what it does

Research-driven competitive intelligence engine for websites — scraping, analysis, reporting, and development across 6 connected phases, all based on real market data.

Precise definition (SKILL.md)

O website-intelligence is a senior web strategy skill that works in 6 sequential phases: client brand extraction → competitive niche analysis → HTML report, PDF-ready → build brief → website construction → quality audit. Everything is saved to deliverable files at each phase.

Actual skill stack
Scraping
mcp__firecrawl__scrape — single page
mcp__firecrawl__map — complete domain architecture
mcp__firecrawl__search — competitor discovery
Report
Print-ready HTML + CSS (@media print)
Instrument Serif + DM Sans
Terracotta palette #c45d3e
Final site
Scroll-triggered animations
Parallax depth
Apple/Stripe quality
Generated output structure
# Project Directory After the 6 Phases
project/
research/
01-client-brand.md # Brand Extraction
02-competitor-analysis.md # Niche Research
03-build-brief.md # Master Document
04-quality-audit.md # Final Audit
competitive-analysis.html # PDF-Ready Report
site/ # Premium Site Built
Key Concepts
Firecrawl MCP
scrape · map · search
6 phases
sequential + checkpoint
PDF-Ready
HTML with @media print
Data-Driven
evidence-based site
2

🎣 When it triggers

The exact triggers that make Claude Code activate website-intelligence — keywords, contexts, and request intentions.

💡
Triggers are keywords in the description

Claude Code reads the skill description and triggers it when it detects any of the terms listed below in the user's request. You don't need to say the skill's name.

✓ Triggers with
  • ✓"website intelligence"
  • ✓"build a site" / "build a website"
  • ✓"redesign" / "website for [business]"
  • ✓"scrape and rebuild"
  • ✓"competitive analysis"
  • ✓"niche research" / "website audit"
✗ Does not trigger with
  • ✗"create a simple landing page"
  • ✗"make a React component"
  • ✗"generate a system diagram"
  • ✗"create a 3D animation"
  • ✗"make an email marketing campaign"
  • ✗tasks without real business context
6-phase pipeline (required order)
1
Client Brand Extraction
scrape of the current site, URL architecture, brand identity
2
Competitive Niche Analysis
search and scraping of the top 5 competitors, scoring across 8 criteria
3
Competitive Analysis Report
PDF-ready HTML: executive summary, profiles, comparison table, top 10% patterns
4
Build Brief & Approval ⛔ HARD STOP
design direction, site architecture, content framework — approval required before building
5
Build the Website
HTML/CSS/JS with scroll animations, placeholder 3D asset, premium micro-interactions
6
Quality Audit
SEO, accessibility, performance, client-ready checklist
Key Concepts
Verbal trigger
"competitive analysis"
Hard Stop
approval before phase 5
Strict order
phases 1→6, without skipping
Deliverable
file for each phase
3

🚀 How it improves your results

Concrete value website-intelligence delivers compared with the traditional approach of building a website without market research.

The key differentiator

Sites built on real competitive research have informed positioning: you know what competitors do well, where the SEO gaps are, which patterns the top 10% share—and you build above that bar, not alongside it.

✓ What the skill delivers
  • ✓PDF report with competitor scoring (8 criteria)
  • ✓Color palette and typography justified by data
  • ✓SEO opportunities and keyword gaps identified
  • ✓Site with Apple/Stripe-quality scroll animations
  • ✓Placeholder marked for 3D asset (<!-- 3D SCROLL ASSET HERE -->)
✗ Without this skill
  • ✗Beautiful site with no market differentiation
  • ✗Colors and typography based on taste, not positioning
  • ✗Generic SEO, without competitive gap insights
  • ✗Decorative animations without a conversion hierarchy
  • ✗No deliverable to present to the client
⚠️
Performance Targets (SKILL.md)

The generated site should achieve LCP < 2.5s, TBT < 200ms, CLS < 0.1. No render-blocking JavaScript. Images with lazy loading and explicit dimensions.

Key Concepts
8 criteria
objective competitor scoring
SEO gap
unmastered keywords
Top 10%
patterns from the best websites
LCP < 2.5s
mandatory performance
4

⚙️ How it works under the hood

Actual stack, MCP tools, phase-based approach, and implementation decisions from SKILL.md.

🔥
Firecrawl MCP: required dependency

Before starting any phase, the skill checks whether the Firecrawl MCP is connected. If it isn't, it provides setup instructions (claude mcp add firecrawl). Without Firecrawl, phases 1 and 2 are blocked.

1 Phase 1 — Client Brand Extraction

mcp__firecrawl__map — discovers all URLs on the client's domain

mcp__firecrawl__scrape — scrapes the main pages (home, about, services)

Saves research/01-client-brand.md with: colors, typography, voice, value proposition, nav structure

2 Phase 2 — Competitive Niche Analysis

mcp__firecrawl__search — finds the top 5 competitors in the niche

mcp__firecrawl__scrape — deep scraping of each competitor

Scoring across 8 criteria: design, UX, SEO, performance, copy, CTA, social proof, mobile

Saves research/02-competitor-analysis.md

3 Phase 3 — PDF-Ready HTML Report

Static HTML without JavaScript — pure HTML + CSS with @media print

Design: warm paper #f6f4f0, terracotta #c45d3e, grain overlay via SVG filter

Cards with 4px accent borders, phases with dashed SVG connectors

Saves competitive-analysis.html in the project root

4 Phase 4 — Build Brief + HARD STOP

Define: Design Direction · Site Architecture · Content Framework · Conversion Playbook

Mandatory HARD STOP — does not proceed to phase 5 without the user’s explicit approval

Saves research/03-build-brief.md

5 Phase 5 — Build the Website

Scroll-triggered animations at every section transition + parallax depth

Hero with marked placeholder: <!-- 3D SCROLL ASSET HERE --> with exact dimensions

Premium microinteractions: buttons, cards, nav

Structure: site/ with index.html, css/, js/, assets/

6 Phase 6 — Quality Audit

SEO audit: meta tags, schema markup, heading hierarchy, sitemaps

Accessibility audit: contrast, alt text, ARIA labels, keyboard navigation

Performance audit: LCP, TBT, CLS, render-blocking JS, lazy loading

Saves research/04-quality-audit.md

Key Concepts
allowed-tools
Read Write Grep Glob Bash WebFetch
@media print
report without JavaScript
3D placeholder
hero with annotated asset
No JS in the report
Pure HTML, PDF-friendly
5

💬 Practical example + Ready-to-use prompt

Real prompt to paste into Claude Code and activate the skill immediately — along with what to expect at each stage.

💡
Use the prompt below in Claude Code

Replace the URL and niche. The skill detects "competitive analysis" and "build a site" and starts automatically. You’ll receive deliverables at each phase before approving the next one.

Full prompt (copy and paste into Claude Code)
# website-intelligence — activation prompt
I want to do a competitive analysis and build a premium site for:

Business: "Lumina" Advanced Aesthetics Clinic
Current URL: https://luminaestetica.com.br
Niche: premium facial aesthetics, São Paulo, SP

# Scope Instruction
Run all 6 phases of website intelligence.
Save research deliverables in research/.
Stop at Phase 4 for my approval before building.
The final site should have Apple/Stripe quality with scroll animations.

# Firecrawl Configuration (if needed)
Check that the Firecrawl MCP is connected before starting.
What happens after the prompt
→ Phase 1-2: Claude scrapes the site and finds the 5 competitors. This may take 2-5 min (many requests).
→ Phase 3: You receive competitive-analysis.html — open it in the browser and print it as a PDF.
→ Phase 4 (STOP): Claude presents the build brief and waits for your approval. Review the design direction.
→ Phase 5-6: After "approved," builds site/index.html + final audit.
Key Concepts
URL + niche
minimum necessary context
Phase 4 Approval
review before building
Immediate deliverable
competitive-analysis.html
6

🧬 Works well with / limitations

website-intelligence is the skill that completes the course: competitive research → builds the best site. To go beyond the site, combine it with skills from the previous tracks.

🎓 The course’s final link

This is the final module in Skill Design because it represents the complete cycle: you learned to build interfaces (T1), create visual identity (T2), produce media (T3) and use support (T4) tools. website-intelligence uses all of these — and also adds the market intelligence that sets a good site apart from an unbeatable one.

Each skill you master throughout the course becomes a plugin to elevate website-intelligence's output.
Integrations with course skills
⚛️
T1.1 frontend-design → refinement of the generated site

After website-intelligence delivers the site/index.html, trigger frontend-design to polish the React/Tailwind/shadcn code, add advanced responsive components, and ensure AA-level accessibility. The website-intelligence site defines what build — frontend-design defines how build with excellent code quality.

✨
T1.2 impeccable → quality audit of the final site

After Phase 6 (Quality Audit), run impeccable for a second verification layer: color contrast, typographic hierarchy, CTA microcopy, visual consistency across sections. impeccable complements website-intelligence's technical audit with a design audit.

🖱️
T3.2 3d-animation-creator → fills in the hero placeholder

website-intelligence leaves an explicit placeholder in the hero: <!-- 3D SCROLL ASSET HERE --> with exact dimensions. The 3d-animation-creator was made exactly for this: it generates the interactive, scroll-triggered 3D asset that goes in that slot. This integration is the most direct—the website-intelligence reserves the space, and the 3d-animation-creator fills it masterfully.

✗ When NOT to use website-intelligence
✗Rapid prototypes or disposable landing pages (use web-artifacts-builder or canvas-design)
✗When Firecrawl MCP isn’t available — phases 1 and 2 are blocked
✗Internal projects with no real market competitors to analyze
✗When the client has no existing URL to scrape for brand details
✗Complex web apps with auth, database, and backend (use frontend-design directly)
✗When speed is critical — the 6 phases require real research time
Key Concepts
frontend-design
code polish
impeccable
design audit
3d-animation-creator
fills in 3D scroll hero
Requires Firecrawl
critical dependency
🎓

You completed Skill Design!

You completed all 4 tracks—Build, Identity, Media, and Support—and reached the module that closes the loop: market intelligence in service of design. You now know how to research, analyze, plan, and build websites that stand out using real data.

✓ What you learned in this module

✓What website-intelligence is and its precise definition in SKILL.md
✓The 7 verbal triggers that activate the skill ("competitive analysis", "build a site", etc.)
✓The 6 phases in order: extraction → analysis → report → brief → build → audit
✓The 3 Firecrawl MCP tools: scrape, map, search
✓The PDF-ready report: HTML + @media print, no JavaScript
✓The mandatory HARD STOP in Phase 4 before building
✓The 3D placeholder in the hero: a slot for 3d-animation-creator
✓How to combine it with frontend-design, impeccable, and 3d-animation-creator
🔁 Back to the beginning

Now that you know all 16 skills in the course, go back to the beginning and reread the modules with fresh eyes. A second read always reveals connections you didn’t see the first time—especially how the skills across the 4 tracks fit together in a complete design workflow with Claude Code.