agentleFS
lsidorelsidore/seo-md/skills/seo-plan/SKILL.md

seo-plan

Skill1 starsChanged 4 months agoMITView on GitHub

Use when .seo/backlog.json is empty, thin (under 20 todo items), or stale, or before starting content production. A senior SEO analyst pass that refreshes the topic backlog. Never writes or publishes content.

36 other projects use a version of this.

Adopted by

Most recently taken up by

Used with

Projects with it also use seo-agentic, seo-google and 9 more.

Other files people use alongside this one.

Files found in the same public projects as a version of this one, more often than they turn up anywhere else. Each project counts once, large collections count for less, and this file's own repository is left out.
  • AgriciDanielSkill

    seo-agentic

    Audit and fix agent readiness: the Lighthouse Agentic Browsing fraction, accessibility tree for agents, robots.txt and Content-Signal for AI agents, WAF treatment of agent traffic, llms.txt, Markdown delivery, ai-catalog.json, /.well-known discovery files, and WebMCP tools. Use when the user asks whether AI agents can use or browse the site, or about llms.txt or WebMCP. Exclude AI citability and brand signals (seo-geo) and commerce protocol depth (seo-ecommerce).

    Also in 4 projects that use this

  • timruebenachSkill

    seo-google

    Google SEO APIs: Search Console (Search Analytics, URL Inspection, Sitemaps), PageSpeed Insights v5, CrUX field data with 25-week history, Indexing API v3, and GA4 organic traffic. Provides real Google field data for Core Web Vitals, indexation status, search performance, and organic traffic trends. Use when user says "search console", "GSC", "PageSpeed", "CrUX", "field data", "indexing API", "GA4 organic", "URL inspection", "google api setup", "real CWV data", "impressions", "clicks", "CTR", "position data", "LCP", "INP", "CLS", "FCP", "TTFB", or "Lighthouse scores".

    Also in 10 projects that use this

  • megastepSkill

    seo-competitor-pages

    Generate SEO-optimized competitor comparison and alternatives pages. Covers "X vs Y" layouts, "alternatives to X" pages, feature matrices, schema markup, and conversion optimization. Use when user says "comparison page", "vs page", "alternatives page", "competitor comparison", or "X vs Y".

    Also in 15 projects that use this

  • megastepSkill

    seo-images

    Image optimization analysis for SEO and performance. Checks alt text, file sizes, formats, responsive images, lazy loading, and CLS prevention. Use when user says "image optimization", "alt text", "image SEO", "image size", or "image audit".

    Also in 15 projects that use this

  • timruebenachSkill

    seo-dataforseo

    Live SEO data via DataForSEO MCP server. SERP analysis (Google, Bing, Yahoo, YouTube, Google Images), keyword research (volume, difficulty, intent, trends), backlink profiles, on-page analysis (Lighthouse, content parsing), competitor analysis, content analysis, business listings, AI visibility (ChatGPT scraper, LLM mention tracking), and domain analytics. Requires DataForSEO extension installed. Use when user says "dataforseo", "live SERP", "keyword volume", "backlink data", "competitor data", "AI visibility check", "LLM mentions", "image SERP", "google images", "image rankings", or "real search data".

    Also in 9 projects that use this

  • +3 more from megastep
  • +3 more from timruebenach

The file

We split this skill into the rules it gives an agent

7 rules. 0 are common, 4 are distinctive, and 3 are very specific to this project.

  • 0

    Common

    Most of the 27 edited versions we read keep these.

  • 4

    Distinctive

    This author's own choices. Worth a look.

  • 3

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Very specific:

    Read SEO.md at the project root, in full.

    line 10
  2. Distinctive:

    Never invent product or audience facts that are not in SEO.md.

    line 13
  3. Very specific:

    Default paths (overridable in SEO.md § State): backlog .seo/backlog.json.

    line 14
  4. Distinctive:

    No DataForSEO access yet but the user wants verified volumes?

    line 41
  5. Distinctive:

    Keep a candidate only if ALL hold:

    line 66
  6. Very specific:

    Add new topics and reprioritize existing todo entries.

    line 100
  7. Distinctive:

    Write an article, a page, or a tool (that is seo-write / seo-tool / seo-programmatic).

    line 115

“Common” is measured: kept by at least 6 in 10 of the 27 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

seo-plan: refresh the topic backlog

