seo-machine

Plans and ships a multi-phase roadmap of programmatic SEO landing pages with a persistent phase tracker.

31|5|Updated Mar 12, 2026
One-click install
npx skills add https://github.com/MoizIbnYousaf/marketing-cli --skill seo-machine-moizibnyousaf
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: seo-machine
Source: https://github.com/MoizIbnYousaf/marketing-cli/tree/main/skills/seo-machine
Command: npx skills add https://github.com/MoizIbnYousaf/marketing-cli --skill seo-machine-moizibnyousaf

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve? Building organic search traffic requires coordinated keyword research, technical audits, and dozens of landing pages shipped in the right order across many sessions. This Skill replaces ad-hoc SEO work with a resumable engine that maintains a persistent roadmap and phase tracker so every session continues where the last one ended. ## Core Features & Use Cases - Initialize and Resume modes: Auto-detects whether to build a new roadmap (stack detection, brand context, keyword research, technical audit) or execute the next pending phase from the tracker. - Conversion-first publishing order: Ships /alternatives and /compare pages before use-case pages and playbooks, ordered by traffic potential and keyword difficulty. - Quality gates: Enforces word-count minimums, internal-link requirements, schema markup, and honesty sections via scripts before any phase is marked complete. - Use Case: A SaaS founder asks their agent to "build organic traffic." The Skill detects a Next.js stack, runs Exa-based keyword research, writes docs/seo-machine.md with a phased roadmap, then on later sessions ships one alternatives page per phase with verified internal links and FAQ schema. ## Quick Start Ask your agent to run the SEO machine to build an organic traffic roadmap for this repository.

Frequently Asked Questions about seo-machine

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I build a programmatic SEO roadmap for my website?▼

Run the Skill in a git repository with a detectable stack like Next.js or Rails. It performs keyword research, a technical audit, and writes docs/seo-machine.md containing a phase tracker ordered by conversion intent, starting with alternatives and comparison pages.

What is the difference between seo-machine, seo-audit, and seo-content?▼

seo-machine owns the multi-page roadmap, run sequencing, and persistent phase tracker across sessions. seo-audit is a one-off diagnostic of an existing site, and seo-content writes a single article rather than managing a full sprint.

Does this SEO workflow work without an Ahrefs subscription?▼

Yes. The default research stack uses Exa MCP, Firecrawl, and gh CLI recipes that replace Ahrefs volume and KD data with SERP-composition signals. A manual paste-from-UI fallback exists, and Ahrefs can be layered on as an optional paid upgrade.

Which frameworks does the SEO page generation support?▼

It includes stack adapters for Next.js App Router, Astro content collections, and Rails with Inertia, plus a portable markdown fallback. Stack detection reads files like package.json, Gemfile, or astro.config to pick the right adapter.

What quality checks run before an SEO page ships?▼

Each phase must pass word-count minimums (600 to 2,500 words by pattern), internal-link minimums verified by link_audit.py, JSON-LD schema validation, and an honesty section on alternatives pages. Failing gates must be fixed before the tracker row is marked complete.

When should I not target a keyword with this approach?▼

Avoid keywords where difficulty exceeds your domain rating by more than 10, since low-DR sites cannot realistically rank for them. The Skill refuses to add doomed phases to the tracker and suggests the closest winnable alternative instead.