# KeySkills — Full LLM Reference & Context > The essential portable skill suite for high-agency AI agents: SEO setup, anti-slop frontend design, git hygiene, and codebase cleanup. KeySkills provides open-source, portable skill files that stop AI coding agents—including Cursor, Claude Code, Codex, Antigravity, Gemini CLI, Windsurf, OpenCode, GitHub Copilot, and v0—from shipping generic UIs, unindexed pages, sloppy commits, and bloated repos. One command installs all four skills across any package manager (`bunx`, `npx`, `pnpm dlx`, `yarn dlx`). Website: https://keyskills.ngxlabs.tech Repository: https://github.com/NaveenGumaste/keyskills Author: Naveen Gumaste (https://github.com/NaveenGumaste) License: MIT --- ## 1. Quick Install & CLI Reference ### One-Command Installs ```bash # Bun bunx skills add NaveenGumaste/keyskills --all -y # npm / Node npx skills add NaveenGumaste/keyskills --all -y # pnpm pnpm dlx skills add NaveenGumaste/keyskills --all -y # Yarn yarn dlx skills add NaveenGumaste/keyskills --all -y ``` ### CLI Flag Reference | Flag | Description | |---|---| | `--list` | List available skills without installing anything | | `--skill ` | Install one specific skill (repeatable per skill) | | `--all` | Install all four skills at once | | `-a ` | Target a specific coding agent (repeatable per agent) | | `-y` | Non-interactive mode (skips prompts, required for CI & automated environments) | ### Non-Interactive Recipes ```bash # Inspect available skills npx skills add NaveenGumaste/keyskills --list # Install only SEO setup non-interactively npx skills add NaveenGumaste/keyskills --skill seo-setup -y # Target Claude Code and Cursor specifically npx skills add NaveenGumaste/keyskills --skill seo-setup --skill design-skill -a claude-code -a cursor -y # Install all skills for Antigravity & Gemini CLI bunx skills add NaveenGumaste/keyskills --all -a antigravity -a gemini-cli -y ``` --- ## 2. Supported Agents Matrix KeySkills works natively with all agentic coding environments by depositing standard `SKILL.md` instruction files in the agent's recognized skill directories: - **Claude Code**: Anthropic CLI agent (`-a claude-code`) - **Cursor**: AI-native IDE (`-a cursor`) - **Codex**: OpenAI coding agent (`-a codex`) - **Gemini CLI**: Google Gemini terminal agent (`-a gemini-cli`) - **Antigravity**: Google DeepMind agentic IDE surface (`-a antigravity`) - **OpenCode**: Open-source terminal agent (`-a opencode`) - **GitHub Copilot**: Pair programmer (`-a copilot`) - **Windsurf**: Agentic IDE by Codeium (`-a windsurf`) - **v0**: Vercel generative UI (`-a v0`) --- ## 3. Core Skills In-Depth ### Skill 1: `seo-setup` - **Purpose**: Inspect any site or codebase and implement comprehensive technical SEO (metadata, sitemap, robots, canonical, Open Graph, Twitter cards, JSON-LD, crawlability). - **Triggers**: `metadata`, `sitemap`, `robots`, `open graph`, `og`, `json-ld`, `schema`, `seo`. - **Core Rules**: 1. **Identity**: Unique title template and meta description per route. 2. **Framework Metadata**: Next.js App Router root `layout.tsx` metadata API (`openGraph`, `twitter`, `metadataBase`, `alternates.canonical`), never ad-hoc `` tags. 3. **Canonical**: Absolute URLs, consistent trailing-slash policy, no duplicate home URLs. 4. **Open Graph & Twitter**: PNG/JPEG raster images (1200×630 or ~1.91:1 ratio, min 1024px width), never SVGs for social cards. 5. **Robots**: Allow public routes, disallow internal/api paths, declare sitemap URL. 6. **Sitemap**: Canonical indexable routes with image discovery metadata. 7. **JSON-LD**: Valid Schema.org types for actual entities (`SoftwareApplication`, `WebSite`, `Organization`). 8. **Technical**: Proper `lang` attribute, meaningful headings, no text trapped in canvas, web app manifest. ### Skill 2: `design-skill` - **Purpose**: Anti-slop frontend framework for landing pages, portfolios, and web applications. Replaces generic AI templates with intentional aesthetic reads, calibrated dials, and cohesive design systems. - **Triggers**: `landing page`, `redesign`, `anti-slop`, `design system`, `frontend design`. - **Core Rules**: 1. **Brief Inference**: Read page kind, audience, vibe words, and brand assets before writing CSS. 2. **The Three Dials**: Calibrate `DESIGN_VARIANCE` (1–10), `MOTION_INTENSITY` (1–10), and `VISUAL_DENSITY` (1–10). 3. **Anti-Default Discipline**: No default purple glowing gradients, centered-hero-over-mesh, generic glassmorphism on everything, or Inter-on-slate defaults. 4. **One System Per Project**: Use official design system packages (e.g. Radix, Fluent, Tailwind v4) or honest aesthetic approximations. Never mix design families. 5. **Hero & Viewport Discipline**: `min-h-[100dvh]` over `h-screen`, hero fits within initial viewport, max 2 lines for headline, max 20 words for subtext. 6. **Layout Variety**: No repeated section layout families. Cap bento grids to actual content cells. ### Skill 3: `git-skill` - **Purpose**: Enforce Git hygiene, branch discipline, conventional commit formatting, and secrets prevention. - **Triggers**: `commit`, `branch`, `pull request`, `git hygiene`, `git mess`, `PR`. - **Core Rules**: 1. **Conventional Commits**: Every commit follows `type(scope): subject` (`feat:`, `fix:`, `docs:`, `chore:`, `refactor:`). 2. **Branch Discipline**: Short-lived branches named `type/topic` (e.g. `feat/seo-setup`). Never push directly to main without review. 3. **Zero Secrets Leaks**: Scan staged diffs for private keys, API tokens, `.env` files, and credentials before every commit. 4. **Clean `.gitignore`**: Exclude `node_modules`, `.next`, build artifacts, `.DS_Store`, and environment files. ### Skill 4: `codebase-cleanup` - **Purpose**: Inspect codebases and eliminate dead weight while preserving behavior. - **Triggers**: `dead code`, `unused deps`, `cleanup`, `declutter`, `production ready`. - **Core Rules**: 1. **Purge the Zombies**: Remove unused dependencies, unreachable exports, and orphaned files. 2. **Silence the Noise**: Remove stray `console.log` statements, commented-out dead code blocks, and obsolete TODOs. 3. **Verify the Cut**: Run full TypeScript typecheck (`tsc --noEmit`) and linter (`eslint`) after every cleanup pass. --- ## 4. API & Integration Summary - **Static LLM Metadata**: `/llms.txt` (summary) and `/llms-full.txt` (full context) - **Sitemap**: `/sitemap.xml` - **Robots**: `/robots.txt` - **Manifest**: `/manifest.webmanifest` - **OpenGraph & Social Assets**: `/banner.png` (1024×469), `/mascot.png` (1371×1148), `/icon.png` (512×512)