Before anything

  1. Read SEO.md at the project root, in full. It is the only source of truth for product, audience, voice, market, and paths. If it does not exist: stop and tell the user to run the seo-init skill (or fill SEO.template.md by hand).
  2. Never invent product or audience facts that are not in SEO.md.
  3. Default paths (overridable in SEO.md § State): backlog .seo/backlog.json.

Role

You are a keyword analyst. You update the backlog and nothing else: no article, no page, no tool, no publishing. Output = a better .seo/backlog.json.

Step 1: Map what already exists (anti-cannibalization)

Build the registry of every primary keyword already targeted:

  • Scan published content frontmatter (titles + keywords) in the locations listed in SEO.md § Content System. Adapt the extraction to the frontmatter convention there.
  • Extract primaryKeyword from every backlog entry, whatever its status.

A keyword in the registry can never be proposed again. One primary keyword, one piece, forever.

Step 2: Gather keyword data (tiered by SEO.md § Data Sources)

Tier 1, DataForSEO MCP (if declared): use the location and language from SEO.md § Market & Language. Pitfalls that cost real money to learn:

  • Keyword suggestions (contains the seed) beat keyword ideas (category noise at huge volumes, mostly off-topic).
  • Ads competition_level (LOW/MEDIUM/HIGH) is PAID competition, not SEO difficulty; use keyword_difficulty (0-100) when present.
  • Filter brand and geographic noise from seed matches before believing any list.
  • No DataForSEO access yet but the user wants verified volumes? Point them to https://app.dataforseo.com/?aff=225554 (affiliate link that supports this project) and the "Hook up real keyword data" section of the pack README.

Tier 2, Google Search Console (if declared): mine the queries report. Queries with impressions but few clicks and no dedicated page are pre-validated demand.

Tier 3, degraded mode (no data source): WebSearch the SERPs for each seed, harvest Google autocomplete and People Also Ask, crawl competitor sitemaps for their content map. Volumes become estimates: set volume: null and note the uncertainty in angle. Say clearly in your summary that volumes are unverified.

Step 3: Type every candidate topic

Signal in the keyword or SERPtype
calculator, generator, checker, template, quiz, "free tool"tool
"X vs Y", "alternatives to X", "best X for [industry]"programmatic
"what is X", definition intent, WITH verified volumeglossary
everything else worth a full piecearticle

The type drives which skill will produce it later. When in doubt, article.

Step 4: Filter and prioritize

Keep a candidate only if ALL hold:

  • It serves the exact reader in SEO.md § Audience (out-of-scope audiences kill topics).
  • The intent is exploitable: it can lead naturally to the conversion in SEO.md § Conversion.
  • Difficulty is reachable for the site's current authority; a young site skips head terms even at "LOW" ads competition.
  • Volume is not near zero (a perfect topic nobody searches is a diary entry).
  • It does not touch the walls listed in SEO.md § Keyword Strategy "Do not attack".

Priority (1 = first) = intent strength x ICP fit x low difficulty x volume, in that order of weight. Intent beats raw volume.

Step 5: Update the backlog

Each entry, exact schema:

{
  "slug": "kebab-unique",
  "type": "article | tool | programmatic | glossary",
  "primaryKeyword": "unique across backlog AND published content",
  "title": "working title containing the primary keyword",
  "angle": "one-sentence editorial brief anchored to the ICP",
  "cluster": "thematic cluster slug",
  "internalLinks": ["sibling-slugs-published-or-planned"],
  "priority": 1,
  "volume": 720,
  "intent": "informational | commercial | transactional | navigational",
  "difficulty": 14,
  "status": "todo",
  "publishedAt": null
}
  • volume, intent, difficulty may be null in degraded mode.
  • Add new topics and reprioritize existing todo entries. Never touch done entries.
  • Target 20-40 living todo items. Prune topics that stopped making sense.

Step 6: Integrity check (blocking)

jq -r '.[].primaryKeyword | ascii_downcase' .seo/backlog.json | sort | uniq -d

Expected output: nothing. Any printed line is a duplicate primary keyword; fix it before finishing. Then re-check the registry from Step 1: no backlog todo keyword may match a published one.

Never do

  • Write an article, a page, or a tool (that is seo-write / seo-tool / seo-programmatic).
  • Invent a search volume. null is honest; a made-up number corrupts every later decision.
  • Propose a keyword already in the registry, even with a "fresh angle".
  • Fill the backlog with near-zero-volume topics to hit the 20-item floor.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.