repo-geo

# repo-geo

> An Agent Skill that audits and optimizes a code repository for AI/LLM discoverability (GEO): README, llms.txt, docs structure, package metadata, and crawler policy. Read-only audit first, edits only after confirmation.

Runs ~20 checks and branches on repository type — backend-only, full-stack, or frontend. It reports what information is missing rather than emitting a score, and will propose deleting padding (redundant FAQ sections measure as a negative citation signal). Requires Python 3; no other dependencies.

Install with `npx skills add BazingaOrg/repo-geo`, or drop the directory into `~/.claude/skills/` or `~/.codex/skills/`.

## Docs

- [README](https://github.com/BazingaOrg/repo-geo/blob/main/README.md): Install, usage, workflow, check list, and expectation management.
- [SKILL.md](https://github.com/BazingaOrg/repo-geo/blob/main/SKILL.md): The skill instructions themselves — six-phase workflow from type detection to verification.
- [Crawler taxonomy](https://github.com/BazingaOrg/repo-geo/blob/main/references/crawlers.md): The five categories of AI crawler and why a blanket robots.txt block removes a site from AI search entirely.
- [Evidence base](https://github.com/BazingaOrg/repo-geo/blob/main/references/evidence.md): Which GEO practices are supported by measurement, with sources.
- [Hard constraints](https://github.com/BazingaOrg/repo-geo/blob/main/references/dont-do.md): Techniques that look like wins and are not, including cloaking risks.
- [Per-type actions](https://github.com/BazingaOrg/repo-geo/blob/main/references/repo-types.md): What applies to backend-only vs frontend vs full-stack repositories.

## Templates

- [llms.txt template](https://github.com/BazingaOrg/repo-geo/blob/main/templates/llms.txt.tmpl)
- [README skeleton](https://github.com/BazingaOrg/repo-geo/blob/main/templates/README-skeleton.md): How to write a quotable opening definition, with worked examples.
- [robots.txt template](https://github.com/BazingaOrg/repo-geo/blob/main/templates/robots.txt.tmpl): Crawler rules split by category.

## Optional

- [Source article — Tw93](https://tw93.fun/2026-05-01/ai-visibility.html): The methodology this skill is based on.
- [GEO paper, KDD 2024](https://arxiv.org/abs/2311.09735): Authoritative citations +115%, direct quotes +43%, statistics +33%.
- [llms.txt specification](https://llmstxt.org/)