Skip to content

onvoyage-ai/gtm-engineer-skills

Repository files navigation

GTM Engineer Skills

Search is shifting from blue links to AI answers — and the GTM playbook that won on Google does not win on ChatGPT, Claude, or Perplexity. Most AI agents still respond with generic marketing copy that no one will rank, cite, or publish.

This repo is a different kind of toolkit. Each skill is a focused agent workflow that ships a concrete GTM artifact — a brand DNA doc, a keyword or GEO prompt cluster, a content architecture, AI-citable charts, an AEO audit, a backlink plan, or code-level website fixes. Outputs are files an operator can review, publish, test, or hand to the next skill in the pipeline.

What this repo helps you do

Goal Skills to use Output
Understand a market and brand research-brand, research-keywords, geo-content-research Brand DNA, SEO/GEO keyword clusters, AI prompt targets
Find demand in real communities reddit-opportunity-research, build-backlinks Subreddit opportunities, thread patterns, backlink and mention plan
Plan content that can rank and get cited geo-content-planning, write-seo-geo-content Content architecture, product-led article drafts, page briefs
Add evidence and visual assets create-geo-charts, audit-content AI-readable charts, data tables, JSON-LD, source verification
Ship resource pages build-resource-pages Frontend pages built into a client codebase
Improve AI discoverability audit-website-aeo, improve-aeo-geo A-F audit report, prioritized fixes, code changes

Why it exists

Search is shifting from ranked blue links to answer engines: ChatGPT, Claude, Perplexity, Google AI Overviews, and other AI surfaces. Winning there requires different work:

  • Pages need direct answers, clear structure, sources, and quotable passages.
  • Charts need text layers, tables, and structured data, not just pixels.
  • Content plans need to account for prompts, communities, and citations, not only keyword volume.
  • Websites need technical signals that crawlers and AI systems can parse reliably.

These skills turn that work into repeatable agent workflows.

Workflow

The skills are designed to run as a pipeline. Each stage creates files that become context for the next stage.

flowchart TD
    RB["research-brand<br/>URL -> brand_dna.md"]

    RK["research-keywords<br/>-> keyword_research.md"]
    ROR["reddit-opportunity-research<br/>-> reddit_opportunities.md"]
    GCR["geo-content-research<br/>-> geo_prompt_targets.md"]

    GCP["geo-content-planning<br/>-> content_architecture.md"]
    BB["build-backlinks<br/>-> backlink_plan.md"]

    WSGC["write-seo-geo-content<br/>-> markdown articles"]
    CGC["create-geo-charts<br/>-> SVG/HTML/CSV/JSON-LD"]

    AC["audit-content<br/>-> verified claims and sources"]

    BRP["build-resource-pages<br/>-> frontend pages"]
    AWA["audit-website-aeo<br/>-> scored audit report"]
    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
    AWA --> IAG
Loading

Quickstart

Clone the repo, then symlink the skills you want into your agent's skill directory.

git clone https://github.com/onvoyage-ai/gtm-engineer-skills.git
cd gtm-engineer-skills

Codex

mkdir -p ~/.codex/skills
ln -s "$PWD/research-brand" ~/.codex/skills/research-brand
ln -s "$PWD/research-keywords" ~/.codex/skills/research-keywords
ln -s "$PWD/geo-content-planning" ~/.codex/skills/geo-content-planning
ln -s "$PWD/audit-website-aeo" ~/.codex/skills/audit-website-aeo

Claude Code

mkdir -p ~/.claude/skills
ln -s "$PWD/research-brand" ~/.claude/skills/research-brand
ln -s "$PWD/research-keywords" ~/.claude/skills/research-keywords
ln -s "$PWD/geo-content-planning" ~/.claude/skills/geo-content-planning
ln -s "$PWD/audit-website-aeo" ~/.claude/skills/audit-website-aeo

Each skill folder contains a SKILL.md file and, when useful, a README, examples, scripts, or schemas.

Example prompts

Use one skill at a time:

Use research-brand on https://example.com and create brand_dna.md.
Use research-keywords with brand_dna.md to find SEO and GEO keyword clusters for this product category.
Use audit-website-aeo on https://example.com with a 20 page crawl and produce a prioritized AEO/GEO audit.

Or run a longer workflow:

Use this repo's GTM skills to research the brand, find SEO/GEO opportunities,
build a content architecture, draft the first two resource pages, and audit the
claims before publishing.

Skills

Skill Use it for Main output
research-brand Understand positioning, audience, competitors, voice, and messaging from a company URL brand_dna.md
research-keywords Find SEO and GEO keywords using web research, AI analysis, and optional SERP scripts keyword_research.md
reddit-opportunity-research Discover Reddit pain points, subreddits, thread patterns, and user language reddit_opportunities.md
geo-content-research Identify prompts people ask AI engines about a category geo_prompt_targets.md
geo-content-planning Turn research into a page architecture with priority, URLs, and page types content_architecture.md
write-seo-geo-content Draft product-led content optimized for search and AI citation Markdown articles with frontmatter
create-geo-charts Produce data visualizations with text summaries, HTML tables, CSV, and JSON-LD AI-readable chart packages
audit-content Verify URLs, statistics, claims, source attribution, and internal consistency Audit report
build-resource-pages Build resource center pages inside a client codebase Frontend implementation
audit-website-aeo Crawl a live site and score AI discoverability with deterministic and content checks aeo_audit_report.md
improve-aeo-geo Apply code-level AEO/GEO fixes to a website Website code changes
build-backlinks Find free backlink and mention opportunities across communities and directories backlink_plan.md

Sample outputs and examples

Built-in tools

Some skills include scripts for deterministic or higher-volume work:

Tool Location Purpose
AEO crawler audit-website-aeo/scripts/aeo-audit.mjs Zero-dependency Node crawler for 16 foundational AEO checks
Keyword explorer research-keywords/scripts/keyword-explorer.mjs Autocomplete, PAA, related search, and SERP feature discovery
SERP analyzer research-keywords/scripts/serp-analyzer.mjs Competitive SERP analysis and AI Overview opportunity detection

Run the eval suite with:

npm run test:evals

The evals currently cover CSV contract validation and deterministic regressions for the AEO crawler.

Research references

This repo's AEO/GEO guidance is grounded in published research and large-scale industry studies, including:

Platform notes

  • The skills work with both Codex and Claude Code because each skill is packaged as a folder with SKILL.md.
  • Reddit access differs by product. ChatGPT has native Reddit access in-product; Claude generally does not, so outputs may vary by environment.
  • SEO keywords should be short search phrases. GEO prompts should be complete user questions.
  • Do not fabricate data. Every statistic, benchmark, and third-party claim should have a source.

Contributing

See CONTRIBUTING.md for how to add skills, improve workflows, or contribute examples.

When adding or changing a skill, prefer:

  • A clear SKILL.md with trigger conditions and workflow steps.
  • A README that explains usage, outputs, and examples.
  • Schemas for structured CSV/JSON outputs.
  • Offline tests when behavior can be validated deterministically.

License

MIT, see LICENSE.

Star History

Star History Chart

About

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

Topics

Resources

License

Contributing

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors