Phase 0: Credential Preflight (REQUIRED — run BEFORE anything else)

Before running any of the steps below, always invoke the shared preflight check:

~/.claude/skills/seo/scripts/preflight.sh

If exit code is 0: credentials are configured — proceed with the rest of this skill silently.

If exit code is 2: the script prints the DataForSEO setup wizard to stdout. STOP, display that wizard to the user verbatim, and wait for them to paste credentials.

When they reply, parse login: and password:, write to ~/.claude/skills/seo/.env (chmod 600), verify with keyword_research.py volume "test", and proceed only after success. Never echo credentials.

---

SEO Cold Email Drafter

Powered by: Reads the audit JSON produced by /seo audit (built from live DataForSEO API data). No new API calls — purely a drafting step.

Prerequisite

/seo audit <domain> must have run first and saved ~/.claude/skills/seo/output/<domain>-audit.json. If that file doesn't exist, tell the user to run the audit first.

Inputs

The user provides a domain:

• /seo email acmeplumbing.com
• /seo email <domain>

Optionally they can supply their own name/signature — otherwise use a generic placeholder.

Workflow

1. Read ~/.claude/skills/seo/output/<domain>-audit.json
2. Pick the 2-3 most impactful findings from audit.issues — prioritize critical and high-priority issues that have clear business impact (lost traffic, lost revenue, broken pages indexable).
3. Pull the single highest-leverage keyword opportunity from audit.top_keywords — ideally one where they currently rank position 4-30 with decent volume and CPC. Compute its estimated monthly value: search_volume × CPC × 0.3 (rough CTR for that position band).
4. Draft an email that:
   • Has a short, specific subject that references their domain or the issue (not "I do SEO")
   • Opens by referencing something specific you noticed (not "I came across your website")
   • Lists 2-3 specific findings in bullet form — concrete, not generic ("you're missing meta descriptions on 12 service pages" not "your SEO needs work")
   • Quantifies the value of one specific opportunity in dollars
   • Offers to send the full PDF audit as a soft ask (no hard pitch)
   • Ends with a low-pressure sign-off
5. Output the email in this format (copy-pasteable):

─────────────────────────────────────────────────────────
TO:      [find their contact email manually]
SUBJECT: <short, specific subject>

Hi [Owner / first name if you can find it],

<2-3 sentence opening that references something specific>

<bullet list of 2-3 concrete findings with numbers>

<one quantified opportunity — e.g. "for example, you're #14 for 'plumbers san francisco' which is ~2,400 searches/mo at $14 CPC, so moving to top 3 is worth roughly $X/month in click value">

I put together a quick 1-page PDF audit that shows 5-7 specific fixes
ranked by impact. Want me to send it over?

[Your name]
─────────────────────────────────────────────────────────

Tone rules

• Specific over generic — every sentence should reference data from THEIR audit, not boilerplate
• Numbers over adjectives — say "240 monthly visits" not "decent traffic"
• One ask only — "want me to send the PDF?" — don't pitch services in the first email
• Under 150 words — long emails get ignored
• No "I" sentences at the start — start with "Saw" or "Noticed" or "Your..."
• No exclamation points — keeps it professional, not spammy
• No "leverage," "synergy," "optimize" or other agency-speak

Output extras

After the email itself, also surface:

1. Send time recommendation: "Tuesday-Thursday, 9-11am their local time gets the best open rates for cold outreach."
2. Follow-up cadence note: "If no reply in 4 business days, send a short bump: 'Hey, did this get buried? Happy to send the PDF if you're curious.'"
3. Reminder: "Find their actual contact email via their site's /contact page, Google Business Profile, or LinkedIn — the audit doesn't include that."

When NOT to use this skill

• The audit hasn't run yet → run /seo audit <domain> first
• The user wants a generic SEO outreach template → tell them this skill only writes personalized emails grounded in real audit data