Table of content
Keyword strategy, on-page optimization, and technical SEO operations
Installation
npx claude-plugins install @gtmagents/gtm-agents/seo
Contents
Folders: agents, commands, skills
Included Skills
This plugin includes 3 skill definitions:
keyword-research
Use when expanding seed topics into intent-based clusters and prioritizing
View skill definition
Keyword Research Systems Skill
When to Use
- Kicking off a new product/vertical SEO plan.
- Validating which clusters justify net-new content.
- Refreshing legacy keyword maps with updated volumes/intent.
Framework
- Seed Intake – capture ICP, problems solved, solution terms.
- Expansion Sources – combine auto-suggest, People Also Ask, competitor URLs, forums.
- Classification – assign funnel stage + intent (informational, commercial, transactional, navigational).
- Scoring – evaluate search volume, keyword difficulty, SERP click potential, seasonality.
- Prioritization – stack rank via ICE/RICE or weighted scoring tied to business impact.
Templates
- Cluster worksheet
Topic → Intent → Page Type → Owner. - SERP teardown table (result type, schema, search feature presence).
- Opportunity score calculator (volume * intent-fit / difficulty).
Tips
- Map 1 pillar page for every 4-6 cluster articles to support internal linking.
- Track query freshness to schedule refresh cadences.
- Align with paid search data to spot immediate conversion opportunities.
on-page
Use when crafting or refreshing pages to align copy, UX, and conversion
View skill definition
On-Page Optimization Checklist
When to Use
- Writing a new page or blog post targeting a specific keyword cluster.
- Refreshing an existing asset to regain rankings.
- QA before publishing to ensure metadata/structure compliance.
Framework
- Search Intent Match – confirm headline + intro address intent quickly.
- Metadata – title <60 chars with primary keyword, compelling meta description, og tags.
- Structure – H1 exact match, H2/H3 covering supporting terms, TOC for long form.
- Copy Enhancements – add stats, quotes, proof points, multimedia blocks.
- Internal/External Links – link to pillar + related clusters; cite credible sources.
- Conversion Hooks – contextual CTAs, sticky bars, lead magnets.
- Accessibility – descriptive alt text, ARIA labels, high contrast.
- Structured Data – FAQ, HowTo, Article schema as relevant.
Templates
- Optimization diff table (Element, Current, Recommended, Rationale).
- CTA matrix aligning funnel stage with offers.
- Internal link planner.
Tips
- Keep paragraph length 2–3 sentences for readability.
- Embed video/audio transcripts for multimedia.
- Track refresh date + metrics to measure impact.
technical-seo
Use when diagnosing crawl/index issues, performance regressions, or structured
View skill definition
Technical SEO Playbooks
When to Use
- Sites experiencing ranking drops despite strong content.
- Launching major site changes (CMS migrations, redesigns).
- Investigating Core Web Vitals, crawl budget, or indexing issues.
Framework
- Crawl Health – Screaming Frog/JetOctopus results, search console coverage, log file sampling.
- Performance – Lighthouse field vs lab data, render-blocking assets, code splitting, image optimization.
- Indexation & Signals – robots.txt, canonicals, hreflang, pagination, parameter handling.
- Structured Data – schema coverage, errors, merchant/product feeds.
- Security & Compliance – HTTPS, mixed content, cookie banners, accessibility.
Playbooks
- Migrations – pre/post launch checklist, redirect maps, monitoring dashboards.
- CWV Improvements – prioritized backlog (LCP, INP, CLS fixes) with eng dependencies.
- International SEO – hreflang matrix, localized sitemaps, translation QA.
- GTM Agents Audit Checklist – five-pass review (crawl → index → performance → schema → reporting) @puerto/README.md#183-212.
- Issue Escalation Flow – Marketing Director ↔ DevOps ↔ Content to fast-track blocking defects.
Templates
- Crawl issue tracker (URL, issue, severity, owner, status).
- Core Web Vitals monitoring dashboard.
- Structured data coverage sheet.
- KPI guardrail sheet (sessions, rankings, conversions) with “alert” thresholds matching GTM Agents governance cadence.
Tips
- Pair log-file a
…(truncated)