blog-rewrite

Rewrites existing blog posts for Google rankings and AI citation readiness.

Updated Jul 10, 2026
One-click install
npx skills add https://github.com/captaindevv/SEO-ajaypipes --skill blog-rewrite-captaindevv
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: blog-rewrite
Source: https://github.com/captaindevv/SEO-ajaypipes/tree/main/skills/blog-rewrite
Command: npx skills add https://github.com/captaindevv/SEO-ajaypipes --skill blog-rewrite-captaindevv

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve? Existing blog posts often contain fabricated statistics, AI-detectable phrasing, missing FAQ schema, and weak formatting that hurt both Google rankings and AI citation visibility. This Skill audits and rewrites posts end-to-end so they score higher across content quality, SEO, E-E-A-T, technical elements, and AI citation readiness. ## Core Features & Use Cases - Full audit and scoring: Runs a read-only audit covering fabricated statistics, answer-first formatting, AI content detection (burstiness, TTR, banned phrases), video embeds, and keyword cannibalization, then scores the post out of 100. - Structured rewrite pipeline: Replaces unsourced data with tier 1-3 sourced statistics, applies answer-first H2 formatting, injects FAQ schema, citation capsules, key-takeaway boxes, and information gain markers, and adds images, SVG charts, and YouTube embeds. - Delivery contract enforcement: Re-renders the post, dispatches a reviewer agent with a 90/100 threshold, runs preflight checks, and iterates up to 3 times before delivery. - Use Case: A content team has an underperforming MDX blog post with unsourced claims. Run the rewrite workflow to audit it, replace the statistics with sourced data, add FAQ schema and charts, and receive a verified, higher-scoring draft ready to publish. ## Quick Start Rewrite and optimize the blog post at content/posts/my-old-post.md for Google rankings and AI citations.

Frequently Asked Questions about blog-rewrite

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

FAQPage Schema
How do I optimize an existing blog post for Google rankings?▼

Run the rewrite workflow on the post file. It audits the content against a 100-point quality score, replaces fabricated statistics with sourced data, applies answer-first H2 formatting, fixes paragraph lengths, and injects FAQ schema before delivering a verified rewrite.

How to make blog content citable by AI assistants?▼

The rewrite adds citation capsules: 40-60 word self-contained passages per H2 section with one claim, one data point, and source attribution. It also adds key-takeaway boxes and information gain markers so AI systems can extract and quote the content directly.

Does the blog rewrite work with MDX and HTML formats?▼

Yes, the workflow detects the post format automatically and adapts embeds and schema markup for MDX, markdown, or HTML. For MDX posts it also builds the project to verify no compilation errors after rewriting.

How does AI content detection work in the rewrite audit?▼

The audit measures sentence-length burstiness (target SD above 6), type-token ratio (target above 0.50), and scans for known AI phrases and structural patterns like question-cadence headings. It reports an estimated AI content percentage before and after rewriting.

What happens if the rewritten post scores lower than the original?▼

A lower score than the original is treated as a P0 blocking condition. The delivery contract requires a reviewer score of 90/100 or higher with zero P0 issues, and the workflow iterates up to 3 times before stopping with a diagnostic report.

When should I use a GEO audit instead of a full blog rewrite?▼

Use the AI-citation-only audit when you only need GEO/AEO improvements without Google ranking work. The full rewrite covers both Google rankings and AI citations, including statistic replacement, charts, and schema injection.