xuanran-seo-blog-writer

Plugin xuanran-seo-blog-writer from marketplace xuanran-seo-blog-writer-marketplace in XuanRanL/loamwright-SEO-Skill. Commands read from the repo's manifest — 1 month ago.

Skills (68)

• phase-build

  Run Phase Build — section drafting (N parallel agents), fact-check, citation injection, assembly. Use when research.json and outline.json exist and need to write the actual article body. Triggered by /seo-blog build, "draft the article now", "write the body".

• phase-monitor

  Run Phase Monitor — rank tracking, AI visibility tracking, drift detection, content refresh signals, performance reporting. Use for post-publish monitoring or scheduled checkup. Triggered by /seo-blog monitor, /perf, /rank-check, /drift, /ai-visibility, or as automated scheduled hook (T+7/14/30/90 a

• phase-optimize

  Run Phase Optimize — humanize, meta build, schema, internal link, GEO optimize, visual design, CTA module + deterministic lint gates (render / density / keyword / PAA alignment / locale spelling / local uniqueness) + 4 quality gates + repair escalation. Use when draft.md exists and needs polish + qu

• phase-publish

  Run Phase Publish — image generation sub-pipeline (provider-pluggable: relay primary + official OpenAI fallback, realtime-forced) + WordPress publish with RankMath meta + IndexNow ping. Use when draft has passed all quality gates and is ready for live publication. Triggered by /seo-blog publish, /pu

• phase-research

  Run Phase 1 Research only — keyword research, SERP analysis, competitor analysis, content gap analysis, surface targeting. Use when user wants research-only output without writing an article. Triggered by /seo-blog research, "research this keyword", "what's the SERP for X", "competitor analysis for"

• seo-blog

  Production-grade SEO + GEO content factory. Routes user intent to one of 5 phases (research / build / optimize / publish / monitor) or runs end-to-end. Use whenever the user wants to write a blog post, create SEO/GEO-optimized articles, refresh existing content, audit a page, or publish to WordPress

• website-audit

  Full website SEO audit — crawls up to 500 pages, detects business type, spawns up to 15 parallel specialist agents (8 always + 7 conditional), generates SEO Health Score (0-100) with enterprise HTML report. Completely standalone — not connected to the blog-writer pipeline. Triggers on: audit my site

• weekly-digest

  Production weekly industry-news digest: harvest Tier-A + Tier-B sources, assemble a digest article, publish as DRAFT, await explicit publish. Triggers on /weekly, 'industry weekly digest', 'weekly roundup', 'weekly report', '行业周报', '每周简报'. NOT a general article — does NOT run keyword-research/SERP/c

• batch-article

  Run /article end-to-end for a list of keywords. Each keyword goes through the FULL pipeline (research → plan → build → optimize → publish → monitor baseline). Use for agency-scale operations — drop 10-500 keywords, get 10-500 published articles. Resumable across sessions.

• brand-auto-tuner

  Analyze winner vs loser articles to find features that distinguish them, then suggest brand-guideline.yaml updates. Use after ≥10 articles have outcome tags. Closes the data-loop: production → measurement → learning → next-cycle adjustment.

• cost-estimator

  Pre-flight cost estimate for a planned /article run. Use BEFORE /article or when user asks "how much will this cost?" / "what's the estimate?". Outputs USD breakdown by category + 80% confidence band + budget check.

• cost-guard

  Budget enforcement. Estimate → check → log → summary. Daily total + per-init + per-article + per-image-batch caps from config.yaml. Triggered by every API call upstream.

• cost-summary

  Aggregate past spending (day/week/month) — total USD, per-model, per-endpoint. Use when user runs /cost or asks "how much have I spent?" / "what's my burn?" / "show me the bill".

• entity-optimizer

  PARKED (2026-07-17 wiring audit) — designed but never wired; nothing routes here and its companion agents/entity-extractor.md is equally unreachable. Track 47 entity signals per entity (per seo-geo). Maintains ai_resolution_status per engine (recognized/partial/unrecognized/confused). The ONLY skill

• fleet-view

  Multi-site agency dashboard. Use /fleet to see 100+ sites in one view — health, clicks, cost, drift alerts, by-client + by-vertical aggregation. Daily landing page for an operator managing many SEO projects.

• manifest-consistency-checker

  Verify VERSION + plugin.json + marketplace.json + install.sh + install.ps1 + CHANGELOG + __init__.py all agree on version. Auto-fix via --apply. Run via /guard --versions.

• memory-manager

  Manage HOT/WARM/COLD memory transitions, Wiki Phase 1/2/3 entity sedimentation, GDPR Art 17 purge. Triggered by hooks/stop_finalize.py + /forget-project command.

• persona-management

  Create + store + enforce writing personas using NNGroup 4-dimension tone framework. Personas define readability targets, sentence length distribution, vocabulary tier, contraction frequency, summary box label. Used by section-drafter + humanizer + rewrite to enforce consistent voice. Different from

• repair-orchestrator

  5-level repair escalation when quality gates fail. Surgical → Section-rewrite → Stage-rewrite → Full-regen → From-scratch. Hard cap 4 rounds total. Use when quality.json reports overall_passed=false OR reviewer rejects. Last line of defense before declaring an article unsalvageable.

• resume

  Resume an interrupted /article pipeline from its last checkpoint. Reads workspace state.json + verifies artifacts, decides whether to re-run the failing stage or jump forward. Use when /status shows a stuck task, network blip, OpenAI Batch wait, laptop sleep, etc.

• rewrite

  Rewrite + optimize an existing published article. 6-phase workflow (Audit → Research → Chart Gen → Content Rewrite → Verification → Summary). Preserves author voice while applying 6 pillars — fabricated stat replacement, answer-first formatting, AI-detection scrubbing, citation capsule injection, fr

• second-opinion

  Cross-model audit via Gemini (review / challenge / consult modes). Defends against same-model self-bias. Used before high-impact decisions (publish gate, /init final review).

• self-upgrade

  9-step in-place upgrade from marketplace remote. Triggered by bin/update-check returning UPGRADE_AVAILABLE OR /upgrade command. Backs up old version + git fetch + version sync + cache purge + changelog summary.

• status-reporter

  Show current pipeline state — in-progress tasks, current stage, elapsed time, accrued cost, ETA. Use when user runs /status or asks "what's the pipeline doing right now" or "is anything still running". Read-only — does not modify state.

• batch-job-poller

  Supplemental recovery tool for orphan official-OpenAI image batches (batch is only ever used on the official-OpenAI fallback path; the primary openclawroot relay has no Batch API). The canonical image flow (openai-image-generator) runs realtime and does not require this skill. Use only to diagnose s

• image-curator

  Produces image_metadata.json with all 4 WordPress media fields (title, alt_text, caption, description) per image slot. Runs AFTER image generation and BEFORE WordPress upload. Without this, captions and descriptions are empty in the media library and figcaptions never render in posts. Stage 27f of p

• image-post-processor

  After batch completes, runs 4-step post-processing on each image: EXIF strip → WebP convert (q85) → srcset 3 sizes → SEO filename. Generates ImageObject schema fragment. Stage 27e.

• image-prompt-designer

  Build shared Art Direction Prefix + per-slot 9-field prompts for the article's image slots (brief.image_count, default 6, max 8 — scripts/_core/image_policy.py). Uses Strategy A (shared prefix; per-slot variation). Reads brand-identity, brand-config, format_id. Produces image-prompts.json for openai

• image-slot-allocator

  Decide the article's image slots (brief.image_count, default 6 = 1 cover + 5 section images, max 8). Reads outline.json + format_id. Picks H2s to image based on per-format mapping in references/image/format-style-mapping.md. Triggered as Stage 27a of phase-publish image sub-pipeline.

• openai-image-generator

  Generate the article's images (count from image-prompts.json — brief.image_count via scripts/_core/image_policy.py, default 6, max 8) via the unified openai_image_pipeline (provider-aware: Vertex Gemini 3 Pro Image 4K primary + official OpenAI fallback, realtime-forced). Single-call pipeline replace

• project-forget

  GDPR Art 17 delete. Tombstone projects/{slug}/, schedule physical deletion in 30 days. Use /forget-project <slug>. Cannot be undone after 30d.

• project-list

  List all projects/{slug}/ with status (fresh/stale/expired). Use /list-projects.

• project-show

  Display current active project's PROJECT.md + brief stats. Use /show-project.

• project-switch

  Switch active project. Updates ~/.xuanran-seo/active-project pointer. All subsequent commands inherit new project's business-context. Triggered by /switch <slug>.

• website-project-init

  Initialize a new website project from a URL. FIRST asks the user for all required credentials (Anthropic / Tavily / OpenAI / WordPress App Password / brand config), then deep-scans the site (40 pages with 5-tier JS fallback waterfall), generates projects/{slug}/ archive (business-context, brand iden

• wordpress-category-setup

  Design and deploy a WordPress blog category taxonomy (top-level categories + subcategories) with descriptions, slugs, and RankMath SEO meta. Three modes — interactive (design from scratch with the user), apply (deploy an existing categories-config.json), refresh (re-sync to live site). Use when user

• ai-visibility-tracker

  Active probe of ChatGPT/PPLX/Claude/Gemini to check if our article is cited. Compares to projects/{slug}/geo-baseline.json. Triggered by /ai-visibility command or daily/weekly schedule.

• content-refresher

  Compute 0-100 decay score; trigger refresh workflow on aging articles. Score = 0.30×traffic + 0.25×rank + 0.15×ctr + 0.15×freshness + 0.15×replacement. Triggered by /refresh command or weekly schedule.

• drift-detector

  17-rule diff vs SQLite baseline. Detects: title/meta changed, schema removed, H1 changed, AI bots policy changed, broken internal links emerged, AIO citation lost, etc. Triggered by /drift command or scheduled weekly.

• performance-reporter

  Aggregate 30+ KPIs across rank/ai-visibility/drift/refresh for time-period view (week/month/quarter). Outputs human-readable executive summary. Triggered by /perf command.

• rank-tracker

  Query GSC for impressions/clicks/position; T+7/14/30/90 post-publish baselines. Outputs projects/{slug}/rank-history-{date}.json. Triggered by /rank-check command or scheduled monitor.

• ai-overview-recovery

  4-phase recovery when Google AI Overview drops an article. Measure damage → diagnose skip reason → rewrite → T+7/14/28 monitor. Triggered by drift-detector AIO loss alert OR /aio-recovery command.

• cta-placement

  Inject the project's designed CTA module (styled .xr-cta-box conversion card) into the draft. Config lives in business-context.json :: cta (legacy) or :: conversion_offers (v3.37 service-aware). Projects without either no-op.

• featured-snippet-optimizer

  RETIRED v3.35 (2026-07-04) — merged into the wired citation-capsule-builder stage. Featured snippets fell 18%→8% of SERPs in 2025 (83% replaced by AI Overviews) and both select the same 40-60w extractive answer shape; a separate FS step would duplicate the capsule stage.

• geo-content-optimizer

  Apply 6 GEO techniques + per-engine weighted optimization. Citation Capsules, Information Gain Markers, entity richness, Q&A structure, fact density, FAQPage schema.

• humanizer

  Detect 43 AI writing patterns + rewrite to specific human voice. 5×5 voice × purpose matrix + AI-Slop formula scoring + 3 modes (detect / rewrite / edit) + iterative N≤3 convergence. North star — LLMs regress to statistical mean; humans are weird, specific, inconsistent. Use after section-drafter, b

• internal-linker
• localization-pass
• meta-builder
• paa-answer-writer
• schema-generator
• visual-designer
• voice-search-optimizer
• brand-guideline-maker
• content-brief-builder
• editorial-calendar
• format-selector
• topic-clustering
• indexing-notifier
• schema-injector
• wordpress-publisher
• community-research
• competitor-analysis
• content-gap-analysis
• industry-news-monitor
• keyword-research
• serp-analysis
• surface-targeting

Subagents (34)

• audit-backlinks

  Analyzes backlink profile — referring domains, anchor text distribution, toxic link ratio, link velocity — using tiered sources from free Common Crawl through premium DataForSEO

• audit-cluster

  Maps topic clusters, detects keyword cannibalization via SERP overlap, validates hub-spoke internal linking, identifies orphan content, and surfaces content gap opportunities

• audit-content

  Evaluates E-E-A-T signals, readability, thin content detection, duplicate content, freshness, and AI citation readiness across crawled pages

• audit-drift

  Detects SEO regressions by comparing current crawl against a stored baseline using 17 comparison rules at 3 severity tiers — surfaces schema removals, canonical changes, noindex additions, CWV degradation

• audit-ecommerce

  Audits product page SEO — Product/Offer/AggregateRating schema, pricing consistency, variant handling, breadcrumbs, image count, description depth, shipping schema

• audit-geo

  Evaluates AI crawler access, llms.txt compliance, content citability, brand authority signals, and multi-platform GEO scoring (Google AIO, ChatGPT, Perplexity, Bing Copilot)

• audit-google

  Integrates CrUX field CWV, GSC indexation and query data, and GA4 organic traffic to enrich audit with first-party Google signals

• audit-local

  Evaluates local SEO signals — GBP optimization, NAP consistency, reviews, local schema, citation authority — for brick-and-mortar and SAB businesses

• audit-maps

  GBP 25-field completeness audit, review intelligence, competitor radius mapping, and geo-grid ranking analysis for local map pack optimization

• audit-performance

  Measures Core Web Vitals (LCP, INP, CLS), Lighthouse scores, and identifies resource optimization opportunities across key pages

• audit-schema

  Detects JSON-LD structured data presence, validates against schema.org specs, identifies deprecated types, and flags missing opportunities per page type

• audit-sitemap

  Audits XML sitemap structure, URL coverage, validity, freshness signals, and compliance with search engine limits

• audit-sxo

  Performs SERP backward analysis, page-type mismatch detection, user story derivation, persona scoring, and gap analysis across 7 dimensions for search experience optimization

• audit-technical

  Analyzes crawlability, indexability, security headers, URL structure, mobile-friendliness, JS rendering, and IndexNow signals for a target site

• audit-visual

  Captures desktop and mobile screenshots, evaluates responsive design, above-fold content, touch targets, and image optimization across key pages

• cta-writer

  Writes a genuinely unique, per-article CTA (heading + body copy, mid + end placements) given a resolved service/team/proof-point fact brief. Never invents facts or picks its own link.

• editor-in-chief

  Final reviewer of full assembled draft. Runs 12-item editorial checklist. The ONLY agent allowed to reverse-callback upstream (writer, humanizer, linker) for surgical fixes. Hard revision cap of 3 rounds before declaring done.

• entity-extractor

  SOLE writer of memory/entities/. Scans drafts + research for named entities (Org / Person / Product / Place / Concept). Creates new entity files + updates existing ones with 47 signals. Triggered by Wiki Phase progression rules (Phase 1 first mention; Phase 2 at 3+ mentions; Phase 3 at 10+).

• fact-checker

  Verifies every [claim:cN_S] marker by Crossref + Tavily lookup + link_resolver HEAD check. Builds References section (APA 7, ≤10 entries). Replaces in-text markers with (Author, Year). Has Web access (only besides researcher).

• geo-auditor

  GEO/AEO compliance scoring. Runs CITE 40-item + CORE-EEAT 80-item scorers + checks the 3 Vetoes (T04 fabricated stat / C01 fabricated citation / T09 deprecated schema) + 60-cap algorithm. Quality Gate 2 of 4 in the optimize phase. Outputs geo-audit.json with cap decision.

• head-of-research

  Synthesizes raw research artifacts into a clean research-brief for downstream skills. NO Bash/Web access — pure synthesis on existing artifacts. Reads research.json + keyword-research.json + serp-analysis.json + competitor-analysis.json and produces a 200-400 word executive brief plus a structured `

• humanizer

  Removes AI tells and applies voice + purpose calibration to existing draft. Edit for draft.md (preserves human edits), Write ONLY for humanizer-report.json output. Three modes: detect / rewrite / edit. Iterates max 3 times until AI-Slop score < 20.

• image-curator

  After batch-job-poller downloads images + image-post-processor finishes WebP/srcset, this agent polishes alt text per image, generates captions, replaces [IMAGE-SLOT-N] placeholders in draft.md, injects ImageObject schema. Final image step (Stage 27f).

• image-prompt-designer

  Designs the article's image prompts (count from brief.image_count via scripts/_core/image_policy.py — default 6, meaning cover + 5 section illustrations, max 8) using the 9-field Prompt Schema + Strategy A shared Art Direction Prefix. Output feeds openai-image-generator. NEVER calls image APIs direc

• image-visual-qa

  Vision QA for generated article images. Reads every PNG in images.json, scores 13 defect classes (composition, anatomy, garbled text, empty labels, brand drift, content mismatch, contrast, AI-look, chart legibility), rewrites prompts and triggers targeted regeneration (max 2 rounds), writes image-qa

• linker

  Inject internal links from brand link-map + add brand outbound links. Decides anchor text (must read 200-word context per link to choose naturally). Can read external pages via WebFetch to validate anchor relevance. Does NOT edit headings or facts.

• publisher

  Execute the 7-step WordPress publish flow with full rollback support. Reads workspace artifacts + invokes wp_publisher.py + tracks every action in change-log.json (7-day undo window). Only agent allowed to call WP REST API mutations. NOT for refresh — use rewrite skill for refresh.

• researcher

  Spawns to gather research on a keyword + topic — runs Tavily search/extract, Crossref lookups, web page fetches, and AI-search probes. The ONLY agent with Web access. Used by phase-research orchestrator and /init Stage 1-8.

• reviewer

  Independent reviewer with NO pipeline history. Reviews final draft as fresh editor (Google E-E-A-T + Perplexity citation judge). Outputs review.json with 0-100 score + 3 "would change". Reverses to repair-orchestrator if score < target. Quality Gate 4 of 4.

• schema-generator

  Generates body JSON-LD (FAQPage + ItemList, ≥2 blocks) for a finished draft and WRITES it to the workspace schema.json. Distinct from schema-validator (which only inspects/validates). Dispatched by the optimize-phase schema-generator stage.

• schema-validator

  Deep JSON-LD validation. Runs Google Rich Results compatibility check + Schema.org spec compliance + deprecated type detection. Used by geo-auditor as part of T09 veto check, and standalone via /validate-schema before publish.

• seo-auditor

  Runs all deterministic SEO scoring scripts on a draft and aggregates into a single SEO score (0-100). Operates ENTIRELY through scripts — no LLM judgment of its own. Quality Gate 1 of 4 in the optimize phase. Outputs seo-audit.json + recommendations.

• visual-designer

  Restructures an already-humanized, fact-checked draft into well-designed, scannable visual components (comparison tables, cited-stat \"By the Numbers\" grids, authoritative quotations, TL;DR box, glossary cards, sparing callouts) using ONLY native markdown that the project's scoped CSS styles. Never

• writer

  Writes ONE H2 section of a blog post given a section spec + research brief + style references. PHYSICALLY OFFLINE (no Bash, no WebFetch, no WebSearch in tool whitelist) — must use only the curated context provided. Spawned in parallel by phase-build section-drafter (N agents, one per H2).

Hooks (5)

• SessionStart

  python ${CLAUDE_PLUGIN_ROOT}/hooks/session_start_load_project.py

• PreToolUse

  python ${CLAUDE_PLUGIN_ROOT}/hooks/pre_tool_use_cost_guard.py

• PostToolUse

  python ${CLAUDE_PLUGIN_ROOT}/hooks/post_tool_use_schema_validate.py

• PostToolUse

  python ${CLAUDE_PLUGIN_ROOT}/hooks/post_tool_use_artifact_gate.py

• Stop

  python ${CLAUDE_PLUGIN_ROOT}/hooks/stop_finalize.py

Similar plugins