diff --git a/README.md b/README.md
index 417117a1..08e1c521 100644
--- a/README.md
+++ b/README.md
@@ -1,24 +1,28 @@
 <!-- registry-sync: version=8.3.0; skills=1273; stars=25526; updated_at=2026-03-19T00:00:00+00:00 -->
-# 🌌 Antigravity Awesome Skills: 1,273+ Agentic Skills for Claude Code, Gemini CLI, Cursor, Copilot & More
+# 🌌 Antigravity Awesome Skills: 1,273+ Agentic Skills for Claude Code, Cursor, Codex CLI & Gemini CLI
 
-> **The Ultimate Collection of 1,273+ Universal Agentic Skills for AI Coding Assistants — Claude Code, Gemini CLI, Codex CLI, Antigravity IDE, GitHub Copilot, Cursor, OpenCode, AdaL**
+> **Installable GitHub library of 1,273+ agentic skills for Claude Code, Cursor, Codex CLI, Gemini CLI, Antigravity, and other AI coding assistants.**
+
+Antigravity Awesome Skills is a GitHub repository and installer CLI for reusable `SKILL.md` playbooks. Instead of collecting random prompts, you get a searchable, installable skill library for planning, coding, debugging, testing, security review, infrastructure work, product workflows, and growth tasks across the major AI coding assistants.
+
+**Start here:** [Star the repo](https://github.com/sickn33/antigravity-awesome-skills/stargazers) · [Install in 1 minute](#installation) · [Choose your tool](#choose-your-tool) · [Best skills by tool](#best-skills-by-tool) · [Bundles](docs/users/bundles.md) · [Workflows](docs/users/workflows.md)
 
 [![GitHub stars](https://img.shields.io/badge/⭐%2024%2C000%2B%20Stars-gold?style=for-the-badge)](https://github.com/sickn33/antigravity-awesome-skills/stargazers)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
 [![Claude Code](https://img.shields.io/badge/Claude%20Code-Anthropic-purple)](https://claude.ai)
-[![Gemini CLI](https://img.shields.io/badge/Gemini%20CLI-Google-blue)](https://github.com/google-gemini/gemini-cli)
-[![Codex CLI](https://img.shields.io/badge/Codex%20CLI-OpenAI-green)](https://github.com/openai/codex)
-[![Kiro](https://img.shields.io/badge/Kiro-AWS-orange)](https://kiro.dev)
 [![Cursor](https://img.shields.io/badge/Cursor-AI%20IDE-orange)](https://cursor.sh)
-[![Copilot](https://img.shields.io/badge/GitHub%20Copilot-VSCode-lightblue)](https://github.com/features/copilot)
-[![OpenCode](https://img.shields.io/badge/OpenCode-CLI-gray)](https://github.com/opencode-ai/opencode)
-[![Antigravity](https://img.shields.io/badge/Antigravity-DeepMind-red)](https://github.com/sickn33/antigravity-awesome-skills)
-[![AdaL CLI](https://img.shields.io/badge/AdaL%20CLI-SylphAI-pink)](https://sylph.ai/)
-[![ASK Supported](https://img.shields.io/badge/ASK-Supported-blue)](https://github.com/yeasy/ask)
-[![Web App](https://img.shields.io/badge/Web%20App-Browse%20Skills-blue)](apps/web-app)
-[![Buy Me a Book](https://img.shields.io/badge/Buy%20me%20a-book-d13610?logo=buymeacoffee&logoColor=white)](https://buymeacoffee.com/sickn33)
+[![Codex CLI](https://img.shields.io/badge/Codex%20CLI-OpenAI-green)](https://github.com/openai/codex)
+[![Gemini CLI](https://img.shields.io/badge/Gemini%20CLI-Google-blue)](https://github.com/google-gemini/gemini-cli)
 
-**Current release: V8.3.0.** This repository gives your agent reusable playbooks for planning, coding, debugging, testing, security review, infrastructure work, product thinking, and much more.
+**Current release: V8.3.0.** Trusted by 25k+ GitHub stargazers, this repository combines official and community skill collections with bundles, workflows, installation paths, and docs that help you go from first install to daily use quickly.
+
+## Why Developers Star This Repo
+
+- **Installable, not just inspirational**: use `npx antigravity-awesome-skills` to put skills where your tool expects them.
+- **Built for major agent workflows**: Claude Code, Cursor, Codex CLI, Gemini CLI, Antigravity, Kiro, OpenCode, Copilot, and more.
+- **Broad coverage with real utility**: 1,273+ skills across development, testing, security, infrastructure, product, and marketing.
+- **Faster onboarding**: bundles and workflows reduce the time from "I found this repo" to "I used my first skill".
+- **Useful whether you want breadth or curation**: browse the full catalog, start with top bundles, or compare alternatives before installing.
 
 ## Table of Contents
 
@@ -26,10 +30,12 @@
 - [📖 Complete Usage Guide](docs/users/usage.md) - **Start here if confused after installation!**
 - [🔌 Compatibility &amp; Invocation](#compatibility--invocation)
 - [🛠️ Installation](#installation)
+- [🧰 Best Skills By Tool](#best-skills-by-tool)
 - [🛡️ Security Posture](#security-posture)
 - [🧯 Troubleshooting](#troubleshooting)
 - [🎁 Curated Collections (Bundles)](#curated-collections)
 - [🧭 Antigravity Workflows](#antigravity-workflows)
+- [⚖️ Alternatives &amp; Comparisons](#alternatives--comparisons)
 - [📦 Features & Categories](#features--categories)
 - [📚 Browse 1,273+ Skills](#browse-1273-skills)
 - [🤝 Contributing](#contributing)
@@ -44,14 +50,13 @@
 
 ## New Here? Start Here!
 
-**Welcome to the current interactive web edition.** This isn't just a list of scripts; it's a complete operating system for your AI agent.
+If you searched for **Claude Code skills**, **Cursor skills**, **Codex CLI skills**, **Gemini CLI skills**, or **AI agent skills on GitHub**, this is the fastest path to installing a serious working library and using it the same day.
 
 ### 1. 🐣 Context: What is this?
 
-**Antigravity Awesome Skills** (Release 8.3.0) includes the latest maintainer sweep after `8.2.0`, including new onboarding assets, activation hardening, and the `landing-page-generator` and `MAXIA` marketplace-related updates.
+**Antigravity Awesome Skills** (Release 8.3.0) is a large, installable skill library for AI coding assistants. It includes onboarding docs, bundles, workflows, generated catalogs, and a CLI installer so you can move from discovery to actual usage without manually stitching together dozens of repos.
 
-AI Agents (like Claude Code, Cursor, or Gemini) are smart, but they lack **specific tools**. They don't know your company's "Deployment Protocol" or the specific syntax for "AWS CloudFormation".
-**Skills** are small markdown files that teach them how to do these specific tasks perfectly, every time.
+AI agents are smart, but they still need **task-specific operating instructions**. Skills are focused markdown playbooks that teach an agent how to perform a workflow repeatedly and with better context, whether that means deployment, API design, testing, product strategy, SEO, or documentation.
 
 ### 2. ⚡️ Quick Start (1 minute)
 
@@ -166,6 +171,16 @@ This installs the same repository-backed skill library through Claude Code's plu
 | AdaL CLI       | `npx antigravity-awesome-skills --path .adal/skills`                   | `Use brainstorming to plan a feature`                |
 | Custom path    | `npx antigravity-awesome-skills --path ./my-skills`                    | Depends on your tool                                   |
 
+## Best Skills By Tool
+
+If you want a faster answer than "browse all 1,273+ skills", start with a tool-specific guide:
+
+- **[Claude Code skills](docs/users/claude-code-skills.md)**: install paths, starter skills, prompt examples, and plugin marketplace flow.
+- **[Cursor skills](docs/users/cursor-skills.md)**: best starter skills for `.cursor/skills/`, UI-heavy work, and pair-programming flows.
+- **[Codex CLI skills](docs/users/codex-cli-skills.md)**: planning, implementation, debugging, and review skills for local coding loops.
+- **[Gemini CLI skills](docs/users/gemini-cli-skills.md)**: starter stack for research, agent systems, integrations, and engineering workflows.
+- **[AI agent skills guide](docs/users/ai-agent-skills.md)**: how to evaluate skill libraries, choose breadth vs curation, and pick the right starting point.
+
 ## Security Posture
 
 These skills are continuously reviewed and hardened, but the collection is not "safe by default". They are instructions and examples that can include risky operations by design.
@@ -283,6 +298,14 @@ Initial workflows include:
 - QA and Browser Automation (with optional `@go-playwright` support for Go stacks)
 - Design a DDD Core Domain
 
+## Alternatives & Comparisons
+
+Need to compare this repository with other skill libraries before you install? Start here:
+
+- **[Antigravity Awesome Skills vs Awesome Claude Skills](docs/users/antigravity-awesome-skills-vs-awesome-claude-skills.md)** for breadth vs curated-list tradeoffs.
+- **[Best Claude Code skills on GitHub](docs/users/best-claude-code-skills-github.md)** for a high-intent shortlist.
+- **[Best Cursor skills on GitHub](docs/users/best-cursor-skills-github.md)** for Cursor-compatible options and selection criteria.
+
 ## Features & Categories
 
 The repository is organized into specialized domains to transform your AI into an expert across the entire software development lifecycle:
@@ -305,6 +328,7 @@ Counts change as new skills are added. For the current full registry, see [CATAL
 
 - Open the interactive browser in [`apps/web-app`](apps/web-app).
 - Read the full catalog in [`CATALOG.md`](CATALOG.md).
+- Start with tool-specific guides in [`docs/users/claude-code-skills.md`](docs/users/claude-code-skills.md), [`docs/users/cursor-skills.md`](docs/users/cursor-skills.md), [`docs/users/codex-cli-skills.md`](docs/users/codex-cli-skills.md), and [`docs/users/gemini-cli-skills.md`](docs/users/gemini-cli-skills.md).
 - Start with role-based bundles in [`docs/users/bundles.md`](docs/users/bundles.md).
 - Follow outcome-driven workflows in [`docs/users/workflows.md`](docs/users/workflows.md).
 - Use the onboarding guides in [`docs/users/getting-started.md`](docs/users/getting-started.md) and [`docs/users/usage.md`](docs/users/usage.md).
@@ -316,7 +340,8 @@ Counts change as new skills are added. For the current full registry, see [CATAL
 | [`docs/users/getting-started.md`](docs/users/getting-started.md) | [`CONTRIBUTING.md`](CONTRIBUTING.md)                                       | [`docs/maintainers/release-process.md`](docs/maintainers/release-process.md)                                                              |
 | [`docs/users/usage.md`](docs/users/usage.md)                     | [`docs/contributors/skill-anatomy.md`](docs/contributors/skill-anatomy.md) | [`docs/maintainers/audit.md`](docs/maintainers/audit.md)                                                                                  |
 | [`docs/users/faq.md`](docs/users/faq.md)                         | [`docs/contributors/quality-bar.md`](docs/contributors/quality-bar.md)     | [`docs/maintainers/ci-drift-fix.md`](docs/maintainers/ci-drift-fix.md)                                                                    |
-| [`docs/users/visual-guide.md`](docs/users/visual-guide.md)       | [`docs/contributors/examples.md`](docs/contributors/examples.md)           | [`docs/maintainers/skills-update-guide.md`](docs/maintainers/skills-update-guide.md) · [`.github/MAINTENANCE.md`](.github/MAINTENANCE.md) |
+| [`docs/users/claude-code-skills.md`](docs/users/claude-code-skills.md) · [`docs/users/cursor-skills.md`](docs/users/cursor-skills.md) · [`docs/users/codex-cli-skills.md`](docs/users/codex-cli-skills.md) · [`docs/users/gemini-cli-skills.md`](docs/users/gemini-cli-skills.md) | [`docs/contributors/examples.md`](docs/contributors/examples.md)           | [`docs/maintainers/repo-growth-seo.md`](docs/maintainers/repo-growth-seo.md) · [`docs/maintainers/skills-update-guide.md`](docs/maintainers/skills-update-guide.md) · [`.github/MAINTENANCE.md`](.github/MAINTENANCE.md) |
+| [`docs/users/visual-guide.md`](docs/users/visual-guide.md) · [`docs/users/ai-agent-skills.md`](docs/users/ai-agent-skills.md) · [`docs/users/best-claude-code-skills-github.md`](docs/users/best-claude-code-skills-github.md) · [`docs/users/best-cursor-skills-github.md`](docs/users/best-cursor-skills-github.md) |  |  |
 
 ## Troubleshooting
 
diff --git a/docs/README.md b/docs/README.md
index 1f19bfa9..97c0b7e8 100644
--- a/docs/README.md
+++ b/docs/README.md
@@ -5,6 +5,14 @@
 - [`users/getting-started.md`](users/getting-started.md)
 - [`users/usage.md`](users/usage.md)
 - [`users/faq.md`](users/faq.md)
+- [`users/claude-code-skills.md`](users/claude-code-skills.md)
+- [`users/cursor-skills.md`](users/cursor-skills.md)
+- [`users/codex-cli-skills.md`](users/codex-cli-skills.md)
+- [`users/gemini-cli-skills.md`](users/gemini-cli-skills.md)
+- [`users/ai-agent-skills.md`](users/ai-agent-skills.md)
+- [`users/antigravity-awesome-skills-vs-awesome-claude-skills.md`](users/antigravity-awesome-skills-vs-awesome-claude-skills.md)
+- [`users/best-claude-code-skills-github.md`](users/best-claude-code-skills-github.md)
+- [`users/best-cursor-skills-github.md`](users/best-cursor-skills-github.md)
 - [`users/bundles.md`](users/bundles.md)
 - [`users/workflows.md`](users/workflows.md)
 - [`users/kiro-integration.md`](users/kiro-integration.md)
@@ -28,6 +36,7 @@
 - [`maintainers/rollback-procedure.md`](maintainers/rollback-procedure.md)
 - [`maintainers/audit.md`](maintainers/audit.md)
 - [`maintainers/ci-drift-fix.md`](maintainers/ci-drift-fix.md)
+- [`maintainers/repo-growth-seo.md`](maintainers/repo-growth-seo.md)
 - [`maintainers/skills-update-guide.md`](maintainers/skills-update-guide.md)
 - [`maintainers/categorization-implementation.md`](maintainers/categorization-implementation.md)
 - [`maintainers/date-tracking-implementation.md`](maintainers/date-tracking-implementation.md)
diff --git a/docs/maintainers/repo-growth-seo.md b/docs/maintainers/repo-growth-seo.md
new file mode 100644
index 00000000..d6741597
--- /dev/null
+++ b/docs/maintainers/repo-growth-seo.md
@@ -0,0 +1,86 @@
+# Repo Growth SEO Playbook
+
+This document keeps the repository's GitHub-facing discovery copy aligned with the SEO-focused user docs.
+
+## Current position
+
+Preferred positioning:
+
+> Installable GitHub library of 1,273+ agentic skills for Claude Code, Cursor, Codex CLI, Gemini CLI, Antigravity, and other AI coding assistants.
+
+Key framing:
+
+- installable skill library;
+- GitHub-first discovery;
+- broad multi-tool compatibility;
+- bundles, workflows, and onboarding docs;
+- useful for both breadth and curated evaluation.
+
+## GitHub About settings
+
+Preferred description:
+
+> Installable GitHub library of 1,273+ agentic skills for Claude Code, Cursor, Codex CLI, Gemini CLI, Antigravity, and more. Includes installer CLI, bundles, workflows, and official/community skill collections.
+
+Preferred homepage:
+
+> `https://github.com/sickn33/antigravity-awesome-skills`
+
+Preferred topics:
+
+- `agentic-skills`
+- `agent-skills`
+- `ai-agents`
+- `ai-agent-skills`
+- `awesome-list`
+- `awesome-lists`
+- `antigravity`
+- `antigravity-skills`
+- `autonomous-coding`
+- `claude-code`
+- `claude-code-skills`
+- `codex-cli`
+- `codex-skills`
+- `cursor-skills`
+- `developer-tools`
+- `gemini-cli`
+- `gemini-skills`
+- `mcp`
+- `ai-workflows`
+- `skill-library`
+
+## Release notes checklist
+
+When publishing a release:
+
+- include a title that names the main user-facing use case, not only the internal codename;
+- mention newly supported tools, new bundles, and onboarding improvements early;
+- link back to the most relevant docs in `docs/users/`;
+- keep the first paragraph useful to someone who found the release page from Google.
+
+Suggested opening structure:
+
+1. one-sentence release summary with tool/use-case language;
+2. top changes that matter to new and returning users;
+3. links to install, bundles, workflows, and relevant comparison pages if needed.
+
+## Discussions checklist
+
+Suggested pinned discussion topics:
+
+- `Start here: best skills by tool`
+- `Best bundles for new users`
+- `How to choose between Antigravity and other skill libraries`
+
+Discussion posts should:
+
+- link to the tool-specific docs in `docs/users/`;
+- answer one search intent cleanly;
+- end with a single clear next step such as install, star, or compare.
+
+## Content maintenance rules
+
+- Keep README, GitHub About description, and tool-specific user docs semantically aligned.
+- Avoid cannibalization by giving each user doc a distinct primary intent.
+- Prefer honest comparisons over absolute claims.
+- Do not use SEM or paid language in discovery docs unless strategy changes later.
diff --git a/docs/users/ai-agent-skills.md b/docs/users/ai-agent-skills.md
new file mode 100644
index 00000000..f8c3ac2a
--- /dev/null
+++ b/docs/users/ai-agent-skills.md
@@ -0,0 +1,45 @@
+# AI Agent Skills
+
+If you are researching **AI agent skills** on GitHub, the biggest decision is usually not "which single skill is best?" but "do I want a broad installable library or a smaller curated collection?"
+
+Antigravity Awesome Skills is built for the first path: broad coverage, multiple supported tools, installation help, onboarding docs, bundles, workflows, and a catalog that supports both beginner and advanced users.
+
+## What to look for in an AI agent skills library
+
+- **Installability**: can you put the skills where your tool expects them without manual copying?
+- **Supported tools**: does the repo work with Claude Code, Cursor, Codex CLI, Gemini CLI, and related environments?
+- **Breadth vs curation**: do you want many options or a smaller shortlist of high-signal entries?
+- **Onboarding quality**: are there docs, bundles, workflows, and examples, or only raw files?
+- **Trust model**: does the repo identify official sources, security posture, and community review expectations?
+
+## When Antigravity Awesome Skills is a good fit
+
+- You want one library that spans planning, coding, debugging, testing, security, infra, product, and marketing.
+- You care about installation paths and practical onboarding, not only catalog size.
+- You want bundles and workflows to reduce choice overload.
+- You need compatibility across more than one AI coding assistant.
+
+## When a smaller curated repo may be better
+
+- You only want a narrow shortlist of highly curated or vendor-focused skills.
+- You prefer reviewing fewer files even if coverage is lower.
+- You are evaluating alternatives for a single tool and want a quick comparison first.
+
+## Start with a tool-specific guide
+
+- [`claude-code-skills.md`](claude-code-skills.md)
+- [`cursor-skills.md`](cursor-skills.md)
+- [`codex-cli-skills.md`](codex-cli-skills.md)
+- [`gemini-cli-skills.md`](gemini-cli-skills.md)
+
+## Compare broad vs curated libraries
+
+- [`antigravity-awesome-skills-vs-awesome-claude-skills.md`](antigravity-awesome-skills-vs-awesome-claude-skills.md)
+- [`best-claude-code-skills-github.md`](best-claude-code-skills-github.md)
+- [`best-cursor-skills-github.md`](best-cursor-skills-github.md)
+
+## Quick recommendation
+
+- Choose **Antigravity Awesome Skills** if you want a large, installable, multi-tool library with onboarding help.
+- Choose a smaller curated repo if you want fewer choices and more editorial filtering.
+- If you are unsure, install this repo first, start with [`bundles.md`](bundles.md), and then compare alternatives once you know your preferred workflow.
diff --git a/docs/users/antigravity-awesome-skills-vs-awesome-claude-skills.md b/docs/users/antigravity-awesome-skills-vs-awesome-claude-skills.md
new file mode 100644
index 00000000..82f8a91c
--- /dev/null
+++ b/docs/users/antigravity-awesome-skills-vs-awesome-claude-skills.md
@@ -0,0 +1,43 @@
+# Antigravity Awesome Skills vs Awesome Claude Skills
+
+If you are comparing **Antigravity Awesome Skills** with **Awesome Claude Skills**, the decision usually comes down to breadth vs curation.
+
+For clarity: the repository many people still refer to as `awesome-claude-skills` now lives at [VoltAgent/awesome-agent-skills](https://github.com/VoltAgent/awesome-agent-skills).
+
+## TL;DR
+
+- Choose **Antigravity Awesome Skills** if you want a large installable library, broad tool coverage, and strong onboarding.
+- Choose **VoltAgent Awesome Agent Skills** if you want a curated list with a strong official-team angle and a tighter scope.
+
+## At-a-glance comparison
+
+| Criteria | Antigravity Awesome Skills | VoltAgent Awesome Agent Skills |
+| --- | --- | --- |
+| Best for | Breadth, installation, multi-tool daily use | Curated discovery and official/community highlights |
+| Catalog shape | Large installable library with bundles, workflows, docs, and generated catalog | Curated awesome-list style collection |
+| Supported tools | Claude Code, Cursor, Codex CLI, Gemini CLI, Antigravity, Kiro, OpenCode, Copilot, more | Claude Code, Codex, Antigravity, Gemini CLI, Cursor, Copilot, OpenCode, Windsurf, more |
+| Onboarding | Installation docs, bundles, workflows, getting-started guides | Curated README and categorized references |
+| Good fit when | You want one repo to install and work from | You want a smaller list to browse and evaluate |
+
+## Why choose Antigravity Awesome Skills
+
+- You want a single GitHub repository that acts as both a skill source and an installable working library.
+- You care about onboarding assets like [`bundles.md`](bundles.md), [`workflows.md`](workflows.md), and tool-specific guides.
+- You need coverage across many domains, not just a curated shortlist.
+
+## Why choose VoltAgent Awesome Agent Skills
+
+- You want a more editorial, awesome-list style browsing experience.
+- You value a repository centered on official and team-published agent skills.
+- You prefer a smaller set to review manually before installing anything.
+
+## Honest tradeoffs
+
+- Antigravity can feel bigger and noisier at first because it optimizes for breadth.
+- VoltAgent can be easier to skim quickly because it optimizes for curation.
+- If you want both, a sensible workflow is to browse curated lists first and install a broader library once you know your use cases.
+
+## Suggested next step
+
+- If you want to install and start using skills today, go back to [`README.md`](../../README.md) and follow the installation guide.
+- If you are still evaluating tool-specific options, continue with [`best-claude-code-skills-github.md`](best-claude-code-skills-github.md) or [`best-cursor-skills-github.md`](best-cursor-skills-github.md).
diff --git a/docs/users/best-claude-code-skills-github.md b/docs/users/best-claude-code-skills-github.md
new file mode 100644
index 00000000..a95007c7
--- /dev/null
+++ b/docs/users/best-claude-code-skills-github.md
@@ -0,0 +1,62 @@
+# Best Claude Code Skills on GitHub
+
+If you are looking for the **best Claude Code skills on GitHub**, there is no single perfect repository for every user. The right choice depends on whether you want breadth, curation, or official reference material.
+
+## Best overall installable library
+
+### 1. [sickn33/antigravity-awesome-skills](https://github.com/sickn33/antigravity-awesome-skills)
+
+Best for teams and individual developers who want one large installable library with onboarding docs, bundles, workflows, and support for more than just Claude Code.
+
+Choose this if you want:
+
+- a broad library you can install and use immediately;
+- bundles and workflows to reduce choice overload;
+- compatibility beyond Claude Code alone.
+
+## Best curated shortlist
+
+### 2. [VoltAgent/awesome-agent-skills](https://github.com/VoltAgent/awesome-agent-skills)
+
+Best for developers who want a curated, awesome-list style collection with strong coverage of official and community skill sources.
+
+Choose this if you want:
+
+- a tighter list to browse before installing anything;
+- an editorial collection that highlights official team skills;
+- an easier first pass through the ecosystem.
+
+## Best official reference
+
+### 3. [anthropics/skills](https://github.com/anthropics/skills)
+
+Best for developers who want official Anthropic-published skills and reference implementations first, then plan to expand from there.
+
+Choose this if you want:
+
+- official source material directly from Anthropic;
+- a smaller official baseline instead of a large community library;
+- a reference point for how vendor-maintained skills are structured.
+
+## Best smaller community collection
+
+### 4. [karanb192/awesome-claude-skills](https://github.com/karanb192/awesome-claude-skills)
+
+Best for people who want a smaller Claude-focused community collection and a simpler shortlist than a giant installable repo.
+
+Choose this if you want:
+
+- Claude-specific focus;
+- a smaller library to review manually;
+- community-driven additions without the scale of a huge catalog.
+
+## How to choose quickly
+
+- Choose **Antigravity Awesome Skills** if you want the most practical install-and-use path.
+- Choose **VoltAgent Awesome Agent Skills** if you want the strongest curated shortlist.
+- Choose **anthropics/skills** if official vendor reference matters most.
+- Choose **karanb192/awesome-claude-skills** if you want a smaller community-first Claude library.
+
+## Recommended next step
+
+If you want to get productive quickly, install [Antigravity Awesome Skills](https://github.com/sickn33/antigravity-awesome-skills) and start with [`claude-code-skills.md`](claude-code-skills.md) plus [`bundles.md`](bundles.md).
diff --git a/docs/users/best-cursor-skills-github.md b/docs/users/best-cursor-skills-github.md
new file mode 100644
index 00000000..ec7bb030
--- /dev/null
+++ b/docs/users/best-cursor-skills-github.md
@@ -0,0 +1,62 @@
+# Best Cursor Skills on GitHub
+
+If you are searching for the **best Cursor skills on GitHub**, the best option depends on whether you want a broad installable library, a curated discovery list, or a smaller community collection.
+
+## Best overall installable library
+
+### 1. [sickn33/antigravity-awesome-skills](https://github.com/sickn33/antigravity-awesome-skills)
+
+Best for developers who want one repository they can install into Cursor and keep using across frontend, backend, testing, infra, product, and growth work.
+
+Choose this if you want:
+
+- a direct `--cursor` install flow;
+- a large catalog instead of a handful of examples;
+- bundles and workflows to make a big library easier to navigate.
+
+## Best curated multi-tool shortlist
+
+### 2. [VoltAgent/awesome-agent-skills](https://github.com/VoltAgent/awesome-agent-skills)
+
+Best for developers who want a curated list of agent skills that explicitly supports Cursor alongside other AI coding assistants.
+
+Choose this if you want:
+
+- a smaller curated list before committing to a larger install;
+- broad multi-tool compatibility with strong editorial filtering;
+- a discovery-first experience.
+
+## Best smaller installable community library
+
+### 3. [MoizIbnYousaf/Ai-Agent-Skills](https://github.com/MoizIbnYousaf/Ai-Agent-Skills)
+
+Best for developers who want a smaller installable library with Cursor compatibility and a lighter-weight starting point than a giant catalog.
+
+Choose this if you want:
+
+- a more compact installable set;
+- fewer files to review manually;
+- a library that still targets multiple agent environments.
+
+## Best Cursor-specific collection
+
+### 4. [araguaci/cursor-skills](https://github.com/araguaci/cursor-skills)
+
+Best for developers who want a repository centered specifically on Cursor rather than a broader multi-tool skill ecosystem.
+
+Choose this if you want:
+
+- Cursor-specific orientation;
+- a narrower scope to review quickly;
+- a lightweight repo to compare against broader libraries.
+
+## How to choose quickly
+
+- Choose **Antigravity Awesome Skills** if you want the strongest install-and-use path for real day-to-day Cursor work.
+- Choose **VoltAgent Awesome Agent Skills** if you want curation first and installation later.
+- Choose **Ai-Agent-Skills** if you want a smaller installable library.
+- Choose **cursor-skills** if you want the most Cursor-specific starting point.
+
+## Recommended next step
+
+If your goal is to start working in Cursor today, install [Antigravity Awesome Skills](https://github.com/sickn33/antigravity-awesome-skills) and continue with [`cursor-skills.md`](cursor-skills.md).
diff --git a/docs/users/claude-code-skills.md b/docs/users/claude-code-skills.md
new file mode 100644
index 00000000..781d648b
--- /dev/null
+++ b/docs/users/claude-code-skills.md
@@ -0,0 +1,62 @@
+# Claude Code Skills
+
+If you are looking for **Claude Code skills** you can install from GitHub, this repository is designed to get you from first clone to first useful prompt quickly.
+
+Antigravity Awesome Skills gives Claude Code users an installable library of `SKILL.md` playbooks, role-based bundles, and execution workflows. The goal is not just to collect prompts, but to make repeatable engineering tasks easier to invoke, review, and reuse.
+
+## Why use this repo for Claude Code
+
+- It includes 1,273+ skills instead of a narrow single-domain starter pack.
+- It supports the standard `.claude/skills/` path and the Claude Code plugin marketplace flow.
+- It includes onboarding docs, bundles, and workflows so new users do not need to guess where to begin.
+- It covers both everyday engineering tasks and specialized work like security reviews, infrastructure, product planning, and documentation.
+
+## Install Claude Code Skills
+
+### Option A: installer CLI
+
+```bash
+npx antigravity-awesome-skills --claude
+```
+
+### Option B: Claude Code plugin marketplace
+
+```text
+/plugin marketplace add sickn33/antigravity-awesome-skills
+/plugin install antigravity-awesome-skills
+```
+
+### Verify the install
+
+```bash
+test -d .claude/skills || test -d ~/.claude/skills
+```
+
+## Best starter skills for Claude Code
+
+- [`brainstorming`](../../skills/brainstorming/): plan features and specs before writing code.
+- [`lint-and-validate`](../../skills/lint-and-validate/): run fast quality checks before you commit.
+- [`create-pr`](../../skills/create-pr/): package your work into a clean pull request.
+- [`systematic-debugging`](../../skills/systematic-debugging/): investigate failures with a repeatable process.
+- [`security-auditor`](../../skills/security-auditor/): review APIs, auth, and sensitive flows with a security lens.
+
+## Example Claude Code prompts
+
+```text
+Use @brainstorming to design a new billing workflow for my SaaS.
+```
+
+```text
+Use @lint-and-validate on src/routes/api.ts and fix the issues you find.
+```
+
+```text
+Use @create-pr to turn these changes into a clean PR summary and checklist.
+```
+
+## What to do next
+
+- Start with [`bundles.md`](bundles.md) if you want a role-based shortlist.
+- Use [`workflows.md`](workflows.md) if you want step-by-step execution playbooks.
+- Compare options in [`best-claude-code-skills-github.md`](best-claude-code-skills-github.md) if you are still evaluating repositories.
+- Go back to the main landing page in [`README.md`](../../README.md) when you want the full installation matrix.
diff --git a/docs/users/codex-cli-skills.md b/docs/users/codex-cli-skills.md
new file mode 100644
index 00000000..9b7d4e20
--- /dev/null
+++ b/docs/users/codex-cli-skills.md
@@ -0,0 +1,52 @@
+# Codex CLI Skills
+
+If you want **Codex CLI skills** that are easy to install and practical in a local coding loop, this repository is designed for that exact use case.
+
+Antigravity Awesome Skills supports Codex CLI through the `.codex/skills/` path and gives you a wide set of reusable task playbooks for planning, implementation, debugging, testing, security review, and delivery.
+
+## Why use this repo for Codex CLI
+
+- It supports Codex CLI with a dedicated install flag and a standard skills layout.
+- It is strong for local repo work where you want to move from planning to implementation to verification without changing libraries.
+- It includes both general-purpose engineering skills and deeper specialist tracks.
+- It gives you docs and bundles, not just raw skill files.
+
+## Install Codex CLI Skills
+
+```bash
+npx antigravity-awesome-skills --codex
+```
+
+### Verify the install
+
+```bash
+test -d .codex/skills || test -d ~/.codex/skills
+```
+
+## Best starter skills for Codex CLI
+
+- [`brainstorming`](../../skills/brainstorming/): clarify requirements before touching code.
+- [`concise-planning`](../../skills/concise-planning/): turn ambiguous work into an atomic execution plan.
+- [`test-driven-development`](../../skills/test-driven-development/): structure changes around red-green-refactor.
+- [`lint-and-validate`](../../skills/lint-and-validate/): keep quality checks close to the implementation loop.
+- [`create-pr`](../../skills/create-pr/): wrap up work cleanly once implementation is done.
+
+## Example Codex CLI prompts
+
+```text
+Use @concise-planning to break this feature request into an implementation checklist.
+```
+
+```text
+Use @test-driven-development to add tests before changing this parser.
+```
+
+```text
+Use @create-pr once everything is passing and summarize the user-facing changes.
+```
+
+## What to do next
+
+- Read [`ai-agent-skills.md`](ai-agent-skills.md) if you want a framework for choosing between broad and curated skill libraries.
+- Use [`workflows.md`](workflows.md) when you want step-by-step execution patterns for common engineering goals.
+- Return to [`README.md`](../../README.md) for the full compatibility matrix.
diff --git a/docs/users/cursor-skills.md b/docs/users/cursor-skills.md
new file mode 100644
index 00000000..020fa282
--- /dev/null
+++ b/docs/users/cursor-skills.md
@@ -0,0 +1,52 @@
+# Cursor Skills
+
+If you searched for **Cursor skills** on GitHub, this repository is built to be a practical starting point: installable skills, clear usage docs, and a large library that works well with Cursor chat workflows.
+
+Antigravity Awesome Skills supports Cursor through the `.cursor/skills/` path and keeps the entry point simple: install once, then invoke the skills you need in chat.
+
+## Why use this repo for Cursor
+
+- It supports Cursor directly with a dedicated install flag.
+- It works well for UI-heavy and full-stack workflows where Cursor users often want planning, implementation, validation, and debugging in one place.
+- It includes bundles and workflows, which are helpful when you do not want to hand-pick from a huge catalog immediately.
+- It is broad enough for frontend, backend, infra, testing, product, and growth work without switching repositories.
+
+## Install Cursor Skills
+
+```bash
+npx antigravity-awesome-skills --cursor
+```
+
+### Verify the install
+
+```bash
+test -d .cursor/skills || test -d ~/.cursor/skills
+```
+
+## Best starter skills for Cursor
+
+- [`frontend-design`](../../skills/frontend-design/): improve UI direction and interaction quality.
+- [`react-best-practices`](../../skills/react-best-practices/): tighten React and Next.js implementation patterns.
+- [`tailwind-patterns`](../../skills/tailwind-patterns/): structure utility-first UI work cleanly.
+- [`testing-patterns`](../../skills/testing-patterns/): add focused unit and integration tests.
+- [`api-design-principles`](../../skills/api-design-principles/): define clean interfaces before implementation spreads.
+
+## Example Cursor prompts
+
+```text
+@frontend-design redesign this landing page to feel more premium and conversion-focused.
+```
+
+```text
+@react-best-practices review this component tree and fix the biggest performance problems.
+```
+
+```text
+@testing-patterns add tests for the checkout state machine in this folder.
+```
+
+## What to do next
+
+- Read [`best-cursor-skills-github.md`](best-cursor-skills-github.md) if you want a shortlist of GitHub options for Cursor-compatible skills.
+- Use [`bundles.md`](bundles.md) if you want a role-based starting point such as Web Wizard or Full-Stack Developer.
+- Open [`usage.md`](usage.md) if you want more prompt examples and execution patterns.
diff --git a/docs/users/gemini-cli-skills.md b/docs/users/gemini-cli-skills.md
new file mode 100644
index 00000000..274dd940
--- /dev/null
+++ b/docs/users/gemini-cli-skills.md
@@ -0,0 +1,52 @@
+# Gemini CLI Skills
+
+If you are evaluating **Gemini CLI skills** on GitHub, this repository is a strong broad starting point: installable skills, large coverage, and clear onboarding for day-one use.
+
+Antigravity Awesome Skills supports Gemini CLI through the `.gemini/skills/` path and combines general engineering playbooks with specialized skills for AI systems, integrations, infrastructure, testing, product, and growth.
+
+## Why use this repo for Gemini CLI
+
+- It installs directly into the expected Gemini skills path.
+- It includes both core software engineering skills and deeper agent/LLM-oriented skills.
+- It helps new users get started with bundles and workflows rather than forcing a cold start from 1,273+ files.
+- It is useful whether you want a broad internal skill library or a single repo to test many workflows quickly.
+
+## Install Gemini CLI Skills
+
+```bash
+npx antigravity-awesome-skills --gemini
+```
+
+### Verify the install
+
+```bash
+test -d .gemini/skills || test -d ~/.gemini/skills
+```
+
+## Best starter skills for Gemini CLI
+
+- [`brainstorming`](../../skills/brainstorming/): turn vague goals into clearer implementation specs.
+- [`prompt-engineering`](../../skills/prompt-engineering/): improve prompting quality and task framing.
+- [`rag-engineer`](../../skills/rag-engineer/): build and evaluate retrieval systems.
+- [`langgraph`](../../skills/langgraph/): design stateful agent workflows.
+- [`mcp-builder`](../../skills/mcp-builder/): add tool integrations and external capabilities.
+
+## Example Gemini CLI prompts
+
+```text
+Use @prompt-engineering to improve this system prompt for a coding assistant.
+```
+
+```text
+Use @langgraph to design a stateful agent workflow for support triage.
+```
+
+```text
+Use @mcp-builder to plan the tools needed for a GitHub + Slack integration.
+```
+
+## What to do next
+
+- Start with [`bundles.md`](bundles.md) if you want a smaller curated subset by role.
+- Read [`ai-agent-skills.md`](ai-agent-skills.md) if you are comparing general-purpose agent skill libraries.
+- Use [`usage.md`](usage.md) if you want more examples of how to invoke skills in real prompts.
diff --git a/docs/users/getting-started.md b/docs/users/getting-started.md
index 7856c1f0..625f905e 100644
--- a/docs/users/getting-started.md
+++ b/docs/users/getting-started.md
@@ -149,6 +149,13 @@ A: Yes, MIT License. Open Source forever.
 
 ## Next Steps
 
+Need a tool-specific starting point first?
+
+- [Claude Code skills](claude-code-skills.md)
+- [Cursor skills](cursor-skills.md)
+- [Codex CLI skills](codex-cli-skills.md)
+- [Gemini CLI skills](gemini-cli-skills.md)
+
 1. [Browse the Bundles](bundles.md)
 2. [See Real-World Examples](../contributors/examples.md)
 3. [Contribute a Skill](../../CONTRIBUTING.md)
diff --git a/docs/users/usage.md b/docs/users/usage.md
index f9376b07..9e8ab675 100644
--- a/docs/users/usage.md
+++ b/docs/users/usage.md
@@ -194,6 +194,13 @@ Let's actually use a skill right now. Follow these steps:
 
 Don't try to use all 1,254+ skills at once. Here's a sensible approach:
 
+If you want a tool-specific starting point before choosing skills, use:
+
+- [Claude Code skills](claude-code-skills.md)
+- [Cursor skills](cursor-skills.md)
+- [Codex CLI skills](codex-cli-skills.md)
+- [Gemini CLI skills](gemini-cli-skills.md)
+
 ### Start with "The Essentials" (5 skills, everyone needs these)
 
 1. **`@brainstorming`** - Plan before you build