onvoyage-ai/gtm-engineer-skills

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

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

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

Sample outputs and examples

• audit-website-aeo/examples/anthropic-com-audit.md: example scored AEO/GEO audit.
• improve-aeo-geo/examples/nextjs-blog-before-after.md: before/after improvement plan for a Next.js blog.
• improve-aeo-geo/examples/wordpress-business-before-after.md: before/after improvement plan for a WordPress business site.
• create-geo-charts/examples/: sample charts, CSV datasets, and HTML outputs.
• geo-content-planning/plan.csv.schema.md: content plan CSV contract.
• research-keywords/keywords.csv.schema.md: keyword CSV contract.
• geo-content-research/prompts.csv.schema.md: GEO prompt CSV contract.

Built-in tools

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

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:

• GEO paper, KDD 2024: https://arxiv.org/abs/2311.09735
• SE Ranking AI Mode optimization study: https://seranking.com/blog/how-to-optimize-for-ai-mode/
• Growth Memo AI citation analysis: https://www.growth-memo.com/p/the-science-of-how-ai-pays-attention
• Ahrefs freshness and AI citation study: https://ahrefs.com/blog/do-ai-assistants-prefer-to-cite-fresh-content/
• Conductor AEO/GEO benchmarks: https://www.conductor.com/academy/aeo-geo-benchmarks-report/
• AirOps LLM content structure report: https://www.airops.com/report/structuring-content-for-llms

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