Supercharge Your SEO Directly in Claude Code & Antigravity: Introducing trends-skill

Traditional SEO workflows are notoriously fragmented. First, you open Google Trends, Ahrefs, or SEMrush to research live search demand. Then, you compile keyword spreadsheets. Finally, you jump over to your IDE to manually rewrite <title> tags, update meta descriptions, structure headers, and hand-craft JSON-LD schema blocks.

What if your AI coding agent could handle the entire pipeline natively inside your terminal or workspace—extracting real-time Google search trends and refactoring your website code to rank #1 on Google automatically?

That is why I created trends-skill: an open-source Agentic AI Skill for Claude Code, Google Antigravity, and Gemini that connects live search data directly with your local codebase.

🚀 What is trends-skill?

trends-skill is a standardized Agent Skill (built on the SKILL.md open specification) that turns your AI assistant into a full-stack SEO engineering agent. Instead of giving generic advice, it executes real-time extraction scripts, performs a comprehensive codebase audit, and writes actionable HTML, JS, and JSON-LD refactors.

✨ Key Features & Capabilities

• 📊 Dual-Engine Search Extraction: Blends live Google Trends RSS feeds (via a bundled Python script) with real-time web search discovery to capture head queries, breakout search terms (+100% to +500%), and regional search volume.
• 🎯 Intent-Driven Keyword Clustering: Categorizes keywords automatically into Informational, Commercial, Navigational, and Transactional search intent buckets.
• 🛠️ Full-Stack Technical SEO Audit: Evaluates HTML <title> tags, meta descriptions, lang attributes, Open Graph, Twitter Cards, canonical links, header hierarchy (H1–H6), and crawlability.
• 💡 Rich Snippet & Schema Engineering: Injects production-grade JSON-LD structured data (FAQPage, WebSite, Organization, Product, Service, BreadcrumbList) to capture Google Featured Snippets.
• 🚀 Automated Codebase Execution: Formulates a structured trends_optimization_plan.md artifact and applies high-impact HTML/JS edits directly across your target repository upon approval.

🔄 How the Agentic Workflow Works

When triggered inside Claude Code or Google Antigravity, the agent executes a structured 5-stage pipeline:

1. Parameter Intake & Scoping: Accepts your target field/industry (e.g., real estate, mortgage calculator, SaaS) and ISO country code (e.g., NL, US, DE, GB).
2. Google Trends Data Extraction: Runs the Python extractor fetch_trends.py combined with live search discovery to identify rising breakout terms and regional volume.
3. Local Codebase Audit: Scans your HTML pages, router configurations, and metadata assets for missing keywords, broken header structures, or absent schema markup.
4. Optimization Strategy & Schema Engineering: Formulates high-CTR title/meta copy and generates machine-readable JSON-LD rich snippets.
5. Plan Artifact & Code Refactoring: Outputs an actionable plan artifact and edits your codebase files upon confirmation.

⚡ Quick Start & Installation

Installing trends-skill takes less than a minute. Simply clone the repository into your AI assistant's skills directory:

For Claude Code

mkdir -p ~/.claude/skills/trends
git clone https://github.com/DKalachniuk/trends-skill.git ~/.claude/skills/trends

For Google Antigravity & Gemini Agent

mkdir -p ~/.gemini/config/skills/trends
git clone https://github.com/DKalachniuk/trends-skill.git ~/.gemini/config/skills/trends

💡 Triggering the Skill in Prompt

Once installed, trigger the skill in your AI terminal or workspace with a single command:

/trends "real estate" NL

(You can specify any field or niche along with a 2-letter country code such as US, GB, DE, FR, BE).

🐍 Standalone Python CLI Tool

You can also use the bundled Python extractor directly in your terminal to inspect search demand for any query and region:

python3 scripts/fetch_trends.py "mortgage calculator" "NL"

Output Example:

{
  "field": "mortgage calculator",
  "geo": "NL",
  "total_trends_found": 15,
  "trends": [
    {
      "title": "Hypotheek berekenen 2026",
      "approx_traffic": "50,000+",
      "news_headlines": [...]
    }
  ]
}

Summary

By bringing live Google Trends demand data directly into developer AI environments like Claude Code and Google Antigravity, trends-skill closes the gap between SEO strategy and technical implementation. Give your website a competitive search advantage today!