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
config/[project-name]/ with subdirectories:
markets/market-a/COPY.md + CLUSTERS.mdmarkets/market-b/COPY.md + CLUSTERS.mdmarkets/market-c/COPY.md + CLUSTERS.md (add more markets as needed)COMPANY.md (identity, CDN, brand voice, global rules)IMAGES.md (character system + scene table)
- 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-C8) |
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) |
audit blog |
Scan all published articles for MDX-breaking issues (~30s) |
fix blog |
Auto-fix all broken articles (strip HTML comments, fix images) |
Execution
For run seo commands:
- 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
For audit blog:
node .cursor/skills/ai-seo-articles/scripts/audit-fix-blog.mjs
Lists all broken articles. Exit 0 = all clean, exit 2 = issues found.
For fix blog:
# Fast — strip HTML comments (recommended default):
node .cursor/skills/ai-seo-articles/scripts/audit-fix-blog.mjs --fix-strip
# Full — generate replacement images + strip comments:
node .cursor/skills/ai-seo-articles/scripts/audit-fix-blog.mjs --fix
Scans all 200+ articles, auto-fixes broken ones, publishes the fixes.
Re-run audit afterwards to confirm Broken: 0.
Config Files (what each contains)
| File |
Contains |
config/blink/COMPANY.md |
Company identity, CDN config, global CTA rules, brand language dos/don'ts |
config/blink/IMAGES.md |
CHARACTER ANCHOR, scene table by article type, 6 validated prompts, inline image system |
config/blink/markets/openclaw/COPY.md |
Market A: CTAs, talking points, pricing anchors, competitor positioning |
config/blink/markets/openclaw/CLUSTERS.md |
Market A: A1-A10 cluster definitions and keywords |
config/blink/markets/vibe-coding/COPY.md |
Market B: CTAs, talking points, pricing anchors, competitor positioning |
config/blink/markets/vibe-coding/CLUSTERS.md |
Market B: B1-B11 cluster definitions and keywords |
config/blink/markets/cursor-claude/COPY.md |
Market C: CTAs, happy path, builder section template, style rules |
config/blink/markets/cursor-claude/CLUSTERS.md |
Market C: C1-C8 cluster definitions and keywords |
Directory Index
| Path |
What it contains |
SKILL.md |
This file. Entry point with Active Project config section. |
config/blink/COMPANY.md |
Company identity, CDN, global brand + CTA rules |
config/blink/IMAGES.md |
Clay character system, scene table, 6 example prompts |
config/blink/markets/openclaw/COPY.md |
Market A copy: CTAs, talking points, pricing, competitors |
config/blink/markets/openclaw/CLUSTERS.md |
Market A clusters: A1-A10 keywords and strategy |
config/blink/markets/vibe-coding/COPY.md |
Market B copy: CTAs, talking points, pricing, competitors |
config/blink/markets/vibe-coding/CLUSTERS.md |
Market B clusters: B1-B11 keywords and strategy |
config/blink/markets/cursor-claude/COPY.md |
Market C copy: CTAs, happy path, builder template, style rules |
config/blink/markets/cursor-claude/CLUSTERS.md |
Market C clusters: C1-C8 keywords and strategy |
prompts/ORCHESTRATOR.md |
The brain. Generic 6-phase pipeline — loads config at Phase 0 |
reference/VOICE.md |
Writing voice. 10 writing rules with real examples + blueprint cheat sheet. Read second (after brief, before SOP.md). |
reference/SOP.md |
SOP. Production workflow, article type templates, frontmatter schema, MDX component allowlist, SEO/external-link rules, publishing checklist |
reference/GEO.md |
GEO + technical SEO. AI citation optimization, schema markup, robots.txt, sitemap, llms.txt, verification commands |
scripts/validate-draft.mjs |
Run before publishing. Validates a draft: frontmatter, images, MDX safety, word count, stats, links. Exit 0=pass, 2=warnings, 1=fail |
scripts/process-inline-images.mjs |
Run after writing. Replaces INLINE_IMAGE comments with CDN-hosted images. Exit 0=processed, 2=no slots found, 1=fatal |
scripts/audit-fix-blog.mjs |
Blog health guard. Scans all CMS articles for MDX-breaking patterns, bulk auto-fixes. Run after every SEO run. |
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
# Validate a draft before publishing (checks frontmatter, images, MDX safety, links):
node .cursor/skills/ai-seo-articles/scripts/validate-draft.mjs .todo/seo/drafts/DRAFT_[slug].mdx
# 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
# Blog health audit (run after EVERY publish — mandatory Phase 5b gate):
node .cursor/skills/ai-seo-articles/scripts/audit-fix-blog.mjs # audit: list broken articles
node .cursor/skills/ai-seo-articles/scripts/audit-fix-blog.mjs --fix-strip # fast fix: strip HTML comments
node .cursor/skills/ai-seo-articles/scripts/audit-fix-blog.mjs --fix # full fix: generate images + strip
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.
- Zero HTML comments in published MDX:
audit-fix-blog.mjs must exit 0 (Broken: 0) before any run closes. HTML comments crash every page visitor. Note: <!-- INLINE_IMAGE_* --> slots are draft-only placeholders — the publish pipeline converts them to images before CMS. They must never appear in published content.
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)
1---2name: ai-seo-articles3description: 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".4---56# ai-seo-articles — Master Skill78One skill, one source of truth for AI-powered SEO article production. Configurable for any project.910---1112## Active Project1314> **Change this section to switch projects.** Everything else reads from these paths automatically.1516| Setting | Value |17|---|---|18| **Project** | Blink (blink.new) |19| **Config path** | `.cursor/skills/ai-seo-articles/config/blink/` |20| **Runtime data** | `.todo/seo/` (SEO_PROFILE.md, MANIFEST.md, briefs/, drafts/) |2122**To use this skill for a different project:**231. Create `config/[project-name]/` with subdirectories:24 - `markets/market-a/COPY.md` + `CLUSTERS.md`25 - `markets/market-b/COPY.md` + `CLUSTERS.md`26 - `markets/market-c/COPY.md` + `CLUSTERS.md` (add more markets as needed)27 - `COMPANY.md` (identity, CDN, brand voice, global rules)28 - `IMAGES.md` (character system + scene table)292. Update the "Active Project" table above to point to `config/[project-name]/`303. Create `.todo/seo-[project-name]/` with SEO_PROFILE.md, MANIFEST.md, briefs/, drafts/314. Update ORCHESTRATOR.md Phase 0 config file paths to reference the new config and runtime paths3233---3435## How to Invoke3637| Command | What runs |38|---|---|39| `run seo` | Standard run — 5 articles across top 5 priority clusters |40| `run seo 8 articles` | Extended run — 8 articles |41| `run seo b7 sprint` | 5-6 "How to Build X" articles + 2-3 other priorities |42| `run seo claude code focus` | Prioritise Market C clusters (C1-C8) |43| `run seo openclaw focus` | Prioritise Market A clusters (A7, A9, A1) |44| `run seo vibe coding focus` | Prioritise Market B clusters (B2, B4, B7, B8, B9) |45| `audit blog` | Scan all published articles for MDX-breaking issues (~30s) |46| `fix blog` | Auto-fix all broken articles (strip HTML comments, fix images) |4748---4950## Execution5152### For `run seo` commands:531. Read `.cursor/skills/ai-seo-articles/prompts/ORCHESTRATOR.md` — the full 6-phase pipeline542. The orchestrator reads config files (Phase 0) before any other action553. Execute the orchestrator phases 0-6 exactly as written5657### For `audit blog`:58```bash59node .cursor/skills/ai-seo-articles/scripts/audit-fix-blog.mjs60```61Lists all broken articles. Exit 0 = all clean, exit 2 = issues found.6263### For `fix blog`:64```bash65# Fast — strip HTML comments (recommended default):66node .cursor/skills/ai-seo-articles/scripts/audit-fix-blog.mjs --fix-strip6768# Full — generate replacement images + strip comments:69node .cursor/skills/ai-seo-articles/scripts/audit-fix-blog.mjs --fix70```71Scans all 200+ articles, auto-fixes broken ones, publishes the fixes.72Re-run audit afterwards to confirm `Broken: 0`.7374---7576## Config Files (what each contains)7778| File | Contains |79|---|---|80| `config/blink/COMPANY.md` | Company identity, CDN config, global CTA rules, brand language dos/don'ts |81| `config/blink/IMAGES.md` | CHARACTER ANCHOR, scene table by article type, 6 validated prompts, inline image system |82| `config/blink/markets/openclaw/COPY.md` | Market A: CTAs, talking points, pricing anchors, competitor positioning |83| `config/blink/markets/openclaw/CLUSTERS.md` | Market A: A1-A10 cluster definitions and keywords |84| `config/blink/markets/vibe-coding/COPY.md` | Market B: CTAs, talking points, pricing anchors, competitor positioning |85| `config/blink/markets/vibe-coding/CLUSTERS.md` | Market B: B1-B11 cluster definitions and keywords |86| `config/blink/markets/cursor-claude/COPY.md` | Market C: CTAs, happy path, builder section template, style rules |87| `config/blink/markets/cursor-claude/CLUSTERS.md` | Market C: C1-C8 cluster definitions and keywords |8889---9091## Directory Index9293| Path | What it contains |94|---|---|95| `SKILL.md` | **This file.** Entry point with Active Project config section. |96| `config/blink/COMPANY.md` | Company identity, CDN, global brand + CTA rules |97| `config/blink/IMAGES.md` | Clay character system, scene table, 6 example prompts |98| `config/blink/markets/openclaw/COPY.md` | Market A copy: CTAs, talking points, pricing, competitors |99| `config/blink/markets/openclaw/CLUSTERS.md` | Market A clusters: A1-A10 keywords and strategy |100| `config/blink/markets/vibe-coding/COPY.md` | Market B copy: CTAs, talking points, pricing, competitors |101| `config/blink/markets/vibe-coding/CLUSTERS.md` | Market B clusters: B1-B11 keywords and strategy |102| `config/blink/markets/cursor-claude/COPY.md` | Market C copy: CTAs, happy path, builder template, style rules |103| `config/blink/markets/cursor-claude/CLUSTERS.md` | Market C clusters: C1-C8 keywords and strategy |104| `prompts/ORCHESTRATOR.md` | **The brain.** Generic 6-phase pipeline — loads config at Phase 0 |105| `reference/VOICE.md` | **Writing voice.** 10 writing rules with real examples + blueprint cheat sheet. Read second (after brief, before SOP.md). |106| `reference/SOP.md` | **SOP.** Production workflow, article type templates, frontmatter schema, MDX component allowlist, SEO/external-link rules, publishing checklist |107| `reference/GEO.md` | **GEO + technical SEO.** AI citation optimization, schema markup, robots.txt, sitemap, llms.txt, verification commands |108| `scripts/validate-draft.mjs` | **Run before publishing.** Validates a draft: frontmatter, images, MDX safety, word count, stats, links. Exit 0=pass, 2=warnings, 1=fail |109| `scripts/process-inline-images.mjs` | **Run after writing.** Replaces INLINE_IMAGE comments with CDN-hosted images. Exit 0=processed, 2=no slots found, 1=fatal |110| `scripts/audit-fix-blog.mjs` | **Blog health guard.** Scans all CMS articles for MDX-breaking patterns, bulk auto-fixes. Run after every SEO run. |111| `scripts/audit-seo-health.sh` | **Technical audit.** Checks noindex, robots.txt, sitemap, schema, llms.txt, OG images |112| `scripts/check-competitor-serps.sh` | **SERP monitoring.** Checks SERP position for key keywords |113114---115116## Runtime Data (in .todo/seo/ — not in this skill)117118| Path | Purpose | Who writes it |119|---|---|---|120| `.todo/seo/SEO_PROFILE.md` | Markets, clusters, Global Priority Stack, live scores | Human + orchestrator |121| `.todo/seo/MANIFEST.md` | Run history — append after every run | Orchestrator |122| `.todo/seo/briefs/BRIEF_[slug].md` | Per-article research briefs | Research worker |123| `.todo/seo/drafts/DRAFT_[slug].mdx` | Article drafts in-flight | Writer worker |124125---126127## Quick Scripts128129```bash130# Validate a draft before publishing (checks frontmatter, images, MDX safety, links):131node .cursor/skills/ai-seo-articles/scripts/validate-draft.mjs .todo/seo/drafts/DRAFT_[slug].mdx132133# Process inline images (run after writing, before publishing):134node .cursor/skills/ai-seo-articles/scripts/process-inline-images.mjs .todo/seo/drafts/DRAFT_[slug].mdx135136# Technical SEO audit:137bash .cursor/skills/ai-seo-articles/scripts/audit-seo-health.sh138bash .cursor/skills/ai-seo-articles/scripts/audit-seo-health.sh http://localhost:3000 # against localhost139140# SERP presence check:141bash .cursor/skills/ai-seo-articles/scripts/check-competitor-serps.sh142143# Blog health audit (run after EVERY publish — mandatory Phase 5b gate):144node .cursor/skills/ai-seo-articles/scripts/audit-fix-blog.mjs # audit: list broken articles145node .cursor/skills/ai-seo-articles/scripts/audit-fix-blog.mjs --fix-strip # fast fix: strip HTML comments146node .cursor/skills/ai-seo-articles/scripts/audit-fix-blog.mjs --fix # full fix: generate images + strip147```148149---150151## Hard Stops (always enforced)152153- **B11 Customer Stories**: never write without real customer data provided by a human154- **B10 AI Comparisons**: cap at 5 total; never prioritise over P1-P14155- **Score gate**: nothing publishes below 90/110; three revision passes max, then hold156- **No duplicate keywords**: check MANIFEST.md before any brief157- **No fabricated data**: invented stats or quotes → editor rejects, writer rewrites with sources158- **Slug rules**: no year suffix (`-2026`). Timeless slugs. Exception: changelogs only159- **No manual CTAs**: auto-injected by rendering engine. DO NOT write CTA sections.160- **Zero HTML comments in published MDX**: `audit-fix-blog.mjs` must exit 0 (Broken: 0) before any run closes. HTML comments crash every page visitor. Note: `<!-- INLINE_IMAGE_* -->` slots are draft-only placeholders — the publish pipeline converts them to images before CMS. They must never appear in published content.161162---163164## End-of-Run Report Format1651661. Articles published (count + full production URLs, e.g. https://blink.new/blog/[slug])1672. Clusters worked + new coverage scores1683. One M2 backlink opportunity flagged for human action1694. What to prioritise next run1705. Articles held (with reason and score)
blink-new