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
- Read
~/.claude/skills/seo/output/<domain>-audit.json
- 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).
- 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).
- 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
- 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:
- Send time recommendation: "Tuesday-Thursday, 9-11am their local time gets the best open rates for cold outreach."
- 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.'"
- 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