Icp website audit

End-to-end website audit through ICP eyes.

How to use it

  1. Hit Copy SKILL.md — or use the Claude Code line below to get every file.
  2. Claude: ⋯ → Download .md, then Customize → Skills → Add → Upload skill.
    ChatGPT: make a Project and paste it into Instructions.
    Neither? Paste it at the top of a new chat — it works for that chat.
  3. Describe your job in plain words. The AI follows the skill from there.
Claude Code — installs the whole folder, not just SKILL.md
npx degit gooseworks-ai/goose-skills/skills/lead-generation/composites/icp-website-audit#main ~/.claude/skills/icp-website-audit

For one project only, change the path to .claude/skills/icp-website-audit. This skill also uses icp-website-audit.md, -scorecard.md — copying SKILL.md alone won't be enough. See the folder on GitHub.

Not working?
  • Check which app you pasted it into — the steps above name the right one.
  • Some skills need the paid tier of Claude or ChatGPT.
Step-by-step guide with screenshots · Ask in the forum

Paste into Claude, ChatGPT or Cursor.

Show the full text365 lines
icp-website-audit/SKILL.md365 lines11.1 KBpushed 96d agoRawView on GitHub

ICP Website Audit

The complete "how do buyers experience our site vs the competition?" workflow. Chains persona building, website evaluation, and competitive comparison into a single end-to-end audit.

Quick Start

Run an ICP website audit for [company]. Site: [url]. Compare against [competitor 1] and [competitor 2].

With existing personas:

Run an ICP website audit for [client]. Personas already exist. Compare against [competitor urls].

Inputs

Input Required Source
Company name Yes User provides
Company URL Yes User provides
Competitor URLs Yes (1-3) User provides, or discovered in Phase 1
Client context file Optional clients/<client>/context.md
Existing personas Optional clients/<client>/personas/personas.json

Step-by-Step Process

Phase 1: Persona Setup

Check if personas already exist:

clients/<client>/personas/personas.json

If personas exist: Load them, confirm they look current, and list them for the user. Skip to Phase 2.

If no personas exist: Run buyer-persona-generator:

  1. Research the company — what they sell, who they serve, pricing model, stage
  2. Identify 4-6 ICP segments from website, case studies, reviews, job postings
  3. Build detailed synthetic personas with full profiles
  4. Save to clients/<client>/personas/

Output from this phase:

  • clients/<client>/personas/personas.json (machine-readable)
  • clients/<client>/personas/personas.md (human-readable)
  • clients/<client>/personas/segments.md (summary table)

Phase 2: Website Scorecard Review

Run icp-website-audit in scorecard mode against the client's own site.

  1. Crawl the client's site — homepage, pricing, product, solutions, about, case studies, blog, docs
  2. Check external presence — search results, review sites, social proof
  3. Run each persona through the site, scoring on:
    • First Impression (1-10)
    • Messaging Relevance (1-10)
    • Trust & Credibility (1-10)
    • Clarity & Navigation (1-10)
    • Objection Handling (1-10)
    • Overall (1-10)
  4. Cross-persona synthesis — consensus issues, segment-specific gaps, messaging disconnects

Output from this phase:

  • Per-persona scored reviews
  • Cross-persona analysis
  • Initial recommendations

Phase 3: Competitive Head-to-Head

Run icp-website-audit in head-to-head mode against each competitor.

For each competitor (1-3):

  1. Crawl the competitor's site — same pages as the client site
  2. Run each persona through BOTH sites
  3. Per-persona comparison:
    • Quick takes on each site
    • Dimension-by-dimension scoring for both
    • "If I had to choose today..." verdict
    • What the client should steal from the competitor
    • What the client does better
  4. Cross-persona competitive summary:
    • Where the client wins across personas
    • Where the competitor wins across personas
    • At-risk segments (personas who lean toward competitor)
    • Priority competitive moves

Output from this phase:

  • Per-competitor, per-persona head-to-head reviews
  • Competitive positioning map
  • At-risk segments identified

Phase 4: Consolidated Report

Merge all findings into a single audit report. This is the deliverable.

