content-expand

Expands and optimizes existing Markdown articles with research, internal links, and SEO schema updates.

6|Updated Mar 27, 2026
One-click install
npx skills add https://github.com/greglas75/zuvo --skill content-expand-greglas75
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: content-expand
Source: https://github.com/greglas75/zuvo/tree/main/skills/content-expand
Command: npx skills add https://github.com/greglas75/zuvo --skill content-expand-greglas75

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Existing articles often go stale, stay thin on subtopics, or miss SEO opportunities, and manually researching, expanding, and re-optimizing them is slow and inconsistent. This Skill takes an existing .md or .mdx article, researches the topic, adds missing sections, and re-optimizes the result in one pass while preserving the original text and voice. ## Core Features & Use Cases - Research-driven expansion: Runs targeted web searches, builds a sourced fact sheet, and adds new sections and paragraphs around the original content without rewriting it (unless --rewrite is passed for concrete defects). - Quality pipeline: Scores prose against a PQ1-PQ18 registry, applies anti-slop and humanization rules, runs adversarial review, and rolls back any section whose score regresses. - SEO and internal linking: Discovers related articles from a content collection via --site-dir, inserts verified internal links, and updates schema, FAQ markup, and modification-date fields per the local content schema. - Use Case: You have a 600-word blog post that underperforms. Run the Skill on the file with --site-dir pointing at your content folder to expand it with researched facts, add internal links, and upgrade its schema while keeping your original wording intact. ## Quick Start Expand and optimize the article at posts/my-guide.md using my content collection at ./content for internal links, and show me a dry-run diff first.

Frequently Asked Questions about content-expand

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

FAQPage Schema
How do I expand a thin blog article without rewriting it?

Run the Skill on the .md or .mdx file path. By default it never modifies existing sentences; it only adds new paragraphs, sections, intros, or conclusions around the original text. Use --rewrite only to fix concrete defects like factual errors.

How to add internal links to existing Markdown content automatically?

Pass --site-dir pointing to your content collection root. The Skill scans 10-20 articles, picks the 5 most topically related, and inserts 2-5 contextual links, validating each target file before insertion.

Can I preview article changes before they are written?

Yes, use the --dry-run flag. It prints a before/after diff of all proposed changes without writing to the file, and skips the backup step since nothing is mutated.

Does it work with MDX files and frontmatter?

Yes, .md and .mdx are supported, and .html is tolerated with tags stripped. MDX components and code blocks are extracted as protected regions, and only mutable frontmatter fields like title and description can change.

Why does the expansion stop with a dirty file error?

The Skill runs a git status check on the target file and stops if there are uncommitted changes, to avoid mixing its edits with yours. Commit or stash the file first, or use --dry-run which proceeds with a warning.

What are the limitations of automated article expansion?

It cannot write articles from scratch, fix encoding issues, or publish to a CMS. If web search is unavailable it falls back to LLM knowledge marked as limited research, and binary files are rejected outright.