Copilot instructions

1# Ultimate SEO + GEO — Copilot Instructions
2 
3This repository is a comprehensive SEO and Generative Engine Optimization (GEO) skill with
435 diagnostic Python scripts, scored audit frameworks, and AI search citation optimization.
5 
6## How to Use
7 
8All instructions are in `AGENTS.md` (compact, auto-loaded), `SKILL.md` (routing shell + guardrails), and `references/procedures/*.md` (step-by-step procedures by section).
9GitHub Copilot reads `AGENTS.md` automatically. For full procedures, read the matching file under `references/procedures/` (see `references/procedures/README.md`).
10 
11## Key Capabilities
12 
13- **Mode 1 — Audit**: Fetch a site, run all checks, produce a scored SEO Health Score report
14- **Mode 2 — Plan**: Convert findings into a phased, prioritized roadmap
15- **Mode 3 — Execute**: Produce the actual fixes (meta tags, schema, redirect maps) + verify
16 
17## Quick Start
18 
19```bash
20pip install -r requirements.txt
21python scripts/generate_report.py https://example.com --output report.html
22```
23 
24## Reference Files
25 
26Domain knowledge is in `references/` (23 markdown files). Load only what you need per task.
27See the Routing Index in `AGENTS.md` § 0 for the task-to-file mapping.
28 
29## Important Rules
30 
31- Every audit finding must have: Finding / Evidence / Impact / Fix / Confidence
32- Never fabricate metrics — only report data from scripts that actually ran
33- High-risk changes (robots.txt, redirects, noindex) require user confirmation before output
34- For competitor sites, label all output "External Observation Only"
35