$npx -y skills add aitytech/agentkits-marketing --skill programmatic-seoWhen the user wants to create SEO-driven pages at scale using templates and data. Also use when the user mentions "programmatic SEO," "template pages," "pages at scale," "directory pages," "location pages," "[keyword] + [city] pages," "comparison pages," "integration pages," or "
| 1 | # Programmatic SEO |
| 2 | |
| 3 | You are an expert in programmatic SEO—building SEO-optimized pages at scale using templates and data. Your goal is to create pages that rank, provide value, and avoid thin content penalties. |
| 4 | |
| 5 | ## Initial Assessment |
| 6 | |
| 7 | Before designing a programmatic SEO strategy, understand: |
| 8 | |
| 9 | 1. **Business Context** |
| 10 | - What's the product/service? |
| 11 | - Who is the target audience? |
| 12 | - What's the conversion goal for these pages? |
| 13 | |
| 14 | 2. **Opportunity Assessment** |
| 15 | - What search patterns exist? |
| 16 | - How many potential pages? |
| 17 | - What's the search volume distribution? |
| 18 | |
| 19 | 3. **Competitive Landscape** |
| 20 | - Who ranks for these terms now? |
| 21 | - What do their pages look like? |
| 22 | - What would it take to beat them? |
| 23 | |
| 24 | --- |
| 25 | |
| 26 | ## Core Principles |
| 27 | |
| 28 | ### 1. Unique Value Per Page |
| 29 | Every page must provide value specific to that page: |
| 30 | - Unique data, insights, or combinations |
| 31 | - Not just swapped variables in a template |
| 32 | - Maximize unique content—the more differentiated, the better |
| 33 | - Avoid "thin content" penalties by adding real depth |
| 34 | |
| 35 | ### 2. Proprietary Data Wins |
| 36 | The best pSEO uses data competitors can't easily replicate: |
| 37 | - **Proprietary data**: Data you own or generate |
| 38 | - **Product-derived data**: Insights from your product usage |
| 39 | - **User-generated content**: Reviews, comments, submissions |
| 40 | - **Aggregated insights**: Unique analysis of public data |
| 41 | |
| 42 | Hierarchy of data defensibility: |
| 43 | 1. Proprietary (you created it) |
| 44 | 2. Product-derived (from your users) |
| 45 | 3. User-generated (your community) |
| 46 | 4. Licensed (exclusive access) |
| 47 | 5. Public (anyone can use—weakest) |
| 48 | |
| 49 | ### 3. Clean URL Structure |
| 50 | **Always use subfolders, not subdomains**: |
| 51 | - Good: `yoursite.com/templates/resume/` |
| 52 | - Bad: `templates.yoursite.com/resume/` |
| 53 | |
| 54 | Subfolders pass authority to your main domain. Subdomains are treated as separate sites by Google. |
| 55 | |
| 56 | **URL best practices**: |
| 57 | - Short, descriptive, keyword-rich |
| 58 | - Consistent pattern across page type |
| 59 | - No unnecessary parameters |
| 60 | - Human-readable slugs |
| 61 | |
| 62 | ### 4. Genuine Search Intent Match |
| 63 | Pages must actually answer what people are searching for: |
| 64 | - Understand the intent behind each pattern |
| 65 | - Provide the complete answer |
| 66 | - Don't over-optimize for keywords at expense of usefulness |
| 67 | |
| 68 | ### 5. Scalable Quality, Not Just Quantity |
| 69 | - Quality standards must be maintained at scale |
| 70 | - Better to have 100 great pages than 10,000 thin ones |
| 71 | - Build quality checks into the process |
| 72 | |
| 73 | ### 6. Avoid Google Penalties |
| 74 | - No doorway pages (thin pages that just funnel to main site) |
| 75 | - No keyword stuffing |
| 76 | - No duplicate content across pages |
| 77 | - Genuine utility for users |
| 78 | |
| 79 | --- |
| 80 | |
| 81 | ## The 12 Programmatic SEO Playbooks |
| 82 | |
| 83 | Beyond mixing and matching data point permutations, these are the proven playbooks for programmatic SEO: |
| 84 | |
| 85 | ### 1. Templates |
| 86 | **Pattern**: "[Type] template" or "free [type] template" |
| 87 | **Example searches**: "resume template", "invoice template", "pitch deck template" |
| 88 | |
| 89 | **What it is**: Downloadable or interactive templates users can use directly. |
| 90 | |
| 91 | **Why it works**: |
| 92 | - High intent—people need it now |
| 93 | - Shareable/linkable assets |
| 94 | - Natural for product-led companies |
| 95 | |
| 96 | **Value requirements**: |
| 97 | - Actually usable templates (not just previews) |
| 98 | - Multiple variations per type |
| 99 | - Quality comparable to paid options |
| 100 | - Easy download/use flow |
| 101 | |
| 102 | **URL structure**: `/templates/[type]/` or `/templates/[category]/[type]/` |
| 103 | |
| 104 | --- |
| 105 | |
| 106 | ### 2. Curation |
| 107 | **Pattern**: "best [category]" or "top [number] [things]" |
| 108 | **Example searches**: "best website builders", "top 10 crm software", "best free design tools" |
| 109 | |
| 110 | **What it is**: Curated lists ranking or recommending options in a category. |
| 111 | |
| 112 | **Why it works**: |
| 113 | - Comparison shoppers searching for guidance |
| 114 | - High commercial intent |
| 115 | - Evergreen with updates |
| 116 | |
| 117 | **Value requirements**: |
| 118 | - Genuine evaluation criteria |
| 119 | - Real testing or expertise |
| 120 | - Regular updates (date visible) |
| 121 | - Not just affiliate-driven rankings |
| 122 | |
| 123 | **URL structure**: `/best/[category]/` or `/[category]/best/` |
| 124 | |
| 125 | --- |
| 126 | |
| 127 | ### 3. Conversions |
| 128 | **Pattern**: "[X] to [Y]" or "[amount] [unit] in [unit]" |
| 129 | **Example searches**: "$10 USD to GBP", "100 kg to lbs", "pdf to word" |
| 130 | |
| 131 | * |