docs(seo): add repo growth discovery pages

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.

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).

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).

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).

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.

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.

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.

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.

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)

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