🎁 Get the FREE AI Skills Starter Guide β€” Subscribe β†’
BytesAgainBytesAgain
πŸ¦€ ClawHub

AEO Content (Free)

by @psyduckler

Create or refresh AEO-optimized content that gets cited by AI assistants (Gemini, ChatGPT, Perplexity) using only free tools. Two modes: CREATE new content t...

Versionv1.0.0
Downloads1,511
Installs4
TERMINAL
clawhub install aeo-content-free

πŸ“– About This Skill


name: aeo-content-free description: > Create or refresh AEO-optimized content that gets cited by AI assistants (Gemini, ChatGPT, Perplexity) using only free tools. Two modes: CREATE new content targeting a specific prompt, or REFRESH existing content to improve AI citation-worthiness. Researches what AI models currently cite, builds a competitive brief, and produces citation-worthy content. Use when a user wants to: write content optimized for AI citations, create articles that show up in AI answers, refresh/update existing content for better AI visibility, build authority content for answer engines, or produce AEO content without paid tools. No API keys required β€” uses web_fetch, web_search (free tier), and LLM reasoning only. Pairs with aeo-prompt-research-free (which identifies WHAT to write about; this skill handles HOW to write or refresh it).

AEO Content Skill (Free)

> Source: github.com/psyduckler/aeo-skills > Part of: AEO Skills Suite β€” Prompt Research β†’ Content β†’ Analytics

Create or refresh content that AI assistants want to cite β€” using zero paid APIs.

Requirements

  • web_fetch β€” analyze currently-cited sources and existing content
  • web_search β€” find competing content (Brave free tier, optional)
  • LLM reasoning β€” research, brief, draft, and evaluate
  • Mode Detection

  • Create mode β€” User provides a target prompt but no existing URL β†’ write new content
  • Refresh mode β€” User provides an existing page URL (+ optional target prompt) β†’ audit and update
  • Input

  • Target prompt (required for create, optional for refresh) β€” the AI prompt this content should win
  • Brand/domain (required) β€” who the content is for
  • Existing URL (refresh mode) β€” the page to update
  • Topic context (optional) β€” additional info about the brand's angle
  • Content type (optional) β€” guide, comparison, how-to, explainer

  • Create Mode Workflow

    Step 1: AI Landscape Research

    Search the target prompt and close variants to understand the current answer landscape:

    1. Web search the exact prompt β€” search engines show similar sources to what AI cites 2. web_fetch the top 5-10 results β€” these are the pages AI models draw from 3. web_search for "[topic]" site:reddit.com β€” find real user questions and discussions

    For each top-ranking page, extract:

  • Main points and structure
  • Unique data, frameworks, or insights
  • Gaps β€” what they miss or get wrong
  • Freshness β€” when was it last updated?
  • Step 2: Build the Content Brief

    Use the template in references/content-brief-template.md to structure research.

    Key decisions:

  • Mandatory topics β€” every sub-topic the AI currently covers in its answer
  • Unique value angle β€” what will this content add that no current source provides? (Most important decision.)
  • Content structure β€” outline with H2/H3 headings that mirror question phrasing
  • Target specs β€” word count, format, tone
  • Step 3: Write Citation-Worthy Content

    Draft following citation signals from references/citation-signals.md. Key principles:

  • Lead each section with a direct, quotable 1-2 sentence answer
  • Use descriptive headings that match question phrasing
  • Include original data, frameworks, or expert perspective
  • Name specific tools, companies, people, statistics
  • Cover every sub-question the AI currently answers, then go deeper on 2-3 areas
  • Cut fluff β€” every paragraph earns its place
  • Step 4: Self-Evaluate

    Before delivering, check the draft against currently-cited sources:

    1. Coverage β€” addresses every topic the top sources cover? 2. Depth β€” goes deeper on at least 2-3 areas? 3. Uniqueness β€” offers something no current source has? 4. Extractability β€” AI can pull a direct answer from each section? 5. Entity richness β€” specific names, tools, numbers throughout? 6. Freshness β€” examples, data, references are current?

    Step 5: Deliver with Publishing Guidance

    Output final content plus title, meta description (150-160 chars), and:

  • Add publication date + author byline with credentials
  • Ensure page is indexable (no noindex, no paywall)
  • Add schema markup if applicable (FAQ, HowTo, Article)
  • Internal link from existing related content
  • Re-check target prompt in AI models 2-4 weeks after indexing

  • Refresh Mode Workflow

    Step R0: Audit the Existing Page

    Before any landscape research, analyze the current page:

    1. web_fetch the existing URL β€” get the full content 2. Extract current structure: headings, topics covered, depth per section 3. Note: publication date, last updated date, author info 4. Check freshness: outdated stats, old tool names, expired examples, stale references 5. Identify what's already strong (keep these sections)

    Step R1: AI Landscape Research

    Same as Create Step 1 β€” research what AI models currently cite for the target prompt. If no target prompt was provided, infer it from the page's topic and title.

    Step R2: Gap Analysis (Diff)

    Compare existing content against the competitive landscape:

  • Missing topics β€” sub-topics AI covers that the page doesn't β†’ flag for addition
  • Outdated info β€” old statistics, discontinued tools, expired examples β†’ flag for replacement
  • Missing entities β€” competitors, tools, people the AI mentions that the page doesn't β†’ flag for inclusion
  • Structural issues β€” buried answers, vague headings, no clear extractable statements β†’ flag for restructure
  • Freshness gaps β€” old dates, prior-year references β†’ flag for update
  • Strengths to preserve β€” sections already well-written, potentially already cited β†’ keep as-is
  • Output: a prioritized list of changes with rationale for each.

    Step R3: Edit (Not Rewrite)

    Apply changes surgically:

  • Add new sections for coverage gaps (place them logically in the existing structure)
  • Update outdated data points, examples, tool names, statistics
  • Restructure weak sections β€” add extractable lead sentences, improve headings
  • Weave in missing entities naturally (don't keyword-stuff)
  • Preserve sections that are already strong
  • Update publication/modified date
  • Output the refreshed content with clear markup showing changes:

  • [ADDED] β€” new sections or paragraphs
  • [UPDATED] β€” modified existing content
  • [RESTRUCTURED] β€” reorganized for better extractability
  • [UNCHANGED] β€” kept as-is (note why it's strong)
  • Step R4: Before/After Summary

    Provide a clear comparison:

  • What was added (new sections, topics, entities)
  • What was updated (stats, examples, references)
  • What was restructured (headings, lead sentences)
  • What was removed (outdated info)
  • Expected impact on citation-worthiness
  • Step R5: Self-Evaluate + Deliver

    Same 6-point evaluation as Create Step 4, plus:

  • Does the refresh maintain the page's existing voice and style?
  • Are all internal/external links still valid?
  • Is the updated date reflected?
  • Deliver with the same publishing guidance as Create Step 5.


    Tips

  • The unique value angle is make-or-break for both modes
  • For refresh: resist the urge to rewrite everything. Surgical edits that add missing pieces are more efficient and preserve existing authority
  • First-party data is the strongest citation signal β€” if the brand has relevant data, use it prominently
  • For comparison prompts ("X vs Y"), be balanced β€” AI models avoid citing biased sources
  • Shorter, sharper content that directly answers the prompt beats long rambling pieces
  • This skill pairs with aeo-prompt-research-free which identifies target prompts
  • πŸ“‹ Tips & Best Practices

  • The unique value angle is make-or-break for both modes
  • For refresh: resist the urge to rewrite everything. Surgical edits that add missing pieces are more efficient and preserve existing authority
  • First-party data is the strongest citation signal β€” if the brand has relevant data, use it prominently
  • For comparison prompts ("X vs Y"), be balanced β€” AI models avoid citing biased sources
  • Shorter, sharper content that directly answers the prompt beats long rambling pieces
  • This skill pairs with aeo-prompt-research-free which identifies target prompts