programmatic-seo

Overview of programmatic-seo skill

What the programmatic-seo skill is for

The programmatic-seo skill helps an AI assistant plan SEO-driven pages at scale using repeatable templates, structured data, and search-intent patterns. It is best suited for teams building directory pages, comparison pages, integration pages, location pages, “best X for Y” pages, or keyword-plus-variable page sets where hundreds or thousands of URLs may be generated from a common framework.

Best-fit users and jobs to be done

Use this skill when you need a strategy for programmatic-seo for SEO Content, not just a list of article ideas. Good fit cases include SaaS comparison libraries, marketplace category pages, local service pages, product alternative pages, integration landing pages, and data-backed directories. The real job is to decide which page types deserve to exist, what unique value each page must contain, how templates should vary, and how to avoid thin or duplicative pages.

What makes it different from a generic SEO prompt

A generic prompt may suggest “create pages at scale.” This skill pushes the assistant to assess business context, search patterns, competitive difficulty, conversion goals, and page-level uniqueness before recommending a rollout. Its strongest differentiator is the emphasis on unique value per page and proprietary data, which are usually the difference between useful programmatic SEO and low-quality doorway pages.

Main adoption considerations

Install this skill if you already have, or can create, structured inputs such as keyword patterns, entity lists, locations, competitors, tools, features, or product data. Do not use it as a shortcut for mass-producing near-identical pages. It works best when paired with real data, editorial standards, internal linking rules, and a clear conversion path.

How to Use programmatic-seo skill

programmatic-seo install and repository files to inspect first

Install the skill with:

npx skills add alirezarezvani/claude-skills --skill programmatic-seo

After installation, read SKILL.md first because it contains the operating workflow, assessment questions, and quality principles. Then inspect scripts/url_pattern_generator.py, which provides a practical helper for generating URL combinations from a JSON template and variable set. The repository path is marketing-skill/skills/programmatic-seo, and the source is available at https://github.com/alirezarezvani/claude-skills/tree/main/marketing-skill/skills/programmatic-seo.

Inputs the skill needs for useful output

For strong programmatic-seo usage, give the assistant more than a broad goal. Useful inputs include:

• Business model, product, and target customer
• Page type, such as comparison, city, category, integration, or directory
• Search pattern examples, such as {software} alternative or {service} in {city}
• Entity data or variable lists
• Conversion goal for the pages
• Known competitors and ranking examples
• Any proprietary data, reviews, pricing, availability, benchmarks, or inventory
• CMS, framework, or publishing constraints

If your project has .claude/product-marketing-context.md, the skill is designed to read that first before asking for missing information.

Turning a rough goal into a strong prompt

Weak prompt:

Help me make programmatic SEO pages for our SaaS.

Better prompt:

Use the programmatic-seo skill to evaluate a comparison-page strategy for a B2B helpdesk SaaS. Our target buyers are support leaders at 50–500 person companies. We want pages for {our_tool}-vs-{competitor} and {competitor}-alternative. Competitors include Zendesk, Freshdesk, Intercom, Help Scout, and Gorgias. Our differentiators are faster setup, lower admin overhead, and native Slack workflows. Conversion goal: demo request. Please assess search opportunity, page template sections, unique data needed per page, internal linking, URL patterns, and risks of thin content.

This works better because it gives the skill enough context to judge page viability, not just generate titles.

Using the URL pattern generator

The included scripts/url_pattern_generator.py can help plan URL coverage. Example input:

{
  "template": "{tool}-vs-{competitor}-comparison",
  "variables": {
    "tool": ["slack", "teams", "discord"],
    "competitor": ["zoom", "webex"]
  },
  "base_url": "https://example.com/compare"
}

Run it with:

python3 scripts/url_pattern_generator.py data.json --json

Use the output as a planning aid, not an automatic publishing list. Review generated URLs for search demand, duplication, self-comparisons, business relevance, and whether each page can contain distinct evidence.

programmatic-seo skill FAQ

Is the programmatic-seo skill suitable for beginners?

Yes, if you understand your product and can provide basic market context. Beginners should start with one page type and a small data set before planning thousands of URLs. The skill can guide structure, but it cannot replace keyword research, competitive review, or editorial judgment.

When should I not use programmatic-seo?

Do not use it for one-off blog posts, technical SEO audits, backlink analysis, or fixing crawl/indexing problems. For SEO audits, use a dedicated seo-audit workflow instead. Also avoid this skill if your only plan is to swap city names, competitor names, or product names without adding page-specific value.

How is this different from using a spreadsheet and CMS import?

A spreadsheet and CMS import can publish pages, but they do not decide whether pages deserve to exist. The programmatic-seo skill helps define page logic: search intent, template sections, data requirements, uniqueness rules, URL patterns, and rollout risk. It is a strategy and content-system skill, not just a publishing mechanism.

Does it fit modern SEO and AI search environments?

Yes, when used to create genuinely useful, entity-specific pages. It is less suited to mass keyword capture with shallow copy. The safest use is to combine structured templates with proprietary data, expert commentary, comparisons, examples, or inventory that generic competitors cannot easily reproduce.

How to Improve programmatic-seo skill

Improve programmatic-seo results with better source data

The fastest way to improve programmatic-seo output is to provide data that makes each page different. Strong inputs include feature matrices, pricing differences, location availability, customer counts, review snippets, integrations, benchmarks, screenshots, use-case fit, and internal product knowledge. If every generated page has the same evidence, the strategy is probably too thin.

Common failure modes to prevent

Watch for these problems:

• Pages created only because a variable combination exists
• URL sets with no search demand or no conversion value
• Templates that repeat generic claims across every page
• Comparison pages with no fair, specific comparison criteria
• Location pages without local proof, service coverage, or relevance
• Too many pages launched before indexation and engagement are validated

Ask the assistant to explicitly label which pages should be launched, merged, delayed, or rejected.

Iterating after the first output

After the first plan, ask for a second pass focused on constraints. Useful follow-up prompts include:

• “Identify pages at highest risk of thin content.”
• “Reduce this to a 50-page MVP launch set.”
• “Add required unique data fields for each template section.”
• “Create an internal linking model between category, comparison, and detail pages.”
• “Score each page pattern by search intent, difficulty, data availability, and conversion value.”

This turns the skill from a brainstorming tool into a rollout planning workflow.

Practical quality bar before publishing

Before publishing at scale, require each template to answer: why should this page exist, what does it say that the parent category page does not, what data changes per URL, what user decision it supports, and what conversion path follows naturally. If those answers are weak, improve the dataset or narrow the page set before generating more URLs.