seo-roast

SKILL.md

SEO Roast (landing page / article)

You produce a blunt, actionable SEO roast using a consistent rubric, then ask whether to generate a detailed HTML report with screenshots.

Inputs to collect

  • URL(s) to roast (1–5)
  • Page type: landing / product / blog article / programmatic page
  • Target keyword (optional but strongly recommended)
  • Market: language + country

Tools (adaptive)

Browser selection workflow

  1. Detect whether a Browser/Chrome/Playwright MCP is available; if yes, use it for page access and screenshots.
  2. If no browser MCP, use agent-browser CLI as the primary fallback. First check if it is installed; if not, install it with npm install -g agent-browser.
  3. If browsing is unavailable: ask for the main copy (and key sections like title/H1/meta).

SERP

  • Use the SERP API MCP (optional but recommended) to compare against what ranks. Do not use Google via a browser.

agent-browser commands (exact)

  • Open URL: agent-browser open <url>
  • Snapshot (interactive): agent-browser snapshot -i
  • Snapshot (compact): agent-browser snapshot -c
  • Snapshot (scope): agent-browser snapshot -s "main"
  • Snapshot (depth): agent-browser snapshot -d 4
  • Get title: agent-browser get title
  • Get URL: agent-browser get url
  • Get text from element: agent-browser get text @e1
  • Get HTML from element: agent-browser get html @e1
  • Screenshot (viewport): agent-browser screenshot path.png
  • Screenshot (full page): agent-browser screenshot --full full.png

Roast rubric (use this order)

1) Indexing & SERP basics

  • Title tag: uniqueness, keyword fit, clickability
  • Meta description: relevance + CTR hook
  • Canonical: correct self-canonical
  • Robots meta: not accidentally noindex

2) Search intent & information architecture

  • Does the page answer what the searcher wants within 10 seconds?
  • Is the H1 aligned with the primary query?
  • Are key sections missing vs. top-ranking pages?

3) On-page quality (content)

  • Value early, above the fold
  • Readability: short paragraphs, lots of different formats (lists/tables/callouts/images/etc.)
  • Visual support: illustration ideas where needed
  • Avoid: “only text blocks”, “fully AI content”, misleading anchors
  • Bonus: multiple layouts, TL;DR/key takeaways, AEO/GEO-friendly phrasing

4) Internal linking & topical authority

  • What should it link to (parent/child pages)? check anchor/link resemblence
  • Are anchors truthful and specific?

5) Technical UX (lightweight)

  • Clear CTAs, scannability, mobile layout issues
  • Performance red flags you can infer (heavy hero, too many scripts)

Output format (first response)

  1. Top 5 fixes (highest ROI)
  2. Quick wins (<60 minutes)
  3. Missing sections (search intent gaps)
  4. Internal linking plan (5–10 links)
  5. Snippet-ready improvements (exact title/H1/meta suggestions)

Then ask:

“Do you want a detailed HTML report (with screenshots)?”

If user says “yes” (HTML report)

Tool check

  • If a browser MCP is available: use it for screenshots.
  • Otherwise use agent-browser and capture at least 1 above-the-fold + 1 mid-page screenshot per URL.
  • If screenshots are impossible: generate the report with “screenshot unavailable” placeholders.

Report requirements

  • Single report.html output
  • Use CSS variables (no hardcoded colors)
  • Include sections matching the rubric + a prioritized backlog
  • Footer must include: holly-and-stick.com
Weekly Installs
18
GitHub Stars
1
First Seen
Jan 21, 2026
Installed on
codex14
gemini-cli14
opencode14
antigravity13
claude-code13
cursor10