geo-optimize

Rewrites local-SEO page drafts to increase citation in AI-generated answers.

1|Updated Jul 8, 2026
One-click install
npx skills add https://github.com/codesofadan/danyals-aios --skill geo-optimize-codesofadan
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: geo-optimize
Source: https://github.com/codesofadan/danyals-aios/tree/main/backend/seo-content-os/.claude/skills/geo-optimize
Command: npx skills add https://github.com/codesofadan/danyals-aios --skill geo-optimize-codesofadan

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve? Local business pages often rank in traditional search but are never cited inside AI answers from Google AI Overviews, ChatGPT, Perplexity, or Gemini. This Skill rewrites a page draft against the evidenced, page-controllable levers that lift AI-answer citation, then verifies the result with a linter. ## Core Features & Use Cases - Direct-answer-first restructuring: Converts essay-style sections into self-contained passage blocks whose opening sentences answer the buyer question outright, making them extractable by AI engines. - Evidence injection: Adds sourced statistics and real operator quotes pulled from the client's brand.yaml and SME interview notes, never fabricated facts. - Automated verification: Runs scripts/geo_page_linter.py before and after editing, plus readability_scorer.py and keyword_density.py, to confirm the draft passes. - Use Case: A plumber's service page ranks on page one but never appears in AI Overviews. Run this Skill on the draft to restructure its H2s, inject real pricing and response-time data, add an operator quote, and receive a GEO note listing the off-page entity gaps (GBP, NAP, reviews) still blocking citation. ## Quick Start Optimize my draft page.md for AI-answer citation using the geo-optimize levers and verify it with the linter.

Frequently Asked Questions about geo-optimize

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

FAQPage Schema
How do I optimize a page for Google AI Overviews citation?▼

Restructure each H2 into a passage block whose first sentences directly answer the buyer question, then add sourced statistics and a real operator quote. Run geo_page_linter.py on the draft to verify the changes pass before publishing.

How to get a local business page cited in ChatGPT and Perplexity answers?▼

AI engines favor extractable, specific content: direct-answer-first sections, concrete numbers with sources, and first-hand expert quotes. Off-page entity corroboration such as GBP completeness, NAP consistency, and third-party reviews is also required and flagged separately.

Does keyword stuffing help with AI answer citation?▼

No. Keyword stuffing is the only tactic shown to reduce citation in the underlying Princeton study, and it is a spam signal under compliance rule B3. The Skill rewrites exact-match repetition for variety and verifies with keyword_density.py.

Can this skill help a page pass AI content detectors?▼

No, and it explicitly refuses to. Detector scores have near-zero correlation with rankings, so detector-evasion is a hard line. The Skill makes pages more specific and extractable, which reads human because the content is substantive.

What are the limitations of on-page GEO optimization?▼

The largest local-citation lever is off-page entity corroboration, which the page cannot fix. The Skill surfaces missing items like GBP completeness, NAP consistency, reviews naming service and city, and Wikidata or sameAs presence as ops flags rather than pretending the page alone wins the citation.