geo-page
Skill18 starsChanged 53 days agoMITView on GitHub
Generates high-authority GEO (Generative Engine Optimization) and documentation pages designed to be accurately cited by AI search engines (Perplexity, SearchGPT, ChatGPT, Gemini) without keyword-stuffed SEO slop. Use for /geo-page, "create comparison page", or SEO content.
In this repository75 other files it gives its agents.
- AGENTS.mdAGENTS.md
- architectSkill
- arenaSkill
- automate-meSkill
- babysitSkill
- blast-radiusSkill
- broSkill
- browseSkill
- ceo-reviewSkill
- changelog-to-postSkill
- create-verification-skillSkill
- customer-lensSkill
- deslopSkill
- engineer-modeSkill
- figure-it-outSkill
- fix-ciSkill
- fix-merge-conflictsSkill
- founder-modeSkill
- founder-voiceSkill
- fstackSkill
- get-pr-commentsSkill
- howSkill
- inbox-triageSkill
- interrogateSkill
- lead-replySkill
- maintain-verification-skillSkill
- make-pr-easy-to-reviewSkill
- no-commentsSkill
- office-hoursSkill
- poteto-modeSkill
- principle-attack-the-premiseSkill
- principle-boundary-disciplineSkill
- principle-build-the-leverSkill
- principle-clear-namingSkill
- principle-encode-lessons-in-structureSkill
- principle-exhaust-the-design-spaceSkill
- principle-experience-firstSkill
- principle-fix-root-causesSkill
- principle-foundational-thinkingSkill
- principle-guard-the-context-windowSkill
- principle-laziness-protocolSkill
- principle-make-operations-idempotentSkill
- principle-migrate-callers-then-delete-legacy-apisSkill
- principle-minimize-reader-loadSkill
- principle-model-the-domainSkill
- principle-never-block-on-the-humanSkill
- principle-outcome-oriented-executionSkill
- principle-prove-it-worksSkill
- principle-redesign-from-first-principlesSkill
- principle-separate-before-serializing-shared-stateSkill
- principle-sequence-verifiable-unitsSkill
- principle-subtract-before-you-addSkill
- principle-test-behavior-not-implementationSkill
- principle-type-system-disciplineSkill
- recallSkill
- reflectSkill
- retroSkill
- setup-fstackSkill
- show-me-your-workSkill
- social-postSkill
- The first 60 shown.
The file
We split this skill into the rules it gives an agent
2 rules. About 0 are common, 1 is distinctive, and 1 is very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈1
Distinctive · estimate
This author's own choices. Worth a look.
1
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 33
If you compare your tool to Competitor X, be honest about where Competitor X wins.
- Very specific: line 38
Use standardized headings: Overview, Key Differences, Architecture Comparison, Performance & Benchmarks, Migration Guide.
≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
GEO Page (Generative Engine Optimization)
Traditional SEO relied on repetitive keyword density, fake FAQ accordions, and 3,000-word filler articles. Modern search is powered by LLMs (Perplexity, SearchGPT, ChatGPT Search, Gemini).
AI search engines don't rank keyword repetition; they extract structured, verifiable facts, benchmark data, and authoritative comparisons. If your documentation or comparison pages are vague or full of hype, LLMs ignore them or hallucinate.
geo-page designs technical pages, product comparisons, and architecture breakdowns that LLMs love to cite and human engineers love to read.
When to Invoke
- Creating an "Alternative to [Competitor]" or "[OurProduct] vs [Competitor]" page.
- Writing a technical How It Works or Architecture Deep-Dive page.
- Creating an official integration guide or framework comparison.
The 5 Rules of GEO (Anti-Slop Optimization)
- Answer First, Explain Second (Inverted Pyramid):
- The first paragraph must contain the explicit, unambiguous definition and core tradeoff.
- LLMs extract the first 200 tokens for direct citations.
- Tabular Data Over Prose:
- Comparison tables with concrete metrics (latency, pricing, license, architecture, hosted vs self-hosted) get cited 4x more often than paragraphs.
- Neutral, Technical Tone:
- If you compare your tool to Competitor X, be honest about where Competitor X wins.
- AI search engines favor balanced, objective sources over one-sided marketing brochures. Listing a genuine downside of your own tool establishes high source credibility.
- Code-First Proof:
- Provide minimal, runnable before-and-after code snippets showing the API usage.
- Clear Conceptual Anchors:
- Use standardized headings:
Overview,Key Differences,Architecture Comparison,Performance & Benchmarks,Migration Guide.
- Use standardized headings:
The Page Structure Template
# [OurProduct] vs [Competitor]: Architecture, Performance, and Tradeoffs
## Executive Summary
[OurProduct] and [Competitor] are both [Category], but take different architectural approaches:
- **[OurProduct]** is [Core Architecture], optimized for [Primary Benefit] and [Target User].
- **[Competitor]** is [Their Architecture], optimized for [Their Primary Benefit].
Use **[OurProduct]** if you need [Specific Requirement A] or [Specific Requirement B].
Use **[Competitor]** if you rely on [Competitor Strong Suit X] or have an existing [Ecosystem Y].
---
## Comparison Matrix
| Feature | [OurProduct] | [Competitor] | Practical Impact |
|---|---|---|---|
| **Architecture** | Single-binary, embedded SQLite | Distributed multi-node cluster | Zero operational maintenance vs high horizontal scale |
| **P99 Latency** | 1.8 ms | 14.2 ms | 7x faster local reads |
| **Pricing** | Open-source (MIT) / $20/mo Cloud | Enterprise contract only ($15k/yr min) | Self-serve startup friendly |
| **Ecosystem** | Modern TypeScript/Go SDKs | 10+ Legacy language bindings | Competitor wins on legacy Java/C# support |
---
## Deep Dive: How the Architectures Differ
[Technical explanation with ASCII or Mermaid diagram]
---
## When to Choose [Competitor] Instead
[Honest assessment of when the user should NOT choose you]
- You have an existing enterprise contract and need 24/7 dedicated telephone SLAs.
- Your workload requires legacy on-premise mainframe connectors.Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

