---

name: toprank description: > 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. version: 1.0.0 author: nowork-studio tags:

• seo
• sem
• google-search-console
• content
• keywords
• schema-markup
• geo env_vars:
• GOOGLE_APPLICATION_CREDENTIALS

---

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 planning
• bencium-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 maps
• wardley-maps: Map SEO component evolution and competitive positioning