GitHub - ykarateke/seo-agent · GitHub
Skip to content

ykarateke/seo-agent

Repository files navigation

Ykarateke SEO Tools

AI-Powered SEO Audit Commands for Modern Code Editors

A collection of slash commands that bring comprehensive SEO auditing directly into your AI coding assistant. Run /ykarateke-full and get instant, actionable SEO insights without leaving your editor.

Why Ykarateke?

Traditional SEO tools require switching contexts, navigating complex dashboards, and manually interpreting results. Ykarateke brings SEO auditing into your natural coding workflow:

  • Instant Analysis - Run audits directly in your terminal or editor
  • AI-Powered Insights - Get intelligent recommendations, not just checklists
  • Developer-Friendly - Works with HTML, React, Vue, Astro, and any web framework
  • No API Keys Required - Uses your existing AI coding assistant

Quick Install

curl -fsSL https://bearcodestudio.com/install | bash

The installer automatically detects and configures commands for your installed tools.

Supported AI Coding Tools

Tool Status Command Location
Claude Code Supported ~/.claude/commands/
Cursor Supported ~/.cursor/commands/
OpenCode Supported ~/.config/opencode/command/
Codex Supported ~/.codex/prompts/
Antigravity Supported ~/.gemini/antigravity/global_workflows/

Available Commands

Full Audit

Command Description
/ykarateke-full Complete SEO audit combining all 10 tools with weighted scoring

Individual Tools

Command Description
/ykarateke-onpage On-page SEO audit with 25+ checks (title, meta, headings, content)
/ykarateke-technical Technical SEO for crawlability and indexing
/ykarateke-a11y WCAG 2.2 Level AA accessibility compliance audit
/ykarateke-cwv Core Web Vitals analysis (LCP, INP, CLS)
/ykarateke-images Image SEO and optimization audit
/ykarateke-links Internal and external link audit
/ykarateke-meta Meta tags generator and validator (Open Graph, Twitter Cards)
/ykarateke-schema Schema.org structured data validator and generator
/ykarateke-robots Robots.txt generator with AI crawler rules
/ykarateke-llms LLMs.txt generator for AI content discovery

Usage Examples

Run a Full SEO Audit

/ykarateke-full

> What file would you like to audit?
src/pages/index.html

Output:

═══════════════════════════════════════════════════════════════════
YKARATEKE FULL SEO AUDIT
═══════════════════════════════════════════════════════════════════
File: src/pages/index.html
Date: 2025-01-17

╔═══════════════════════════════════════════════════════════════════╗
║                    OVERALL SEO SCORE: 78/100                      ║
╚═══════════════════════════════════════════════════════════════════╝

CATEGORY SCORES
───────────────────────────────────────────────────────────────────
On-Page SEO ............ 85/100  ████████░░  (2 issues)
Technical SEO .......... 90/100  █████████░  (1 issue)
Accessibility .......... 65/100  ██████░░░░  (5 issues)
...

Check Core Web Vitals

/ykarateke-cwv

> What file would you like to analyze?
src/components/Hero.tsx

Generate Schema Markup

/ykarateke-schema

> What type of page is this?
Product page for an e-commerce site

Scoring System

The full audit uses weighted scoring across 10 categories:

Category Weight Focus Areas
On-Page SEO 20% Title, meta, headings, content, URL structure
Technical SEO 15% Canonical, robots, mobile, HTTPS
Accessibility 15% WCAG 2.2 Level AA compliance
Core Web Vitals 15% LCP, INP, CLS performance metrics
Image SEO 10% Alt text, formats, lazy loading, dimensions
Link Health 10% Internal/external links, anchor text
Meta Tags 5% Open Graph, Twitter Cards
Schema Markup 5% Structured data validation
Robots.txt 3% Crawl directives
LLMs.txt 2% AI discoverability

What Each Tool Checks

On-Page SEO (/ykarateke-onpage)

  • Title tag optimization (50-60 characters, keyword placement)
  • Meta description quality (120-160 characters, CTA)
  • Heading hierarchy (single H1, proper H2-H6 structure)
  • Content analysis (word count, keyword density 1-2%)
  • URL structure (hyphens, lowercase, keywords)
  • Internal linking quality

Technical SEO (/ykarateke-technical)

  • Canonical tag configuration
  • Robots meta directives
  • Mobile viewport setup
  • HTTPS implementation
  • Redirect chain detection

Accessibility (/ykarateke-a11y)

  • Image alt text (meaningful descriptions)
  • Color contrast ratios (4.5:1 for normal text)
  • Keyboard navigation support
  • ARIA attribute usage
  • Form label associations
  • Focus management

Core Web Vitals (/ykarateke-cwv)

  • LCP (< 2.5s): Image preloading, render-blocking resources
  • INP (< 200ms): JavaScript execution, event handlers
  • CLS (< 0.1): Image dimensions, dynamic content, fonts

Image SEO (/ykarateke-images)

  • Alt text presence and quality
  • Modern format usage (WebP/AVIF)
  • Lazy loading implementation
  • Width/height attributes for CLS prevention
  • Descriptive file names

Link Audit (/ykarateke-links)

  • Internal link distribution
  • Anchor text diversity
  • External link attributes (rel, target)
  • Broken link detection
  • Orphan page identification

Meta Tags (/ykarateke-meta)

  • Open Graph tags for social sharing
  • Twitter Card configuration
  • Canonical URL validation

Schema Markup (/ykarateke-schema)

  • Existing schema validation
  • Schema type recommendations
  • JSON-LD generation

Robots.txt (/ykarateke-robots)

  • Crawl directive configuration
  • AI crawler rules (GPTBot, Claude-Web, etc.)
  • Sitemap references

LLMs.txt (/ykarateke-llms)

  • Following llmstxt.org specification
  • Summary version for token efficiency
  • Comprehensive version for thorough understanding

Manual Installation

If you prefer manual installation:

  1. Download the command files from this repository
  2. Copy to the appropriate directory for your tool:
# Claude Code
cp ykarateke-*.md ~/.claude/commands/

# Cursor
cp ykarateke-*.md ~/.cursor/commands/

# OpenCode
cp ykarateke-*.md ~/.config/opencode/command/

# Codex
cp ykarateke-*.md ~/.codex/prompts/

# Antigravity
cp ykarateke-*.md ~/.gemini/antigravity/global_workflows/

Contributing

Contributions are welcome! Each command file follows this structure:

---
name: ykarateke-<tool>
description: Brief description
---

# Tool Title

Instructions for the AI including:
- What to ask the user
- Checks to perform
- Output format template

License

MIT License - See LICENSE for details.

Links


Built with care by Bear Code Studio

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

Contributors

Languages