by onvoyage-ai
Claude Code skill for improving website AEO (AI Engine Optimization) and GEO (Generative Engine Optimization) scores — 16 foundational checks, 6 intelligence dimensions, framework-specific fixes
# Add to your Claude Code skills
git clone https://github.com/onvoyage-ai/gtm-engineer-skillsA collection of agent skills for go-to-market engineering — research, content, SEO, GEO, and frontend implementation. The repo is meant to work for both Codex and Claude Code.
Skills are designed to run in sequence. Each step produces files that feed into the next.
flowchart TD
RB["research-brand<br/>URL → brand_dna"]
RK["research-keywords<br/>→ keyword_research"]
ROR["reddit-opportunity-research<br/>→ reddit_opportunities"]
GCR["geo-content-research<br/>→ geo_prompt_targets"]
GCP["geo-content-planning<br/>→ content_architecture"]
BB["build-backlinks<br/>→ backlink_plan"]
WSGC["write-seo-geo-content<br/>→ markdown articles"]
CGC["create-geo-charts<br/>→ SVG + data tables"]
AC["audit-content<br/>verify sources"]
BRP["build-resource-pages<br/>content → frontend"]
IAG["improve-aeo-geo<br/>website code fixes"]
RB --> RK
RB --> ROR
RB --> GCR
RK --> GCP
ROR --> GCP
GCR --> GCP
ROR --> BB
GCR --> BB
GCP --> WSGC
GCP --> CGC
WSGC --> AC
CGC --> AC
AC --> BRP
AC --> IAG
| Step | Skill | Input | Output |
|------|-------|-------|--------|
| 1 | research-brand | Company URL | brand_dna.md — positioning, audience, competitors, voice |
| 2a | research-keywords | Brand DNA + product category | keyword_research.md — prioritized keywords by intent |
| 2b | reddit-opportunity-research | Brand DNA + optional keyword/GEO files | reddit_opportunities.md — ranked subreddit and thread opportunities |
| 2c | geo-content-research | Brand DNA + product category | geo_prompt_targets.md — AI prompts by business-value tier |
| 3 | geo-content-planning | Brand DNA + keywords + GEO prompts + Reddit signals | content_architecture.md — page plan with types, URLs, priority |
| 4a | write-seo-geo-content | Content architecture + research | Markdown articles with frontmatter |
| 4b | create-geo-charts | Data from articles | SVG charts + HTML tables + JSON-LD |
| 5 | audit-content | Articles + Brand DNA | Audit reports — verified URLs, stats, claims |
| 6a | build-resource-pages | Audited content + client codebase | Frontend resource center pages |
| 6b | improve-aeo-geo | Client website codebase | Code fixes for AI discoverability |
Steps marked a/b/c can run in parallel.
Clone the repo once, then make whichever skill folders you want available to Codex or Claude Code.
git clone https://github.com/onvoyage-ai/gtm-engineer-skills.git
cd gtm-engineer-skills
Each skill lives in its own folder and uses a SKILL.md file, which matches the shared agent-skills pattern used across both tools.
Symlink or copy the desired skill folders into ~/.codex/skills/ (or $CODEX_HOME/skills/ if you use a custom Codex home).
mkdir -p ~/.codex/skills
ln -s "$PWD/research-brand" ~/.codex/skills/research-brand
ln -s "$PWD/reddit-opportunity-research" ~/.codex/skills/reddit-opportunity-research
Symlink or copy the desired skill folders into ~/.claude/skills/ or a project-local .claude/skills/ directory.
mkdir -p ~/.claude/skills
ln -s "$PWD/research-brand" ~/.claude/skills/research-brand
ln -s "$PWD/reddit-opportunity-research" ~/.claude/skills/reddit-opportunity-research
The reddit-opportunity-research workflow is useful in either tool, but the exact Reddit access experience differs by product. ChatGPT already has native Reddit access in-product; Claude generally does not, so keep that in mind when comparing outputs.
Researches a company from its URL and produces a Brand DNA file covering positioning, audience, competitors, voice, and messaging.
Folder: research-brand/
Finds high-value SEO and GEO keywords using web search, AI analysis, and optionally paid tools like Ahrefs or Semrush.
Folder: research-keywords/
Finds Reddit pain-point discussions, target subreddits, and search-language patterns based on Brand DNA. Produces a ranked opportunity list for helpful promotion, content seeding, and prompt research.
Folder: reddit-opportunity-research/
Researches what prompts people ask AI engines about a product category. Produces a GEO prompt target table with business-value tiers (Buy/Solve/Learn).
Folder: geo-content-research/
Reads brand DNA, keyword research, and GEO prompt targets, then produces a content architecture — what pages to create, their types, URLs, and priority.
Folder: geo-content-planning/
Writes product-led content pages optimized for search engines and AI engine citations. Research-first methodology with page-type frameworks and no fabricated stats.
Folder: write-seo-geo-content/
Creates data visualizations that AI engines can parse, quote, and cite. Every chart includes a text summary, HTML data table, and JSON-LD.
Folder: create-geo-charts/
Verifies truthfulness, accuracy, and link integrity of content before publishing. Catches fabricated statistics, dead URLs, and misattributed sources.
Folder: audit-content/
Takes existing content markdown files and builds production-ready resource center pages on client websites using their existing tech stack and design system.
Folder: build-resource-pages/
Audits a website codebase and makes code changes so AI engines can better discover, parse, quote, and cite the site.
Folder: improve-aeo-geo/
Check your score first: aeo-audit.sh
See CONTRIBUTING.md for how to contribute new skills, improve existing ones, or add examples.
MIT — see LICENSE.
No comments yet. Be the first to share your thoughts!
Based on votes and bookmarks from developers who liked this skill