Agent skill · Security

blog-rewrite

Rewrite and optimize existing blog posts for Google SEO (May 2026 Core Update, E-E-A-T) and AI citation visibility as one SEO discipline. For AI-citation-only audit (no Google work), use blog-geo instead. Replaces fabricated statistics with sourced data, applies answer-first formatting, adds images, generates SVG charts, and updates freshness signals. Works with any blog format (MDX, markdown, HTML). Use when user says "rewrite blog", "optimize blog", "update blog", "improve blog", "fix blog".

AgriciDanielgithub.com/AgriciDanielGitHub ↗
claude-codeMIT
Install
npx skills add AgriciDaniel/claude-blog --skill blog-rewrite --agent claude-code

Same command for any agent — swap --agent for codex, cursor, copilot.

Facts
Files in the skill folder: 1
SKILL.md size: 18 KB
Bundled scripts: none
Path: skills/blog-rewrite/SKILL.md
Open the folder on GitHub →
Where it comes from
Stars: 1,566
Language: Python

Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.

Review
written from the skill's own SKILL.md · Aug 5, 2026

What it does

Rewrites and optimizes existing blog posts to improve Google SEO (May 2026 Core Update, E-E-A-T) and AI citation visibility as a single discipline. If auditing for AI-citation-only work, it uses blog-geo instead. It replaces fabricated statistics with sourced data, applies answer-first formatting, adds images, generates SVG charts, and updates freshness signals. It works with MDX, markdown, or HTML blog formats. Use when the user asks to rewrite, optimize, update, improve, or fix a blog.

How it works

  1. Audit phase reads the blog post, detects format, and runs a quality checklist against predefined references.
  2. Assesss for frontmatter issues, sets lastUpdated only if facts changed, fixes meta description, and ensures cover images and OG images exist or are generated.
  3. Apply purpose-first formatting to present key claims with verified evidence.
  4. Replace any fabricated statistics with real data from tier 1-3 sources, including provenance details.
  5. Improve headings to incorporate keywords naturally and ensure two to three headings contain the target terms.
  6. Adjust paragraph lengths and preserve the author’s voice, original insights, and existing images/charts where possible.
  7. Add or improve visual elements: embed relevant images and SVG charts, insert video embeds if appropriate, and ensure adaptions for platform format.
  8. Add or improve FAQ if warranted and ensure proper markup considerations.
  9. Reduce self-promotion to a maximum of one brand mention in author context and convert promotional sections into educational content.
  10. Add evidence-backed explanations for important claims, with self-contained sourcing notes.
  11. Review for project voice consistency: replace AI phrases, vary sentence length, and insert concise, readable phrasing.
  12. If needed, attach markers for original data or unique insights (e.g., [ORIGINAL DATA], [UNIQUE INSIGHT]).
  13. Run verification checks across core quality gates and editorial style before finalizing.

When to use it

Use when the user explicitly requests to rewrite, optimize, update, improve, or fix a blog post.

What it can touch

  • It works with blog content in MDX, Markdown, or HTML formats.
  • It can reference and apply assets such as images and charts per the workflow guidelines.
  • It can generate or integrate SVG charts and YouTube video embeds when appropriate per the workflow.

Caveats

  • Changes depend on availability of sourced data and assets; limitations in citations or image sources should be noted in the audit if present.
  • FAQPage is treated as optional, and the tool follows the guideline that Google FAQ rich results were retired as of 2026-05-07.
  • The process emphasizes factual accuracy and provenance for all substituted statistics.
From the SKILL.md

# Blog Rewriter: Optimize Existing Posts Rewrites and optimizes existing blog posts for dual ranking: Google search and AI citation platforms. Preserves the author's voice while applying the 6 pillars of optimization. **Key references:** - `skills/blog/references/quality-scoring.md` - 5-category scoring (Content 30, SEO 25, E-E-A-T 15, Technical 15, AI Citation 15) - `skills/blog/references/eeat-signals.md` - Experience, expertise, authority, trust markers - `skills/blog/references/internal-linking.md` - Linking strategy and anchor text rules - `skills/blog/references/visual-media.md` - Image sourcing and chart styling - `skills/blog/references/synthesis-contract.md` - 6 LAWs for re-citation hygiene during rewrite (v1.8.0; cross-skill ref lives in the orchestrator's references dir) - `skills/blog/references/research-quality.md` - cross-source clustering for replacement-statistic research (v1.8.0) ## Cross-reference For 21 evidence-led optimization prompts (quality follow-up, CTR audit, schema, PAA rewording, technical audit, ChatGPT visibility) directly applicable to rewrite work, see `/blog flow optimize`. ## Workflow ### Phase 1: Audit (Read-Only) 1. **Read the blog post** - Dete

What's inside
Steps it walks through
  1. Cross-reference
  2. Workflow
  3. Phase 1: Audit (Read-Only)
  4. Phase 2: Research
  5. Phase 3: Chart Generation (Built-In)
  6. Phase 4: Content Rewrite
  7. Phase 5: Verification
  8. Phase 6: Summary
  9. Phase 5.5: Delivery Contract Enforcement (v1.9.0)
  10. Update Mode
More from claude-blog
All skills →
About this skill
What does the blog-rewrite skill do?

Rewrite and optimize existing blog posts for Google SEO (May 2026 Core Update, E-E-A-T) and AI citation visibility as one SEO discipline. For AI-citation-only audit (no Google work), use blog-geo instead. Replaces fabricated statistics with sourced data, applies answer-first formatting, adds images, generates SVG charts, and updates freshness signals. Works with any blog format (MDX, markdown, HTML). Use when user says "rewrite blog", "optimize blog", "update blog", "improve blog", "fix blog".

How do I install it?

Run `npx skills add AgriciDaniel/claude-blog --skill blog-rewrite --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.

Where does this skill come from?

From AgriciDaniel/claude-blog, a repository with 1,566 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.

Is a popular skill a good skill?

Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.

Keep going