Files
marketingskills/skills/programmatic-seo/references/playbooks.md
T
Corey Haines 30f9b9a729 feat: v2.0 skill renames and CRO consolidation (#291)
* feat: v2.0 skill renames and CRO consolidation

BREAKING CHANGE: Users must reinstall skills after this update.

## Skill Renames (16)
- ab-test-setup → ab-testing
- analytics-tracking → analytics
- aso-audit → aso
- competitor-alternatives → competitors
- email-sequence → emails
- free-tool-strategy → free-tools
- launch-strategy → launch
- onboarding-cro → onboarding
- paywall-upgrade-cro → paywalls
- popup-cro → popups
- pricing-strategy → pricing
- product-marketing-context → product-marketing
- referral-program → referrals
- schema-markup → schema
- signup-flow-cro → signup
- social-content → social

## Consolidations (1)
- page-cro + form-cro → cro (form content in references/form.md)

## Why 2.0?
- Shorter, cleaner skill names
- Consistent naming (no -strategy, -setup, -cro suffixes)
- All cross-references updated across 100+ files

Total skills: 40

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

* fix(v2.0): update evals for renamed skills, fix validate script, clear warnings

- Update 32 evals.json files to reference new skill names (page-cro → cro,
  product-marketing-context → product-marketing, etc.) — these were missed
  in the initial v2.0 rename pass since only SKILL.md and marketplace.json
  were updated.
- Fix validate-skills.sh: replace GNU-only `head -n -1` with portable awk
  so frontmatter extraction works on macOS.
- Move Copy Editing Checklist (56 lines) to references/checklist.md to
  bring copy-editing SKILL.md under the 500-line limit (508 → 457).
- Add "see X" pointers to marketing-psychology description for skill
  discovery (cro, pricing, copywriting).
- Update skill-request.yml issue template placeholder (page-cro → cro).

All 40 skills now pass validation with zero warnings.

* fix(v2.0): add evals for 8 missing skills, strip stale frontmatter from cro/form.md

Adds 48 new eval cases (6 per skill) for skills that previously had no evals:
aso, co-marketing, community-marketing, competitor-profiling, directory-submissions,
image, lead-magnets, video. All 40 skills now have eval coverage (251 total cases).

Strips leftover frontmatter from skills/cro/references/form.md — it was inherited
from the old form-cro SKILL.md before consolidation. Reference files don't need
frontmatter.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>

* fix(v2.0): rename paid-ads → ads

One more v2.0 simplification — drops the redundant 'paid-' qualifier. Updates
the skill directory, SKILL.md frontmatter, evals.json, README skill table, the
v2.0 rename table in VERSIONS.md (now 17 renames), and all cross-references in
related skills (ad-creative, aso, competitor-profiling, customer-research,
lead-magnets, marketing-ideas) plus the tools/integrations guides.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>

* fix(v2.0): bump SKILL.md frontmatter version to 2.0.0 for all 40 skills

VERSIONS.md was already updated to 2.0.0 but the metadata.version field inside
each SKILL.md was still on 1.x. That mismatch would have caused the update-check
flow to perpetually report 'update available' since it compares VERSIONS.md
against local SKILL.md metadata versions.

Caught by codex review (P1).

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>

* fix(v2.0): add legacy product-marketing-context.md filename fallback

Before this fix, users upgrading from v1.x who had a `product-marketing-context.md`
file would lose automatic context loading — every skill only checked the new
`product-marketing.md` filename. Now all 40 skills also accept the legacy
filename (in either `.agents/` or `.claude/`), and the README migration command
covers both legacy and current filenames.

Caught by codex review (P1 + P2).

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>

* fix(v2.0): re-sort README skills table alphabetically, fix ads box width

The skills table had a few entries out of alphabetical order from the renames
(co-marketing was after cold-email, ads was at the renamed position).
Re-sorted alphabetically per sync-skills.js. Also padded the 'ads' cell in the
ASCII flow diagram to keep the box width consistent.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>

* fix(v2.0): document folder cleanup on upgrade, stop sync-skills from re-adding skills array

README upgrade guide now includes:
- A clear cleanup step for stale v1.x skill folders (renamed + consolidated) so
  users don't end up with both old and new folders side-by-side after upgrading
- The full v1 to v2 rename map for reference
- Existing product-marketing-context.md migration steps (preserved)

sync-skills.js no longer (re-)introduces a `skills` array on marketplace.json --
Claude Code's plugin schema discovers skills via the `skills/` directory, and the
explicit array was failing validation. The script now refreshes the description
count and strips the stale array if present.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>

---------

Co-authored-by: Claude Opus 4.5 <noreply@anthropic.com>
2026-05-13 22:05:15 -07:00

8.1 KiB

The 12 Programmatic SEO Playbooks

Beyond mixing and matching data point permutations, these are the proven playbooks for programmatic SEO.

Contents

    1. Templates
    1. Curation
    1. Conversions
    1. Comparisons
    1. Examples
    1. Locations
    1. Personas
    1. Integrations
    1. Glossary
    1. Translations
    1. Directory
    1. Profiles
  • Choosing Your Playbook (Match to Your Assets, Combine Playbooks)

1. Templates

Pattern: "[Type] template" or "free [type] template" Example searches: "resume template", "invoice template", "pitch deck template"

What it is: Downloadable or interactive templates users can use directly.

Why it works:

  • High intent—people need it now
  • Shareable/linkable assets
  • Natural for product-led companies

Value requirements:

  • Actually usable templates (not just previews)
  • Multiple variations per type
  • Quality comparable to paid options
  • Easy download/use flow

URL structure: /templates/[type]/ or /templates/[category]/[type]/


2. Curation

Pattern: "best [category]" or "top [number] [things]" Example searches: "best website builders", "top 10 crm software", "best free design tools"

What it is: Curated lists ranking or recommending options in a category.

Why it works:

  • Comparison shoppers searching for guidance
  • High commercial intent
  • Evergreen with updates

Value requirements:

  • Genuine evaluation criteria
  • Real testing or expertise
  • Regular updates (date visible)
  • Not just affiliate-driven rankings

URL structure: /best/[category]/ or /[category]/best/


3. Conversions

Pattern: "[X] to [Y]" or "[amount] [unit] in [unit]" Example searches: "$10 USD to GBP", "100 kg to lbs", "pdf to word"

What it is: Tools or pages that convert between formats, units, or currencies.

Why it works:

  • Instant utility
  • Extremely high search volume
  • Repeat usage potential

Value requirements:

  • Accurate, real-time data
  • Fast, functional tool
  • Related conversions suggested
  • Mobile-friendly interface

URL structure: /convert/[from]-to-[to]/ or /[from]-to-[to]-converter/


4. Comparisons

Pattern: "[X] vs [Y]" or "[X] alternative" Example searches: "webflow vs wordpress", "notion vs coda", "figma alternatives"

What it is: Head-to-head comparisons between products, tools, or options.

Why it works:

  • High purchase intent
  • Clear search pattern
  • Scales with number of competitors

Value requirements:

  • Honest, balanced analysis
  • Actual feature comparison data
  • Clear recommendation by use case
  • Updated when products change

URL structure: /compare/[x]-vs-[y]/ or /[x]-vs-[y]/

See also: competitors skill for detailed frameworks


5. Examples

Pattern: "[type] examples" or "[category] inspiration" Example searches: "saas landing page examples", "email subject line examples", "portfolio website examples"

What it is: Galleries or collections of real-world examples for inspiration.

Why it works:

  • Research phase traffic
  • Highly shareable
  • Natural for design/creative tools

Value requirements:

  • Real, high-quality examples
  • Screenshots or embeds
  • Categorization/filtering
  • Analysis of why they work

URL structure: /examples/[type]/ or /[type]-examples/


6. Locations

Pattern: "[service/thing] in [location]" Example searches: "coworking spaces in san diego", "dentists in austin", "best restaurants in brooklyn"

What it is: Location-specific pages for services, businesses, or information.

Why it works:

  • Local intent is massive
  • Scales with geography
  • Natural for marketplaces/directories

Value requirements:

  • Actual local data (not just city name swapped)
  • Local providers/options listed
  • Location-specific insights (pricing, regulations)
  • Map integration helpful

URL structure: /[service]/[city]/ or /locations/[city]/[service]/


7. Personas

Pattern: "[product] for [audience]" or "[solution] for [role/industry]" Example searches: "payroll software for agencies", "crm for real estate", "project management for freelancers"

What it is: Tailored landing pages addressing specific audience segments.

Why it works:

  • Speaks directly to searcher's context
  • Higher conversion than generic pages
  • Scales with personas

Value requirements:

  • Genuine persona-specific content
  • Relevant features highlighted
  • Testimonials from that segment
  • Use cases specific to audience

URL structure: /for/[persona]/ or /solutions/[industry]/


8. Integrations

Pattern: "[your product] [other product] integration" or "[product] + [product]" Example searches: "slack asana integration", "zapier airtable", "hubspot salesforce sync"

What it is: Pages explaining how your product works with other tools.

Why it works:

  • Captures users of other products
  • High intent (they want the solution)
  • Scales with integration ecosystem

Value requirements:

  • Real integration details
  • Setup instructions
  • Use cases for the combination
  • Working integration (not vaporware)

URL structure: /integrations/[product]/ or /connect/[product]/


9. Glossary

Pattern: "what is [term]" or "[term] definition" or "[term] meaning" Example searches: "what is pSEO", "api definition", "what does crm stand for"

What it is: Educational definitions of industry terms and concepts.

Why it works:

  • Top-of-funnel awareness
  • Establishes expertise
  • Natural internal linking opportunities

Value requirements:

  • Clear, accurate definitions
  • Examples and context
  • Related terms linked
  • More depth than a dictionary

URL structure: /glossary/[term]/ or /learn/[term]/


10. Translations

Pattern: Same content in multiple languages Example searches: "qué es pSEO", "was ist SEO", "マーケティングとは"

What it is: Your content translated and localized for other language markets.

Why it works:

  • Opens entirely new markets
  • Lower competition in many languages
  • Multiplies your content reach

Value requirements:

  • Quality translation (not just Google Translate)
  • Cultural localization
  • hreflang tags properly implemented
  • Native speaker review

URL structure: /[lang]/[page]/ or yoursite.com/es/, /de/, etc.


11. Directory

Pattern: "[category] tools" or "[type] software" or "[category] companies" Example searches: "ai copywriting tools", "email marketing software", "crm companies"

What it is: Comprehensive directories listing options in a category.

Why it works:

  • Research phase capture
  • Link building magnet
  • Natural for aggregators/reviewers

Value requirements:

  • Comprehensive coverage
  • Useful filtering/sorting
  • Details per listing (not just names)
  • Regular updates

URL structure: /directory/[category]/ or /[category]-directory/


12. Profiles

Pattern: "[person/company name]" or "[entity] + [attribute]" Example searches: "stripe ceo", "airbnb founding story", "elon musk companies"

What it is: Profile pages about notable people, companies, or entities.

Why it works:

  • Informational intent traffic
  • Builds topical authority
  • Natural for B2B, news, research

Value requirements:

  • Accurate, sourced information
  • Regularly updated
  • Unique insights or aggregation
  • Not just Wikipedia rehash

URL structure: /people/[name]/ or /companies/[name]/


Choosing Your Playbook

Match to Your Assets

If you have... Consider...
Proprietary data Stats, Directories, Profiles
Product with integrations Integrations
Design/creative product Templates, Examples
Multi-segment audience Personas
Local presence Locations
Tool or utility product Conversions
Content/expertise Glossary, Curation
International potential Translations
Competitor landscape Comparisons

Combine Playbooks

You can layer multiple playbooks:

  • Locations + Personas: "Marketing agencies for startups in Austin"
  • Curation + Locations: "Best coworking spaces in San Diego"
  • Integrations + Personas: "Slack for sales teams"
  • Glossary + Translations: Multi-language educational content