name: ai-seo-articles
description: >
AI-powered SEO article production pipeline. Researches keywords, writes high-quality
articles with branded hero images and inline visuals, scores quality at 110 pts,
processes images via script, and publishes at scale. Configurable for any company
via config/ subfolder. Currently configured for: Blink (blink.new).
Commands: "run seo", "write seo articles", "seo run", "run seo 8 articles",
"run seo b7 sprint", "run seo [market] focus".
ai-seo-articles — Master Skill
One skill, one source of truth for AI-powered SEO article production. Configurable for any project.
Active Project
Change this section to switch projects. Everything else reads from these paths automatically.
| Setting |
Value |
| Project |
Blink (blink.new) |
| Config path |
.cursor/skills/ai-seo-articles/config/blink/ |
| Runtime data |
.todo/seo/ (SEO_PROFILE.md, MANIFEST.md, briefs/, drafts/) |
To use this skill for a different project:
- Create
.cursor/skills/ai-seo-articles/config/[project-name]/
- Copy
config/blink/ as a template, update all 5 files (COMPANY, MARKETS, CLUSTERS, COPY, IMAGES)
- Update the "Active Project" table above to point to
config/[project-name]/
- Create
.todo/seo-[project-name]/ with SEO_PROFILE.md, MANIFEST.md, briefs/, drafts/
- Update ORCHESTRATOR.md Phase 0 config file paths to reference the new config and runtime paths
How to Invoke
| Command |
What runs |
run seo |
Standard run — 5 articles across top 5 priority clusters |
run seo 8 articles |
Extended run — 8 articles |
run seo b7 sprint |
5-6 "How to Build X" articles + 2-3 other priorities |
run seo claude code focus |
Prioritise Market C clusters (C1-C6) |
run seo openclaw focus |
Prioritise Market A clusters (A7, A9, A1) |
run seo vibe coding focus |
Prioritise Market B clusters (B2, B4, B7, B8, B9) |
Execution: read and run the orchestrator
When invoked, immediately:
- Read
.cursor/skills/ai-seo-articles/prompts/ORCHESTRATOR.md — the full 6-phase pipeline
- The orchestrator reads config files (Phase 0) before any other action
- Execute the orchestrator phases 0-6 exactly as written
Config Files (what each contains)
| File |
Contains |
config/blink/COMPANY.md |
Company name, website, blog URL, products, brand voice, key differentiators, CDN token |
config/blink/MARKETS.md |
Three content markets (A/B/C), products per market, exact CTA strings, detection signals |
config/blink/CLUSTERS.md |
All keyword clusters, Global Priority Stack, competitor intelligence per market, strategic rules |
config/blink/COPY.md |
Exact CTA strings verbatim, pricing anchors, product advantage phrases, brand language dos/don'ts |
config/blink/IMAGES.md |
CHARACTER ANCHOR, scene table by article type, 6 validated prompts, inline image system, CDN upload |
Directory Index
| Path |
What it contains |
SKILL.md |
This file. Entry point with Active Project config section. |
config/blink/COMPANY.md |
Company identity — name, URLs, products, brand voice, CDN config |
config/blink/MARKETS.md |
Content markets A/B/C — products, CTAs, detection signals |
config/blink/CLUSTERS.md |
Keyword clusters, Global Priority Stack, competitor intel |
config/blink/COPY.md |
Exact CTA copy, pricing anchors, brand language rules |
config/blink/IMAGES.md |
Clay character system, scene table, 6 example prompts, inline image system |
prompts/ORCHESTRATOR.md |
The brain. Generic 6-phase pipeline — loads config at Phase 0 |
reference/ARTICLES.md |
Writing standards. Step 2 generic image section, article templates, blueprints A-E, style rules 1-10, SEO rules, frontmatter schema, publishing checklist |
reference/GEO.md |
GEO + technical SEO. AI citation optimization, schema markup, robots.txt, sitemap, llms.txt, verification commands |
scripts/process-inline-images.mjs |
Run after writing. Replaces INLINE_IMAGE comments with CDN-hosted images. Exit 0=ok, 2=no comments, 3=partial, 1=fatal |
scripts/audit-seo-health.sh |
Technical audit. Checks noindex, robots.txt, sitemap, schema, llms.txt, OG images |
scripts/check-competitor-serps.sh |
SERP monitoring. Checks SERP position for key keywords |
Runtime Data (in .todo/seo/ — not in this skill)
| Path |
Purpose |
Who writes it |
.todo/seo/SEO_PROFILE.md |
Markets, clusters, Global Priority Stack, live scores |
Human + orchestrator |
.todo/seo/MANIFEST.md |
Run history — append after every run |
Orchestrator |
.todo/seo/briefs/BRIEF_[slug].md |
Per-article research briefs |
Research worker |
.todo/seo/drafts/DRAFT_[slug].mdx |
Article drafts in-flight |
Writer worker |
Quick Scripts
# Process inline images (run after writing, before publishing):
node .cursor/skills/ai-seo-articles/scripts/process-inline-images.mjs .todo/seo/drafts/DRAFT_[slug].mdx
# Technical SEO audit:
bash .cursor/skills/ai-seo-articles/scripts/audit-seo-health.sh
bash .cursor/skills/ai-seo-articles/scripts/audit-seo-health.sh http://localhost:3000 # against localhost
# SERP presence check:
bash .cursor/skills/ai-seo-articles/scripts/check-competitor-serps.sh
Hard Stops (always enforced)
- B11 Customer Stories: never write without real customer data provided by a human
- B10 AI Comparisons: cap at 5 total; never prioritise over P1-P14
- Score gate: nothing publishes below 90/110; three revision passes max, then hold
- No duplicate keywords: check MANIFEST.md before any brief
- No fabricated data: invented stats or quotes → editor rejects, writer rewrites with sources
- Slug rules: no year suffix (
-2026). Timeless slugs. Exception: changelogs only
- No manual CTAs: auto-injected by rendering engine. DO NOT write CTA sections.
End-of-Run Report Format
- Articles published (count + full production URLs, e.g. https://blink.new/blog/[slug])
- Clusters worked + new coverage scores
- One M2 backlink opportunity flagged for human action
- What to prioritise next run
- Articles held (with reason and score)
By