Skip to content

kumaranujranchi/seoskills

Repository files navigation

🚀 SEO & GEO Skill Kit for Vibe Coding

Production-Grade SEO & Generative Engine Optimization (GEO) for AI-Built Websites

This kit is a collection of "Skills" (instructions) and tools designed to transform AI-generated prototypes into production-grade, search-optimized, and AI-visible websites. It implements the latest Generative Engine Optimization (GEO) strategies.

📦 What's Inside?

Component Description
01-architecture.md Rules for Next.js 15, SSG, and <50ms TTFB.
02-technical-seo.md Automation for JSON-LD, Metadata, and Canonical tags.
03-geo-optimization.md Strategies for AI Engine visibility (BLUF, Fact-Blocks).
04-content-strategy.md Information Gain and E-E-A-T mandates.
vibe-seo.js CLI Validator to audit your code for SEO mistakes.
install.sh Setup script for new projects.

🛠️ One-Line Installation

Run the appropriate command in your project root to install the skill kit instantly.

🍎 Mac / 🐧 Linux

curl -s https://raw.githubusercontent.com/kumaranujranchi/seoskills/main/install.sh | bash

🪟 Windows (PowerShell)

iwr https://raw.githubusercontent.com/kumaranujranchi/seoskills/main/install.ps1 | iex

🤖 How to use with AI Agents (Vibe Coding)

When working with an AI coder (like Antigravity, Cursor, or Windsurf), give it this instruction at the start of your session:

"I have installed SEO skills in the .vibe/skills directory. Before you build or modify any page, read those files and ensure the code follows all architectural, technical, and GEO optimization rules defined there."


🔍 Using the CLI Validator

You can manually check if your code follows the SEO rules by running the validator:

Audit a specific file:

./vibe-seo src/app/blog/page.tsx

Audit the entire project:

./vibe-seo .

The tool will check for:

  • Metadata (Titles/Descriptions)
  • H1 Heading presence
  • JSON-LD Structured Data
  • Canonical URLs
  • GEO-friendly content structure (lists/fact-blocks)

💡 Best Practices

  • BLUF (Bottom Line Up Front): Always put the answer to the user's question in the very first paragraph of your content.
  • Entity Density: Mention specific brands, technologies, and locations (e.g., "Patna", "Next.js", "Vercel") to help AI engines categorize your site.
  • SSG First: If it's public content, it must be pre-rendered. Avoid using client-side fetching for SEO-critical text.

Created with ❤️ by Antigravity | Based on Synergy Brand Architect SEO Strategies.

About

A comprehensive SEO & GEO Skill Kit for Vibe Coding. Includes rules for Next.js 15, Generative Engine Optimization (GEO), and a CLI validator.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors