Homepage Audit logo

Homepage Audit

Community
BrianRWagner
homepage-audit

Full conversion audit for any homepage or landing page. Use when someone asks to "review my homepage," "audit my landing page," "why isn't my page converting," "check my website," or wants feedback on their marketing page. Requires URL or screenshot before proceeding.

Overview

PublisherBrianRWagner
Repositoryai-marketing-claude-code-skills
Skill namehomepage-audit
Stars
449
Forks
103
Bundled files
1
Links
  • Markdown instructions

    A SKILL.md file the model loads on demand, so it only costs tokens when a request actually matches.

  • Works with any LLM

    AI skills are plain Markdown, not provider-specific code, so this works with GPT, Claude, Gemini, Grok, or a local model.

  • 1 bundled files

    Scripts, templates, and references the model can read while it works. Files are read-only and never executed.

  • Open source

    Published by BrianRWagner on GitHub. Read the source before you install it.

Installation

Install the Homepage Audit AI skill in TypingMind to use it with any LLM, or drop it into another agent that reads SKILL.md.

1

Install in TypingMind

TypingMind installs a skill straight from its GitHub folder — it reads SKILL.md, bundles the resource files, and stores the result locally.

  1. Open the app and go to Plugins → Skills.
  2. Choose "Install from GitHub".
  3. Paste the skill folder URL below and confirm.
    https://github.com/BrianRWagner/ai-marketing-claude-code-skills/tree/main/homepage-audit
  4. Enable the skill in any chat where you want it available.
Plugins → Skills → Add skill → From GitHub URL, then paste the folder URL and press Continue.
2

Install in another agent

Any agent that reads the Agent Skills format can use this skill — copy the folder into that agent's skills directory.

Claude Code — .claude/skills
git clone --depth 1 https://github.com/BrianRWagner/ai-marketing-claude-code-skills.git /tmp/ai-marketing-claude-code-skills
mkdir -p .claude/skills
cp -r /tmp/ai-marketing-claude-code-skills/homepage-audit .claude/skills/homepage-audit
Restart Claude Code after copying so it picks up the new skill.

Use it in TypingMind

Enable Homepage Audit in any TypingMind chat and the model takes it from there. Its name and description sit in the system prompt, and the moment a request matches, the model loads the full instructions itself — you never invoke it by hand, and it costs no tokens until it is actually used.

The model loads Homepage Audit on its own as soon as a request matches it.

Works with any AI model

AI skills are plain Markdown instructions rather than provider-specific code, so Homepage Audit is not tied to the model it was written for. Install it once in TypingMind and use it with GPT-5, Claude, Gemini, Grok, DeepSeek, Mistral, Llama, or a local model you run yourself — all on your own API keys.

  • Loaded only when it is needed

    The system prompt carries just the name and description. The instructions are fetched on the first matching request, so an idle skill costs nothing.

  • Switch models mid-chat

    Because the skill is instructions rather than code, changing model does not break it — the next model reads the same SKILL.md.

Skill instructions

This is the SKILL.md content the model loads. Read it before installing — a skill is instructions your model will follow.

Homepage Audit

You are a conversion expert. Your goal: audit a homepage or landing page with systematic scoring, then produce an impact-prioritized action plan with concrete rewrites.


Mode

Detect from context or ask: "Quick scan, full audit, or full audit with rewrites?"

ModeWhat you getBest for
quick5-second test + top 3 highest-impact fixesFast gut-check before a launch
standardFull section-by-section audit + priority listWebsite refresh, conversion diagnosis
deepFull audit + rewrite recommendations for each section + A/B test hypothesesFull redesign or CRO project

Default: standard — use quick if they say "just tell me what's wrong." Use deep if they want copy rewrites alongside the diagnosis.


Context Loading Gates

Do not begin the audit without one of these:

  • A live URL (fetch with web_fetch if available)
  • A screenshot of above-the-fold content
  • Copy/paste of: headline, subheadline, primary CTA, and first paragraph

If none is provided: Ask exactly once:

"To audit your homepage accurately, I'll need either the URL, a screenshot, or the above-the-fold copy pasted here. Which can you share?"

Also ask (if not obvious from the page):

  • What type of business is this? (SaaS / service / e-commerce)
  • Who is the target customer?
  • What's the primary conversion goal? (trial sign-up / book a call / purchase)

Do not proceed with assumptions. A misidentified page type will produce wrong scoring weights.


Phase 1: Page-Type Classification & Scoring Weight Assignment

After loading the page, classify it. Scoring weights differ by type:

SaaS / Software

  • Headline must explain the outcome, not the feature
  • Social proof priority: trial numbers, G2 ratings, logos
  • CTA priority: Free trial > Demo > Learn More
  • Watch for: Jargon, feature-led headlines, weak differentiation

Service Business (Agency, Consulting, Freelance)

  • Headline must establish credibility AND outcome
  • Social proof priority: Named testimonials with results, case study links
  • CTA priority: Book a call > Get a quote
  • Watch for: Vague positioning ("we help businesses grow")

E-Commerce

  • Hero must show product + benefit immediately
  • Social proof priority: Star ratings, reviews, UGC
  • CTA priority: Shop now > View collection
  • Watch for: Too many options causing decision paralysis

Phase 2: Structured Scoring (Complete Before Recommendations)

Score each element 1–5 using these criteria. Do not skip sections.

Section 1: Above the Fold (Weight: 25%)

ElementScore 1Score 3Score 5
HeadlineCompany name or vagueFunctional but feature-ledSpecific outcome for specific person
SubheadlineMissingRestates headlineAdds who + how
Primary CTAMissing or "Submit"Visible but genericSpecific, above fold, action-oriented
VisualStock photoProduct shownProduct-in-context showing outcome
Load Speed>4s2–4s<2s
Mobile RenderBrokenFunctionalPerfect

Headline scoring rubric:

  • Score 1: "Welcome to [Company Name]"
  • Score 3: "[Feature]-powered [category]"
  • Score 5: "[Specific outcome] for [specific person]—without [specific obstacle]"

Section 2: Value Proposition (Weight: 25%)

Score each: Benefits clarity / Target customer specificity / Differentiation / Features-to-benefits translation

Section 3: Social Proof (Weight: 10%)

Score each: Testimonial quality / Logo presence / Hard numbers/stats

Section 4: Clarity & Copy (Weight: 15%)

Score each: Scannability / Conciseness / Jargon-free / Benefits > Features ratio

Section 5: CTA & Conversion (Weight: 15%)

Score each: CTA visibility / CTA frequency / Low-friction option availability

Section 6: Trust & Risk Reduction (Weight: 10%)

Score each: Pricing transparency / Risk reversal / Objection handling

Calculate weighted total: (Section 1 avg × 0.25) + (Section 2 avg × 0.25) + (Section 3 avg × 0.10) + (Section 4 avg × 0.15) + (Section 5 avg × 0.15) + (Section 6 avg × 0.10) = X/5

Interpretation:

  • 4.5–5.0: Excellent
  • 3.5–4.4: Good
  • 2.5–3.4: Needs Work
  • Below 2.5: Major Overhaul

Phase 3: Headline Rewrite

Always produce a before/after headline rewrite. Format exactly:

markdown
### Headline Rewrite

**Current:**
> "[Exact current headline]"

**Why it's weak:**
[Specific reason: vague / feature-focused / wrong audience / no benefit]

**Rewritten:**
> "[Improved version — specific outcome + specific person]"

**Why it's stronger:**
[What changed: added outcome / named ICP / removed jargon / created tension]

**Alternate version:**
> "[Second option with different angle]"

Phase 4: Impact × Effort Prioritization

Map every identified fix to this matrix before recommendations:

FixImpact (1–5)Effort (1–5)Priority
[Fix]Do This Week / This Month / Deprioritize

Priority logic:

  • Impact 4–5 + Effort 1–2 → Do This Week
  • Impact 4–5 + Effort 3–5 → Schedule This Month
  • Impact 1–3 → Deprioritize

Minimum: identify 3 "Do This Week" fixes and 2 "This Month" fixes.


Phase 5: Self-Critique Pass (REQUIRED)

After completing the audit, verify:

  • Did I score every section, or skip anything I couldn't fully assess?
  • Is the headline rewrite actually specific, or is it still vague?
  • Are my "Do This Week" fixes genuinely low-effort, or am I underestimating dev work?
  • Did my scoring match the correct industry/page-type weights?
  • Is there a disconnect between what the page says and the target audience I was told?

Flag any gaps: "I couldn't fully score load speed without running the actual URL — you should test at PageSpeed Insights."


Output Structure

markdown
## Homepage Audit: [URL or Page Name]
**Date:** [YYYY-MM-DD]
**Page Type:** [SaaS / Service / E-Commerce]
**Target Conversion:** [What the page should do]

---

## 5-Second Test
- Immediately clear: [what works]
- Immediately confusing: [what doesn't]

---

## Section Scores

| Section | Raw Score | Weight | Weighted |
|---|---|---|---|
| Above the Fold | /5 | 25% | |
| Value Proposition | /5 | 25% | |
| Social Proof | /5 | 10% | |
| Clarity & Copy | /5 | 15% | |
| CTA & Conversion | /5 | 15% | |
| Trust & Risk | /5 | 10% | |
| **TOTAL** | | | **/5** |

**Rating:** [Excellent / Good / Needs Work / Major Overhaul]

---

## Headline Rewrite
[Before/After with explanation]

---

## Priority Matrix

| Fix | Impact | Effort | Priority |
|---|---|---|---|
| ... | | | |

---

## Do This Week (Top 3)
1. [Specific fix with exact instruction]
2. [Specific fix with exact instruction]
3. [Specific fix with exact instruction]

---

## This Month (Strategic)
1. [Bigger improvement]
2. [Bigger improvement]

---

## Self-Critique Notes
[Any gaps, caveats, or things that need human verification]

Skill by Brian Wagner | AI Marketing Architect | brianrwagner.com

Bundled files

The model reads these on demand while the skill is loaded. They are exposed as readable files and are never executed.

Frequently asked questions

What does the Homepage Audit AI skill do?

Full conversion audit for any homepage or landing page. Use when someone asks to "review my homepage," "audit my landing page," "why isn't my page converting," "check my website," or wants feedback on their marketing page. Requires URL or screenshot before proceeding.

Why use Homepage Audit on TypingMind?

Because you install it once and use it with any model. Homepage Audit is plain Markdown rather than provider-specific code, so the same skill runs on GPT-5, Claude, Gemini, Grok, or a local model — and you can switch model mid-chat without it breaking. TypingMind runs on your own API keys, so you pay providers directly instead of a per-seat subscription, and your skills and chats stay in your own storage.

How do I install Homepage Audit in TypingMind?

Open Plugins → Skills → Install from GitHub in TypingMind and paste https://github.com/BrianRWagner/ai-marketing-claude-code-skills/tree/main/homepage-audit. TypingMind reads its SKILL.md and bundles its files and installs it as a skill you can enable per chat.

Which AI models can use Homepage Audit?

Any model you connect in TypingMind. AI skills are plain Markdown instructions rather than provider-specific code, so GPT, Claude, Gemini, Grok, and local models can all load this skill when a request matches it.

How many AI models can I use with Homepage Audit?

As many as you like. As long as a model supports skills, you can use Homepage Audit with it — GPT, Claude, Gemini, Grok, DeepSeek, Mistral, Llama and more — all on TypingMind with your own API keys.

Is the Homepage Audit AI skill free?

It is published on GitHub by BrianRWagner. Check the repository for licensing terms. You only pay your own AI provider for the tokens you use.

What are AI skills?

An AI skill is a reusable instruction bundle that teaches an AI model how to do one specific task. It follows the open Agent Skills format: a SKILL.md file with a name and description, plus any scripts, templates or reference files the model may need. The model reads the instructions only when your request matches the skill, so an installed skill costs nothing until it is used.

How are AI skills different from plugins or MCP servers?

A plugin or MCP server gives a model new tools to call — code that runs somewhere and returns a result. An AI skill gives the model knowledge and process instead: how to approach a task, which steps to follow, what good output looks like. Skills are plain Markdown, so they need no server, no API key and no runtime, and they work with any model.

View all

Set up your own AI workspace now

Get notified about new features and future giveaways by subscribing to our newsletter 👇