Synthesis work:

  1. Combine scorecard + competitive findings — scorecard shows absolute quality, head-to-head shows relative positioning. Both perspectives matter.
  2. Identify the "so what" — what are the 3-5 moves that would make the biggest difference?
  3. Rank recommendations by:
    • How many personas it affects (breadth)
    • How much it would change conversion likelihood (depth)
    • Whether competitors already do it better (urgency)
    • Estimated effort (feasibility)
  4. Flag at-risk segments — ICPs where competitors are winning. These need immediate attention.

Output

Save to the current working directory as icp-website-audit.md (or user-specified path).

Also save the sub-reports to the current working directory:

  • personas/ (persona assets, reusable)
  • icp-reviews/<date>-scorecard.md (site review)
  • icp-reviews/<date>-head-to-head-<competitor>.md (per competitor)

Consolidated Report Template

# ICP Website Audit: [Company Name]

**Date:** [Date]
**Website:** [url]
**Competitors:** [competitor 1], [competitor 2], [competitor 3]
**Personas used:** [N] (from `clients/<client>/personas/`)

---

## Executive Summary

[5-7 sentences. How do buyers actually experience this site? What's working, what's
broken, where are competitors winning? Top 3 things to fix and why.]

### Scorecard Overview

**Average score across personas: [X/10]**

| Persona | Segment | Own Site Score | Would Convert? |
|---------|---------|:-:|:-:|
| [Name] | [Segment] | [X/10] | [Yes/Maybe/No] |
| ... | ... | ... | ... |

### Competitive Overview

| Persona | Own Site | [Comp 1] | [Comp 2] | Pick |
|---------|:-------:|:--------:|:--------:|:----:|
| [Name] | [X/10] | [X/10] | [X/10] | [Winner] |
| ... | ... | ... | ... | ... |

**Personas at risk:** [Names of personas who preferred a competitor — these represent ICP segments you may be losing]

---

## Part 1: ICP Segments & Personas

### Segments Identified

| # | Segment | Description | Priority |
|---|---------|-------------|----------|
| 1 | [Name] | [One line] | Primary |
| 2 | [Name] | [One line] | Primary |
| 3 | [Name] | [One line] | Secondary |
| ... | | | |

### Persona Summaries

[2-3 sentence summary of each persona — who they are, what they care about, how they evaluate. Link to full profiles in `personas/personas.md`.]

---

## Part 2: Website Scorecard

### Score Matrix

| Dimension | [P1] | [P2] | [P3] | [P4] | [P5] | Avg |
|-----------|:----:|:----:|:----:|:----:|:----:|:---:|
| First Impression | | | | | | |
| Messaging Relevance | | | | | | |
| Trust & Credibility | | | | | | |
| Clarity & Navigation | | | | | | |
| Objection Handling | | | | | | |
| **Overall** | | | | | | |

### Persona-by-Persona Highlights

