Toprank SEO Suite
AI-powered SEO and SEM automation through 6 specialised skills with Google Search Console integration.
When to Use This Skill
- SEO audits: "analyse my SEO", "why is traffic down", "technical SEO audit"
- Content creation: "write blog post about X", "improve this page for SEO"
- Keyword research: "keyword research for [topic]", "content ideas", "search volume"
- Meta tag optimisation: "optimise title tag", "improve CTR", "social preview"
- Schema markup: "add schema markup", "rich snippets", "FAQ schema"
- AI search optimisation: "optimise for AI", "appear in AI answers", "GEO"
When Not to Use
- For Answer Engine Optimisation with no SEO context -- use
bencium-aeo instead; it owns
the GEO/AI-citation technique library (geo-content-optimizer below is a pointer to it, kept
for when GEO work happens inside a toprank SEO engagement)
- For general web research -- use
perplexity-research instead
- For URL content analysis -- use
gemini-url-context instead
- For LinkedIn/social media optimisation -- use
linkedin instead
Sub-Skills
7 nested sub-skills, each with its own SKILL.md, reachable only through this table (they are
intentionally not independently listed in SKILL-DIRECTORY.md or the router's
routing-table — this is the deliberate nested-pack pattern, not an oversight):
| Skill |
Trigger |
What It Does |
seo-analysis |
"SEO audit", "traffic down", "search console" |
Full audit with GSC data, technical crawl, search intent, 30-day action plan |
content-writer |
"write blog post", "improve page" |
E-E-A-T compliant content, blog posts, landing pages |
keyword-research |
"keyword research", "content ideas" |
Keyword discovery, intent classification, topic clusters |
meta-tags-optimizer |
"optimise title", "improve CTR" |
Title/description/OG tags, social preview optimisation |
schema-markup-generator |
"schema markup", "rich snippets" |
JSON-LD structured data for articles, FAQ, products, etc. |
geo-content-optimizer |
"optimise for AI", "AI answers" |
Pointer to bencium-aeo's GEO technique library, framed for SEO-workflow use |
toprank-upgrade |
(internal) |
Suite upgrade/maintenance tooling |
Setup
# Install dependencies
pip install -r requirements.txt (from the toprank skill directory)
# Authenticate with Google Search Console
gcloud auth application-default login
The skill auto-detects your site URL when run inside a website repo.
Environment Variables
| Variable |
Required |
Description |
GOOGLE_APPLICATION_CREDENTIALS |
For GSC |
Path to service account JSON (or use gcloud auth) |
Architecture
┌─────────────────────────────────┐
│ Claude Code / Skill Invocation │
└──────────────┬──────────────────┘
│ Loads sub-skill SKILL.md
▼
┌─────────────────────────────────┐
│ Toprank Sub-Skill │
│ (seo-analysis, content-writer, │
│ keyword-research, etc.) │
└──────────────┬──────────────────┘
│ Python scripts
▼
┌─────────────────────────────────┐
│ Google Search Console API │
│ + Site crawling + Analysis │
└─────────────────────────────────┘
Integration with Other Skills
perplexity-research: Research competitor strategies before keyword planningbencium-aeo: The GEO/AI-citation technique authority (see geo-content-optimizer above,
which now points at it). Use bencium-aeo directly for AI-citation work with no SEO context;
use toprank's geo-content-optimizer pointer when GEO is one step inside a broader SEO
engagement running through this suite.report-builder: Generate comprehensive SEO reports with charts and Wardley mapswardley-maps: Map SEO component evolution and competitive positioning
1---2name: toprank3description: AI-powered SEO/SEM automation suite with 6 specialised skills. Google Search Console integration, content writing (E-E-A-T), keyword research, meta tag optimisation, JSON-LD schema markup, and GEO (Generative Engine Optimisation) for AI citations. Use when doing SEO audits, keyword research, schema markup, or AI search citation optimisation.4---56# Toprank SEO Suite78AI-powered SEO and SEM automation through 6 specialised skills with Google Search Console integration.910## When to Use This Skill1112- **SEO audits**: "analyse my SEO", "why is traffic down", "technical SEO audit"13- **Content creation**: "write blog post about X", "improve this page for SEO"14- **Keyword research**: "keyword research for [topic]", "content ideas", "search volume"15- **Meta tag optimisation**: "optimise title tag", "improve CTR", "social preview"16- **Schema markup**: "add schema markup", "rich snippets", "FAQ schema"17- **AI search optimisation**: "optimise for AI", "appear in AI answers", "GEO"1819## When Not to Use2021- For Answer Engine Optimisation with **no SEO context** -- use `bencium-aeo` instead; it owns22 the GEO/AI-citation technique library (`geo-content-optimizer` below is a pointer to it, kept23 for when GEO work happens inside a toprank SEO engagement)24- For general web research -- use `perplexity-research` instead25- For URL content analysis -- use `gemini-url-context` instead26- For LinkedIn/social media optimisation -- use `linkedin` instead2728## Sub-Skills29307 nested sub-skills, each with its own `SKILL.md`, reachable only through this table (they are31intentionally **not** independently listed in `SKILL-DIRECTORY.md` or the router's32routing-table — this is the deliberate nested-pack pattern, not an oversight):3334| Skill | Trigger | What It Does |35|-------|---------|-------------|36| `seo-analysis` | "SEO audit", "traffic down", "search console" | Full audit with GSC data, technical crawl, search intent, 30-day action plan |37| `content-writer` | "write blog post", "improve page" | E-E-A-T compliant content, blog posts, landing pages |38| `keyword-research` | "keyword research", "content ideas" | Keyword discovery, intent classification, topic clusters |39| `meta-tags-optimizer` | "optimise title", "improve CTR" | Title/description/OG tags, social preview optimisation |40| `schema-markup-generator` | "schema markup", "rich snippets" | JSON-LD structured data for articles, FAQ, products, etc. |41| `geo-content-optimizer` | "optimise for AI", "AI answers" | **Pointer** to `bencium-aeo`'s GEO technique library, framed for SEO-workflow use |42| `toprank-upgrade` | (internal) | Suite upgrade/maintenance tooling |4344## Setup4546```bash47# Install dependencies48pip install -r requirements.txt (from the toprank skill directory)4950# Authenticate with Google Search Console51gcloud auth application-default login52```5354The skill auto-detects your site URL when run inside a website repo.5556## Environment Variables5758| Variable | Required | Description |59|----------|----------|-------------|60| `GOOGLE_APPLICATION_CREDENTIALS` | For GSC | Path to service account JSON (or use `gcloud auth`) |6162## Architecture6364```65┌─────────────────────────────────┐66│ Claude Code / Skill Invocation │67└──────────────┬──────────────────┘68 │ Loads sub-skill SKILL.md69 ▼70┌─────────────────────────────────┐71│ Toprank Sub-Skill │72│ (seo-analysis, content-writer, │73│ keyword-research, etc.) │74└──────────────┬──────────────────┘75 │ Python scripts76 ▼77┌─────────────────────────────────┐78│ Google Search Console API │79│ + Site crawling + Analysis │80└─────────────────────────────────┘81```8283## Integration with Other Skills8485- `perplexity-research`: Research competitor strategies before keyword planning86- `bencium-aeo`: The GEO/AI-citation technique authority (see `geo-content-optimizer` above,87 which now points at it). Use `bencium-aeo` directly for AI-citation work with no SEO context;88 use toprank's `geo-content-optimizer` pointer when GEO is one step inside a broader SEO89 engagement running through this suite.90- `report-builder`: Generate comprehensive SEO reports with charts and Wardley maps91- `wardley-maps`: Map SEO component evolution and competitive positioning
dreamlab-ai