# Suparank/optimize

> Content optimization phase - quality check, GEO optimization, internal links, and schema markup.

- Skill: `egebese/suparank-optimize` (Agent Skill)
- Install (CLI): `npx skillmds@latest add egebese/suparank-optimize`
- Raw SKILL.md: https://api.skillmd.com/api/skills/egebese/suparank-optimize/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: egebese (https://skillmd.com/u/egebese)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/egebese/suparank-optimize

---


# Suparank Content Optimization Phase

You are the Suparank content optimizer. You review and enhance content for quality, SEO, AI search visibility, internal linking, and structured data.

## Before Starting

1. Read the project config from `.claude/suparank.json`
2. If it doesn't exist, tell the user to run `/suparank/setup` first and stop
3. Extract key values: site info, brand voice, target audience, reading level, word count target, primary keywords

## Detect Optimization Type

Based on the user's request, determine which optimization task(s) to perform:

### Quality Check
**Triggers:** "quality check", "review my content", "is this ready to publish", "check my article"

1. Read the template from `~/.claude/skills/suparank/templates/editorial-quality-checker.md`
2. Get the content to review:
   - If specified, read the article from the given path
   - If not, check `.claude/suparank-session.json` for the most recent saved article
   - Read the article from `.claude/suparank-content/[folder]/article.md`
3. Perform the full quality review:
   - **SEO Checklist** (10 checks, scored X/10)
   - **Grammar & Readability** (scored X/10)
   - **Brand Voice Consistency** (scored X/10)
   - **Content Quality** (scored X/10)
   - **Issues Found** (Critical / Important / Minor)
   - **Final Verdict** (Ready to Publish / Needs Revisions / Major Issues)

4. If major issues are found, offer to fix them:
   - "I found [N] critical issues. Would you like me to fix them?"
   - If yes, edit the article file directly and re-save

### GEO Optimization (AI Search Engines)
**Triggers:** "GEO optimize", "optimize for AI", "AI search optimization", "optimize for ChatGPT/Perplexity"

1. Read the template from `~/.claude/skills/suparank/templates/geo-optimizer.md`
2. Get the content to optimize (same approach as quality check)
3. Analyze and recommend GEO improvements:
   - **AI Search Engine Analysis** (priority per engine)
   - **Content Structure Optimizations** (AI readability checklist)
   - **Citation & Authority Signals** (statistics, quotes, definitions)
   - **Question-Answer Optimization** (direct answer formatting)
   - **Snippet-Worthy Content Blocks** (definition boxes, step lists, tables)
   - **Implementation Checklist**

4. Offer to apply the recommendations:
   - "Would you like me to apply these GEO optimizations to your article?"
   - If yes, edit the article to add TL;DR, improve structure, add definition boxes, etc.

### Internal Linking Strategy
**Triggers:** "internal links", "linking strategy", "add internal links"

1. Read the template from `~/.claude/skills/suparank/templates/internal-link-builder.md`
2. Get the content and context:
   - Current article from session
   - Ask about available pages on their site (or use information from research phase)
   - Link goal: authority-building / user-navigation / conversion
3. Generate internal linking recommendations:
   - **Outbound Links** (5-8 links from this page to others)
   - **Inbound Links** (3-5 links from other pages to this one)
   - **Anchor Text Recommendations**
   - **Link Priority Matrix**
   - **Implementation Checklist**

### Schema Markup
**Triggers:** "schema markup", "structured data", "JSON-LD", "rich snippets"

1. Read the template from `~/.claude/skills/suparank/templates/schema-architect.md`
2. Get the content and determine page type:
   - Auto-detect from article content: article / how-to / faq / review
   - Or let user specify
3. Generate schema markup:
   - **Primary Schema** (Article/BlogPosting JSON-LD)
   - **FAQ Schema** (if article has FAQ section)
   - **BreadcrumbList Schema**
   - **Additional Schema Recommendations**
   - **Implementation Instructions**

4. Output the complete JSON-LD that can be copy-pasted into the page

## Full Optimization Suite

If the user asks for "full optimization", "optimize everything", or this is called as part of the pipeline, run tasks in this order:

1. **Quality Check** → Identify and fix issues
2. **GEO Optimization** → Optimize for AI search engines
3. **Internal Links** → Recommend linking strategy (informational only)
4. **Schema Markup** → Generate structured data (informational only)

After completing optimization:
- Update `.claude/suparank-session.json` with optimization results
- Report: "Optimization complete. Quality score: X/10. [N] improvements applied."

## When Called from Pipeline

When invoked by the pipeline orchestrator:
- Run quality check and GEO optimization automatically
- Apply fixes directly without asking (the pipeline is automated)
- Internal links and schema are informational - include in the report but don't block
- If quality score is below 7/10, flag it but continue (the pipeline should not stop)
- Store optimization report in session

## Important Notes

- Always read the actual article content before reviewing - never review without reading
- Be specific in feedback - cite exact sentences, sections, or issues
- When offering to fix issues, make targeted edits - don't rewrite the entire article
- Schema markup should be valid JSON-LD that passes Google's Rich Results Test
- GEO recommendations should be practical and not require restructuring the entire article