For each persona, include:
- **[Persona Name]** ([Score]/10) — [One sentence summary]. Liked: [key positive]. Frustrated by: [key negative]. Blocker: [#1 thing stopping conversion].

### Cross-Persona Findings

#### Consensus Issues (All Personas)
1. [Issue] — [Why it matters]
2. ...

#### Segment-Specific Gaps
| Gap | Personas Affected | Impact |
|-----|------------------|--------|
| [Gap] | [Names] | [H/M/L] |

#### Messaging Disconnects
| Site says | Buyers say | Personas |
|-----------|-----------|----------|
| "[quote]" | "[quote]" | [Names] |

---

## Part 3: Competitive Analysis

### vs [Competitor 1]

**Overall: [Company wins / Competitor wins / Split]**

| Dimension | [Company] | [Competitor] | Winner |
|-----------|:---------:|:------------:|:------:|
| First Impression | [avg] | [avg] | |
| Messaging | [avg] | [avg] | |
| Trust | [avg] | [avg] | |
| Clarity | [avg] | [avg] | |
| Objections | [avg] | [avg] | |
| **Overall** | **[avg]** | **[avg]** | |

**Where competitor wins:**
- [Specific advantage, which personas care]

**Where we win:**
- [Specific advantage, which personas care]

**Personas who'd choose competitor:** [Names — these are at-risk segments]

---

### vs [Competitor 2]
[Same structure]

---

### Competitive Position Map

| Persona | Best Experience | Worst Experience | Notes |
|---------|:-:|:-:|---|
| [P1] | [Company/Comp] | [Company/Comp] | [Why] |
| [P2] | ... | ... | ... |

### At-Risk Segments

[Personas who preferred competitors. For each: which competitor, why, and what it would take to win them back.]

### Competitive Advantages to Amplify

[Things the company does better than ALL competitors — lean into these.]

### Gaps to Close

[Things competitors do better across most personas — neutralize these.]

---

## Part 4: Prioritized Recommendations

### Tier 1: High Impact, Do Now

These affect the most personas and/or address competitive gaps.

1. **[Recommendation]**
   - **Why:** [Evidence from scorecard + competitive analysis]
   - **Personas affected:** [Names]
   - **Competitive context:** [Do competitors already do this better?]
   - **Expected impact:** [What changes — conversion, trust, clarity]
   - **Effort:** [Low/Med/High]

2. **[Recommendation]**
   ...

### Tier 2: Medium Impact, Plan For

3. **[Recommendation]**
   ...

### Tier 3: Segment-Specific Optimizations

These improve experience for specific ICP segments.

5. **[Recommendation]** — For [persona/segment]
   ...

### Quick Wins

- [Small change] → Benefits [persona]
- [Small change] → Benefits [persona]

---

## Appendix

### A. Full Persona Profiles
→ `clients/<client>/personas/personas.md`

### B. Detailed Scorecard Review
→ `clients/<client>/icp-reviews/<date>-scorecard.md`

### C. Detailed Competitive Reviews
→ `clients/<client>/icp-reviews/<date>-head-to-head-<competitor>.md`

### D. Persona Data (JSON)
→ `clients/<client>/personas/personas.json`

Parallelization

Some phases can run in parallel to save time:

Phase 1: Build personas (if needed)
    ↓
Phase 2 + Phase 3 can partially overlap:
  - Crawl all sites (client + competitors) at once
  - Run scorecard first (client site only)
  - Then run head-to-heads (reuse client crawl data)
    ↓
Phase 4: Consolidate (needs all prior phases)

If personas already exist, the whole workflow is just:

Crawl all sites → Scorecard → Head-to-heads → Consolidate

Tips

  • Start with 1-2 competitors, not 5. Each competitor adds a full head-to-head evaluation pass. Start focused, add more if needed.
  • The at-risk segments are the most actionable finding. If a persona consistently prefers a competitor, that's an ICP segment you're actively losing deals in. That should drive urgency.
  • Reuse this quarterly. Run personas once, then re-run the audit after site changes or quarterly to track improvement. Compare scores across dates.
  • Combine with SEO content audit for the full picture. ICP audit tells you "does the messaging work for buyers?" SEO audit tells you "are buyers finding you in the first place?" Together they cover the full funnel.
  • This makes a great client deliverable. The consolidated report is structured for sharing. Use content-asset-creator to make it into a polished HTML report.
  • Don't skip the competitive analysis. The scorecard alone is useful, but the head-to-head is where the real insights are. Buyers always compare — your audit should too.

Dependencies

  • Skills: buyer-persona-generator, icp-website-audit
  • Web search capability (for research, external presence checks)
  • Web fetch capability (for reading website pages)
  • No API keys or paid tools required

Cost

Free — no paid APIs. All research and evaluation is done via web search and web fetch.

1---
2name: icp-website-audit
3description: >
4 End-to-end website audit through ICP eyes. Builds synthetic personas (if they don't
5 already exist), runs a structured scorecard review of the client's site, then runs
6 a head-to-head competitive comparison against top competitors. Produces a single
7 consolidated report with persona feedback, competitive positioning, and prioritized
8 recommendations. The complete "how do our buyers actually experience our site vs
9 the competition?" workflow.
10tags: [research]
11---
12 
13# ICP Website Audit
14 
15The complete "how do buyers experience our site vs the competition?" workflow. Chains persona building, website evaluation, and competitive comparison into a single end-to-end audit.
16 
17## Quick Start
18 
19```
20Run an ICP website audit for [company]. Site: [url]. Compare against [competitor 1] and [competitor 2].
21```
22 
23With existing personas:
24```
25Run an ICP website audit for [client]. Personas already exist. Compare against [competitor urls].
26```
27 
28## Inputs
29 
30| Input | Required | Source |
31|-------|----------|--------|
32| **Company name** | Yes | User provides |
33| **Company URL** | Yes | User provides |
34| **Competitor URLs** | Yes (1-3) | User provides, or discovered in Phase 1 |
35| **Client context file** | Optional | `clients/<client>/context.md` |
36| **Existing personas** | Optional | `clients/<client>/personas/personas.json` |
37 
38## Step-by-Step Process
39 
40### Phase 1: Persona Setup
41 
42**Check if personas already exist:**
43 
44```
45clients/<client>/personas/personas.json
46```
47 
48**If personas exist:** Load them, confirm they look current, and list them for the user. Skip to Phase 2.
49 
50**If no personas exist:** Run `buyer-persona-generator`:
51 
521. Research the company — what they sell, who they serve, pricing model, stage
532. Identify 4-6 ICP segments from website, case studies, reviews, job postings
543. Build detailed synthetic personas with full profiles
554. Save to `clients/<client>/personas/`
56 
57**Output from this phase:**
58- `clients/<client>/personas/personas.json` (machine-readable)
59- `clients/<client>/personas/personas.md` (human-readable)
60- `clients/<client>/personas/segments.md` (summary table)
61 
62### Phase 2: Website Scorecard Review
63 
64Run `icp-website-audit` in **scorecard mode** against the client's own site.
65 
661. **Crawl the client's site** — homepage, pricing, product, solutions, about, case studies, blog, docs
672. **Check external presence** — search results, review sites, social proof
683. **Run each persona through the site**, scoring on:
69 - First Impression (1-10)
70 - Messaging Relevance (1-10)
71 - Trust & Credibility (1-10)
72 - Clarity & Navigation (1-10)
73 - Objection Handling (1-10)
74 - Overall (1-10)
754. **Cross-persona synthesis** — consensus issues, segment-specific gaps, messaging disconnects
76 
77**Output from this phase:**
78- Per-persona scored reviews
79- Cross-persona analysis
80- Initial recommendations
81 
82### Phase 3: Competitive Head-to-Head
83 
84Run `icp-website-audit` in **head-to-head mode** against each competitor.
85 
86For each competitor (1-3):
87 
881. **Crawl the competitor's site** — same pages as the client site
892. **Run each persona through BOTH sites**
903. **Per-persona comparison:**
91 - Quick takes on each site
92 - Dimension-by-dimension scoring for both
93 - "If I had to choose today..." verdict
94 - What the client should steal from the competitor
95 - What the client does better
964. **Cross-persona competitive summary:**
97 - Where the client wins across personas
98 - Where the competitor wins across personas
99 - At-risk segments (personas who lean toward competitor)
100 - Priority competitive moves
101 
102**Output from this phase:**
103- Per-competitor, per-persona head-to-head reviews
104- Competitive positioning map
105- At-risk segments identified
106 
107### Phase 4: Consolidated Report
108 
109Merge all findings into a single audit report. This is the deliverable.
110 
111**Synthesis work:**
112 
1131. **Combine scorecard + competitive findings** — scorecard shows absolute quality, head-to-head shows relative positioning. Both perspectives matter.
1142. **Identify the "so what"** — what are the 3-5 moves that would make the biggest difference?
1153. **Rank recommendations by:**
116 - How many personas it affects (breadth)
117 - How much it would change conversion likelihood (depth)
118 - Whether competitors already do it better (urgency)
119 - Estimated effort (feasibility)
1204. **Flag at-risk segments** — ICPs where competitors are winning. These need immediate attention.
121 
122---
123 
124## Output
125 
126Save to the current working directory as `icp-website-audit.md` (or user-specified path).
127 
128Also save the sub-reports to the current working directory:
129- `personas/` (persona assets, reusable)
130- `icp-reviews/<date>-scorecard.md` (site review)
131- `icp-reviews/<date>-head-to-head-<competitor>.md` (per competitor)
132 
133### Consolidated Report Template
134 
135```markdown
136# ICP Website Audit: [Company Name]
137 
138**Date:** [Date]
139**Website:** [url]
140**Competitors:** [competitor 1], [competitor 2], [competitor 3]
141**Personas used:** [N] (from `clients/<client>/personas/`)
142 
143---
144 
145## Executive Summary
146 
147[5-7 sentences. How do buyers actually experience this site? What's working, what's
148broken, where are competitors winning? Top 3 things to fix and why.]
149 
150### Scorecard Overview
151 
152**Average score across personas: [X/10]**
153 
154| Persona | Segment | Own Site Score | Would Convert? |
155|---------|---------|:-:|:-:|
156| [Name] | [Segment] | [X/10] | [Yes/Maybe/No] |
157| ... | ... | ... | ... |
158 
159### Competitive Overview
160 
161| Persona | Own Site | [Comp 1] | [Comp 2] | Pick |
162|---------|:-------:|:--------:|:--------:|:----:|
163| [Name] | [X/10] | [X/10] | [X/10] | [Winner] |
164| ... | ... | ... | ... | ... |
165 
166**Personas at risk:** [Names of personas who preferred a competitor — these represent ICP segments you may be losing]
167 
168---
169 
170## Part 1: ICP Segments & Personas
171 
172### Segments Identified
173 
174| # | Segment | Description | Priority |
175|---|---------|-------------|----------|
176| 1 | [Name] | [One line] | Primary |
177| 2 | [Name] | [One line] | Primary |
178| 3 | [Name] | [One line] | Secondary |
179| ... | | | |
180 
181### Persona Summaries
182 
183[2-3 sentence summary of each persona — who they are, what they care about, how they evaluate. Link to full profiles in `personas/personas.md`.]
184 
185---
186 
187## Part 2: Website Scorecard
188 
189### Score Matrix
190 
191| Dimension | [P1] | [P2] | [P3] | [P4] | [P5] | Avg |
192|-----------|:----:|:----:|:----:|:----:|:----:|:---:|
193| First Impression | | | | | | |
194| Messaging Relevance | | | | | | |
195| Trust & Credibility | | | | | | |
196| Clarity & Navigation | | | | | | |
197| Objection Handling | | | | | | |
198| **Overall** | | | | | | |
199 
200### Persona-by-Persona Highlights
201 
202For each persona, include:
203- **[Persona Name]** ([Score]/10) — [One sentence summary]. Liked: [key positive]. Frustrated by: [key negative]. Blocker: [#1 thing stopping conversion].
204 
205### Cross-Persona Findings
206 
207#### Consensus Issues (All Personas)
2081. [Issue] — [Why it matters]
2092. ...
210 
211#### Segment-Specific Gaps
212| Gap | Personas Affected | Impact |
213|-----|------------------|--------|
214| [Gap] | [Names] | [H/M/L] |
215 
216#### Messaging Disconnects
217| Site says | Buyers say | Personas |
218|-----------|-----------|----------|
219| "[quote]" | "[quote]" | [Names] |
220 
221---
222 
223## Part 3: Competitive Analysis
224 
225### vs [Competitor 1]
226 
227**Overall: [Company wins / Competitor wins / Split]**
228 
229| Dimension | [Company] | [Competitor] | Winner |
230|-----------|:---------:|:------------:|:------:|
231| First Impression | [avg] | [avg] | |
232| Messaging | [avg] | [avg] | |
233| Trust | [avg] | [avg] | |
234| Clarity | [avg] | [avg] | |
235| Objections | [avg] | [avg] | |
236| **Overall** | **[avg]** | **[avg]** | |
237 
238**Where competitor wins:**
239- [Specific advantage, which personas care]
240 
241**Where we win:**
242- [Specific advantage, which personas care]
243 
244**Personas who'd choose competitor:** [Names — these are at-risk segments]
245 
246---
247 
248### vs [Competitor 2]
249[Same structure]
250 
251---
252 
253### Competitive Position Map
254 
255| Persona | Best Experience | Worst Experience | Notes |
256|---------|:-:|:-:|---|
257| [P1] | [Company/Comp] | [Company/Comp] | [Why] |
258| [P2] | ... | ... | ... |
259 
260### At-Risk Segments
261 
262[Personas who preferred competitors. For each: which competitor, why, and what it would take to win them back.]
263 
264### Competitive Advantages to Amplify
265 
266[Things the company does better than ALL competitors — lean into these.]
267 
268### Gaps to Close
269 
270[Things competitors do better across most personas — neutralize these.]
271 
272---
273 
274## Part 4: Prioritized Recommendations
275 
276### Tier 1: High Impact, Do Now
277 
278These affect the most personas and/or address competitive gaps.
279 
2801. **[Recommendation]**
281 - **Why:** [Evidence from scorecard + competitive analysis]
282 - **Personas affected:** [Names]
283 - **Competitive context:** [Do competitors already do this better?]
284 - **Expected impact:** [What changes — conversion, trust, clarity]
285 - **Effort:** [Low/Med/High]
286 
2872. **[Recommendation]**
288 ...
289 
290### Tier 2: Medium Impact, Plan For
291 
2923. **[Recommendation]**
293 ...
294 
295### Tier 3: Segment-Specific Optimizations
296 
297These improve experience for specific ICP segments.
298 
2995. **[Recommendation]** — For [persona/segment]
300 ...
301 
302### Quick Wins
303 
304- [Small change] → Benefits [persona]
305- [Small change] → Benefits [persona]
306 
307---
308 
309## Appendix
310 
311### A. Full Persona Profiles
312→ `clients/<client>/personas/personas.md`
313 
314### B. Detailed Scorecard Review
315→ `clients/<client>/icp-reviews/<date>-scorecard.md`
316 
317### C. Detailed Competitive Reviews
318→ `clients/<client>/icp-reviews/<date>-head-to-head-<competitor>.md`
319 
320### D. Persona Data (JSON)
321→ `clients/<client>/personas/personas.json`
322```
323 
324---
325 
326## Parallelization
327 
328Some phases can run in parallel to save time:
329 
330```
331Phase 1: Build personas (if needed)
332
333Phase 2 + Phase 3 can partially overlap:
334 - Crawl all sites (client + competitors) at once
335 - Run scorecard first (client site only)
336 - Then run head-to-heads (reuse client crawl data)
337
338Phase 4: Consolidate (needs all prior phases)
339```
340 
341If personas already exist, the whole workflow is just:
342```
343Crawl all sites → Scorecard → Head-to-heads → Consolidate
344```
345 
346## Tips
347 
348- **Start with 1-2 competitors, not 5.** Each competitor adds a full head-to-head evaluation pass. Start focused, add more if needed.
349- **The at-risk segments are the most actionable finding.** If a persona consistently prefers a competitor, that's an ICP segment you're actively losing deals in. That should drive urgency.
350- **Reuse this quarterly.** Run personas once, then re-run the audit after site changes or quarterly to track improvement. Compare scores across dates.
351- **Combine with SEO content audit for the full picture.** ICP audit tells you "does the messaging work for buyers?" SEO audit tells you "are buyers finding you in the first place?" Together they cover the full funnel.
352- **This makes a great client deliverable.** The consolidated report is structured for sharing. Use `content-asset-creator` to make it into a polished HTML report.
353- **Don't skip the competitive analysis.** The scorecard alone is useful, but the head-to-head is where the real insights are. Buyers always compare — your audit should too.
354 
355## Dependencies
356 
357- Skills: `buyer-persona-generator`, `icp-website-audit`
358- Web search capability (for research, external presence checks)
359- Web fetch capability (for reading website pages)
360- No API keys or paid tools required
361 
362## Cost
363 
364Free — no paid APIs. All research and evaluation is done via web search and web fetch.
365 

Discussion

Alternatives

Also in Lead lists