docs(readme): reorganize root landing page
This commit is contained in:
sickn33
550
README.md
550
README.md
@@ -3,9 +3,11 @@
|
||||
|
||||
> **Installable GitHub library of 1,340+ 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.
|
||||
Antigravity Awesome Skills is an installable GitHub library and npm installer for reusable `SKILL.md` playbooks. It is designed for Claude Code, Cursor, Codex CLI, Gemini CLI, Antigravity, Kiro, OpenCode, GitHub Copilot, and other AI coding assistants that benefit from structured operating instructions. Instead of collecting one-off prompt snippets, this repository gives you a searchable, installable catalog of skills, bundles, workflows, plugin-safe distributions, and practical docs that help agents perform recurring tasks with better context, stronger constraints, and clearer outputs.
|
||||
|
||||
**Start here:** [Star the repo](https://github.com/sickn33/antigravity-awesome-skills/stargazers) · [Install in 1 minute](#installation) · [Plugins for Claude Code and Codex](docs/users/plugins.md) · [Choose your tool](#choose-your-tool) · [Best skills by tool](#best-skills-by-tool) · [Bundles](docs/users/bundles.md) · [Workflows](docs/users/workflows.md)
|
||||
You can use this repo to install a broad multi-tool skill library, start from role-based bundles, or jump into workflow-driven execution for planning, coding, debugging, testing, security review, infrastructure, product work, and growth tasks including SEO, GEO, and AEO-oriented content workflows. The root README is intentionally a high-signal landing page: understand what the project is, install it quickly, choose the right tool path, and then follow deeper docs only when you need them.
|
||||
|
||||
**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) · [📚 Browse 1,340+ Skills](#browse-1340-skills) · [Bundles](docs/users/bundles.md) · [Workflows](docs/users/workflows.md) · [Plugins for Claude Code and Codex](docs/users/plugins.md)
|
||||
|
||||
[](https://github.com/sickn33/antigravity-awesome-skills/stargazers)
|
||||
[](LICENSE)
|
||||
@@ -22,7 +24,7 @@ Antigravity Awesome Skills is a GitHub repository and installer CLI for reusable
|
||||
|
||||
**Current release: V9.3.0.** Trusted by 29k+ 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
|
||||
## Why 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.
|
||||
@@ -32,219 +34,57 @@ Antigravity Awesome Skills is a GitHub repository and installer CLI for reusable
|
||||
|
||||
## Table of Contents
|
||||
|
||||
- [🚀 New Here? Start Here!](#new-here-start-here)
|
||||
- [📖 Complete Usage Guide](docs/users/usage.md) - **Start here if confused after installation!**
|
||||
- [🧠 Core Concepts](#core-concepts)
|
||||
- [🔌 Compatibility & Invocation](#compatibility--invocation)
|
||||
- [🛠️ Installation](#installation)
|
||||
- [🧩 Plugins For Claude Code And Codex](#plugins-for-claude-code-and-codex)
|
||||
- [🧭 Integration Guides](#integration-guides)
|
||||
- [🧰 Best Skills By Tool](#best-skills-by-tool)
|
||||
- [❓ Quick FAQ](#quick-faq)
|
||||
- [🛡️ Security Posture](#security-posture)
|
||||
- [🧯 Troubleshooting](#troubleshooting)
|
||||
- [🎁 Curated Collections (Bundles)](#curated-collections)
|
||||
- [🧭 Antigravity Workflows](#antigravity-workflows)
|
||||
- [⚖️ Alternatives & Comparisons](#alternatives--comparisons)
|
||||
- [📦 Features & Categories](#features--categories)
|
||||
- [📚 Browse 1,340+ Skills](#browse-1340-skills)
|
||||
- [🤝 Contributing](#contributing)
|
||||
- [💬 Community](#community)
|
||||
- [☕ Support the Project](#support-the-project)
|
||||
- [🏆 Credits & Sources](#credits--sources)
|
||||
- [👥 Repo Contributors](#repo-contributors)
|
||||
- [⚖️ License](#license)
|
||||
- [🌟 Star History](#star-history)
|
||||
|
||||
---
|
||||
|
||||
## New Here? Start Here!
|
||||
|
||||
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 9.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 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)
|
||||
|
||||
Install once; then use Starter Packs in [docs/users/bundles.md](docs/users/bundles.md) to focus on your role.
|
||||
|
||||
1. **Install**:
|
||||
|
||||
```bash
|
||||
# Default: ~/.gemini/antigravity/skills (Antigravity global). Use --path for other locations.
|
||||
npx antigravity-awesome-skills
|
||||
```
|
||||
The npm installer uses a shallow clone by default so first-run installs stay lighter than a full repository history checkout.
|
||||
2. **Verify**:
|
||||
|
||||
```bash
|
||||
test -d ~/.gemini/antigravity/skills && echo "Skills installed in ~/.gemini/antigravity/skills"
|
||||
```
|
||||
3. **Run your first skill**:
|
||||
|
||||
> "Use **@brainstorming** to plan a SaaS MVP."
|
||||
>
|
||||
4. **Pick a bundle**:
|
||||
|
||||
- **Web Dev?** start with `Web Wizard`.
|
||||
- **Security?** start with `Security Engineer`.
|
||||
- **General use?** start with `Essentials`.
|
||||
|
||||
### 3. 🧠 How to use
|
||||
|
||||
Once installed, just ask your agent naturally:
|
||||
|
||||
> "Use the **@brainstorming** skill to help me plan a SaaS."
|
||||
> "Run **@lint-and-validate** on this file."
|
||||
|
||||
👉 **NEW:** [**Complete Usage Guide - Read This First!**](docs/users/usage.md) (answers: "What do I do after installation?", "How do I execute skills?", "What should prompts look like?")
|
||||
|
||||
👉 **[Full Getting Started Guide](docs/users/getting-started.md)**
|
||||
|
||||
---
|
||||
|
||||
## Core Concepts
|
||||
|
||||
Before you compare bundles or start installing tool-specific paths, it helps to separate four ideas:
|
||||
|
||||
- **Skills**: reusable `SKILL.md` playbooks that teach an AI assistant how to execute a workflow well.
|
||||
- **MCP tools**: integrations and external capabilities the assistant can call. Tools provide actions; skills provide operating instructions.
|
||||
- **Plugins**: installable, marketplace-friendly distributions of the repository for Claude Code and Codex, including root plugins and curated bundle plugins.
|
||||
- **Bundles**: curated recommendations for which skills to start with for a role or domain.
|
||||
- **Workflows**: ordered execution playbooks that show how to combine multiple skills step by step.
|
||||
|
||||
If you want the clearest explanation of **skills vs MCP/tools**, start here:
|
||||
|
||||
- [Skills vs MCP Tools](docs/users/skills-vs-mcp-tools.md)
|
||||
- [Plugins for Claude Code and Codex](docs/users/plugins.md)
|
||||
- [Bundles](docs/users/bundles.md)
|
||||
- [Workflows](docs/users/workflows.md)
|
||||
|
||||
## Integration Guides
|
||||
|
||||
If your real question is "how do I use Antigravity Awesome Skills with my tool?", use the matching guide:
|
||||
|
||||
- **[Claude Code](docs/users/claude-code-skills.md)**: install paths, starter prompts, plugin marketplace flow, and first-use guidance.
|
||||
- **[Cursor](docs/users/cursor-skills.md)**: chat-first usage, frontend/full-stack starter skills, and practical prompts.
|
||||
- **[Codex CLI](docs/users/codex-cli-skills.md)**: planning, implementation, debugging, testing, and review loops for local coding work.
|
||||
- **[Gemini CLI](docs/users/gemini-cli-skills.md)**: broad engineering, agent systems, integrations, and AI workflow coverage.
|
||||
- **[AI agent skills guide](docs/users/ai-agent-skills.md)**: how to evaluate this repo against broader or narrower alternatives.
|
||||
|
||||
## Quick FAQ
|
||||
|
||||
### What is Antigravity Awesome Skills?
|
||||
|
||||
It is an installable GitHub library of reusable `SKILL.md` playbooks for Claude Code, Cursor, Codex CLI, Gemini CLI, Antigravity, and related AI coding assistants.
|
||||
|
||||
### How do I install it?
|
||||
|
||||
Use `npx antigravity-awesome-skills`, or a tool-specific flag like `--codex`, `--cursor`, `--gemini`, or `--claude` when you want the installer to target a specific skills directory.
|
||||
|
||||
### What is the difference between skills and MCP tools?
|
||||
|
||||
Skills are reusable playbooks that tell an AI assistant how to execute a workflow. MCP tools expose external systems or actions the assistant can call. Skills guide behavior; MCP tools provide capabilities.
|
||||
|
||||
### What is the difference between bundles and workflows?
|
||||
|
||||
Bundles are curated sets of recommended skills. Workflows are ordered execution playbooks for concrete outcomes.
|
||||
|
||||
For the expanded version, read [FAQ](docs/users/faq.md).
|
||||
|
||||
---
|
||||
|
||||
## Compatibility & Invocation
|
||||
|
||||
These skills follow the universal **SKILL.md** format and work with any AI coding assistant that supports agentic skills.
|
||||
|
||||
| Tool | Type | Invocation Example | Path |
|
||||
| :-------------------- | :--- | :---------------------------------- | :------------------------------------------------------------------------ |
|
||||
| **Claude Code** | CLI | `>> /skill-name help me...` | `.claude/skills/` |
|
||||
| **Gemini CLI** | CLI | `(User Prompt) Use skill-name...` | `.gemini/skills/` |
|
||||
| **Codex CLI** | CLI | `(User Prompt) Use skill-name...` | `.codex/skills/` |
|
||||
| **Kiro CLI** | CLI | `(Auto) Skills load on-demand` | Global:`~/.kiro/skills/` · Workspace: `.kiro/skills/` |
|
||||
| **Kiro IDE** | IDE | `/skill-name or (Auto)` | Global:`~/.kiro/skills/` · Workspace: `.kiro/skills/` |
|
||||
| **Antigravity** | IDE | `(Agent Mode) Use skill...` | Global:`~/.gemini/antigravity/skills/` · Workspace: `.agent/skills/` |
|
||||
| **Cursor** | IDE | `@skill-name (in Chat)` | `.cursor/skills/` |
|
||||
| **Copilot** | Ext | `(Paste content manually)` | N/A |
|
||||
| **OpenCode** | CLI | `opencode run @skill-name` | `.agents/skills/` |
|
||||
| **AdaL CLI** | CLI | `(Auto) Skills load on-demand` | `.adal/skills/` |
|
||||
|
||||
> [!TIP]
|
||||
> **Default installer path**: `~/.gemini/antigravity/skills` (Antigravity global). Use `--path ~/.agent/skills` for workspace-specific install. For manual clone, `.agent/skills/` works as workspace path for Antigravity.
|
||||
> **OpenCode Path Update**: opencode path is changed to `.agents/skills` for global skills. See [Place Files](https://opencode.ai/docs/skills/#place-files) directive on OpenCode Docs.
|
||||
|
||||
> [!TIP]
|
||||
> **Windows Users**: use the standard install commands. The legacy `core.symlinks=true` / Developer Mode workaround is no longer required for this repository.
|
||||
- [Why This Repo](#why-this-repo)
|
||||
- [Installation](#installation)
|
||||
- [Choose Your Tool](#choose-your-tool)
|
||||
- [Quick FAQ](#quick-faq)
|
||||
- [Best Skills By Tool](#best-skills-by-tool)
|
||||
- [Bundles & Workflows](#bundles--workflows)
|
||||
- [Browse 1,340+ Skills](#browse-1340-skills)
|
||||
- [Troubleshooting](#troubleshooting)
|
||||
- [Support the Project](#support-the-project)
|
||||
- [Contributing](#contributing)
|
||||
- [Community](#community)
|
||||
- [Credits & Sources](#credits--sources)
|
||||
- [Repo Contributors](#repo-contributors)
|
||||
- [Star History](#star-history)
|
||||
- [License](#license)
|
||||
|
||||
## Installation
|
||||
|
||||
To use these skills with **Claude Code**, **Gemini CLI**, **Codex CLI**, **Kiro CLI**, **Kiro IDE**, **Cursor**, **Antigravity**, **OpenCode**, or **AdaL**:
|
||||
Most users should start with the full library install and use bundles or workflows to narrow down what to try first.
|
||||
|
||||
### Option A: npx (recommended)
|
||||
### Full library install
|
||||
|
||||
```bash
|
||||
# Default: ~/.gemini/antigravity/skills (Antigravity global). Use --path for other locations.
|
||||
npx antigravity-awesome-skills
|
||||
```
|
||||
|
||||
2. Verify the default install:
|
||||
The npm installer uses a shallow clone by default so first-run installs stay lighter than a full repository history checkout.
|
||||
|
||||
### Verify the install
|
||||
|
||||
```bash
|
||||
test -d ~/.gemini/antigravity/skills && echo "Skills installed"
|
||||
test -d ~/.gemini/antigravity/skills && echo "Skills installed in ~/.gemini/antigravity/skills"
|
||||
```
|
||||
|
||||
3. Use your first skill:
|
||||
### Run your first skill
|
||||
|
||||
```text
|
||||
Use @brainstorming to plan a SaaS MVP.
|
||||
```
|
||||
|
||||
4. Browse starter collections in [`docs/users/bundles.md`](docs/users/bundles.md) and execution playbooks in [`docs/users/workflows.md`](docs/users/workflows.md).
|
||||
### Prefer plugins for Claude Code or Codex?
|
||||
|
||||
### Option B: Claude Code plugin marketplace
|
||||
|
||||
If you use Claude Code and prefer the plugin marketplace flow, this repository now ships a root `.claude-plugin/marketplace.json`:
|
||||
|
||||
```text
|
||||
/plugin marketplace add sickn33/antigravity-awesome-skills
|
||||
/plugin install antigravity-awesome-skills
|
||||
```
|
||||
|
||||
This installs the same repository-backed skill library through Claude Code's plugin marketplace entrypoint.
|
||||
|
||||
The Claude plugin is a plugin-safe filtered distribution of the repo. Skills that still contain host-specific paths or undeclared setup remain in the repository, but are excluded from the plugin until they are hardened.
|
||||
|
||||
### Option C: Codex plugin marketplace metadata
|
||||
|
||||
If you use Codex and prefer a marketplace-style plugin source instead of copying skills into `.codex/skills/`, this repository now ships:
|
||||
|
||||
- `.agents/plugins/marketplace.json`
|
||||
- `plugins/antigravity-awesome-skills/.codex-plugin/plugin.json`
|
||||
|
||||
The Codex plugin points at the same curated `skills/` tree through a repo-local plugin entry, so the library can be exposed as an installable Codex plugin source without duplicating the catalog.
|
||||
|
||||
Bundle users can also install focused Claude Code and Codex bundle plugins from the generated marketplace metadata instead of taking the full library at once.
|
||||
|
||||
Like the Claude distribution, the Codex plugin only exposes plugin-safe skills. Repo-only skills are still available through clone or installer flows while they are being hardened for marketplace use.
|
||||
|
||||
## Plugins for Claude Code and Codex
|
||||
|
||||
Release `9.0.0` formalizes plugins as a first-class distribution model for this repository.
|
||||
|
||||
- The **full library install** remains the broadest path: use `npx antigravity-awesome-skills --claude` or `--codex` when you want the largest available catalog.
|
||||
- The **root plugin** gives Claude Code or Codex a marketplace-friendly installable distribution of the repository.
|
||||
- **Bundle plugins** give you narrower role-based installs such as `Essentials`, `Security Engineer`, or `Web Wizard`.
|
||||
- Plugin distributions are intentionally **plugin-safe**. Skills that still depend on host-specific paths, undeclared setup, or extra hardening remain in the repository, but stay out of marketplace publication until they are ready.
|
||||
|
||||
If you want the full explanation of root plugins, bundle plugins, full-library installs, and the difference between Claude Code and Codex plugin surfaces, read:
|
||||
|
||||
- [Plugins for Claude Code and Codex](docs/users/plugins.md)
|
||||
- Use the full library install when you want the broadest catalog and direct control over your installed skills directory.
|
||||
- Use the plugin route when you want a marketplace-style, plugin-safe distribution for Claude Code or Codex.
|
||||
- Read [Plugins for Claude Code and Codex](docs/users/plugins.md) for the full breakdown of full-library install vs plugin install vs bundle plugins.
|
||||
|
||||
## Choose Your Tool
|
||||
|
||||
Use the same repository, but install or invoke it in the way your host expects.
|
||||
|
||||
| Tool | Install | First Use |
|
||||
| -------------- | ------------------------------------------------------------------------ | ------------------------------------------------------ |
|
||||
| Claude Code | `npx antigravity-awesome-skills --claude` or Claude plugin marketplace | `>> /brainstorming help me plan a feature` |
|
||||
@@ -259,6 +99,32 @@ If you want the full explanation of root plugins, bundle plugins, full-library i
|
||||
| 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 |
|
||||
|
||||
For path details, prompt examples, and setup caveats by host, go to:
|
||||
|
||||
- [Claude Code skills](docs/users/claude-code-skills.md)
|
||||
- [Cursor skills](docs/users/cursor-skills.md)
|
||||
- [Codex CLI skills](docs/users/codex-cli-skills.md)
|
||||
- [Gemini CLI skills](docs/users/gemini-cli-skills.md)
|
||||
- [AI agent skills guide](docs/users/ai-agent-skills.md)
|
||||
|
||||
## Quick FAQ
|
||||
|
||||
### What is Antigravity Awesome Skills?
|
||||
|
||||
It is an installable GitHub library of reusable `SKILL.md` playbooks for Claude Code, Cursor, Codex CLI, Gemini CLI, Antigravity, and related AI coding assistants. The repo packages those skills with an installer CLI, bundles, workflows, generated catalogs, and docs so you can move from discovery to daily usage quickly.
|
||||
|
||||
### How do I install it?
|
||||
|
||||
Run `npx antigravity-awesome-skills` for the default full-library install, or use a tool-specific flag such as `--codex`, `--cursor`, `--gemini`, `--claude`, or `--antigravity` when you want the installer to target a known skills directory directly.
|
||||
|
||||
### Should I use the full library or a plugin?
|
||||
|
||||
Use the full library if you want the biggest catalog and direct filesystem control. Use plugins when you want a marketplace-style, plugin-safe distribution for Claude Code or Codex. The complete explanation lives in [Plugins for Claude Code and Codex](docs/users/plugins.md).
|
||||
|
||||
### Where do I browse bundles, workflows, and the full catalog?
|
||||
|
||||
Start with [Bundles](docs/users/bundles.md) for role-based recommendations, [Workflows](docs/users/workflows.md) for ordered execution playbooks, [CATALOG.md](CATALOG.md) for the full registry, and the hosted [GitHub Pages catalog](https://sickn33.github.io/antigravity-awesome-skills/) when you want a browsable web UI.
|
||||
|
||||
## Best Skills By Tool
|
||||
|
||||
If you want a faster answer than "browse all 1,340+ skills", start with a tool-specific guide:
|
||||
@@ -269,70 +135,18 @@ If you want a faster answer than "browse all 1,340+ skills", start with a tool-s
|
||||
- **[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.
|
||||
|
||||
- Runtime hardening now protects the `/api/refresh-skills` mutation flow (method/host checks and optional token gate) before any repo mutation.
|
||||
- The published GitHub Pages catalog runs in static public-catalog mode, so the maintainer-only `/api/refresh-skills` flow is hidden in production unless you are using the local Vite dev server with the explicit sync flag.
|
||||
- Skill saves in the web UI are intentionally browser-local today. Optional Supabase configuration is read-only and should not be treated as a shared write path or authoritative leaderboard.
|
||||
- Markdown rendering in the web app avoids raw HTML passthrough (`rehype-raw`) and follows safer defaults for skill content display.
|
||||
- A repo-wide `SKILL.md` security scan checks for high-risk command patterns (for example `curl|bash`, `wget|sh`, `irm|iex`, command-line token examples) with explicit allowlisting for deliberate exceptions.
|
||||
- Pull requests that touch `SKILL.md` files now also run an automated `skill-review` GitHub Actions check, so contributors and maintainers get a second pass focused on skill structure and review quality.
|
||||
- Maintainer-facing tooling has additional path/symlink checks and parser robustness guards for safer sync, index, and install operations.
|
||||
- Security test coverage for endpoint authorization, rendering safety, and doc-risk patterns is part of the normal CI/release validation flow.
|
||||
|
||||
---
|
||||
|
||||
## What This Repo Includes
|
||||
|
||||
- **Skills library**: `skills/` contains the reusable `SKILL.md` collection.
|
||||
- **Installer**: the npm CLI installs skills into the right directory for each tool.
|
||||
- **Catalog**: [`CATALOG.md`](CATALOG.md), `skills_index.json`, and `data/` provide generated indexes.
|
||||
- **Web app**: [`apps/web-app`](apps/web-app) gives you search, filters, rendering, and copy helpers.
|
||||
- **Bundles**: [`docs/users/bundles.md`](docs/users/bundles.md) groups starter skills by role.
|
||||
- **Workflows**: [`docs/users/workflows.md`](docs/users/workflows.md) gives step-by-step execution playbooks.
|
||||
|
||||
## Project Structure
|
||||
|
||||
| Path | Purpose |
|
||||
| ---------------------- | --------------------------------------------------------- |
|
||||
| `skills/` | The canonical skill library |
|
||||
| `docs/users/` | Getting started, usage, bundles, workflows, visual guides |
|
||||
| `docs/contributors/` | Templates, anatomy, examples, quality bar, community docs |
|
||||
| `docs/maintainers/` | Release, audit, CI drift, metadata maintenance docs |
|
||||
| `docs/sources/` | Attribution and licensing references |
|
||||
| `apps/web-app/` | Interactive browser for the skill catalog |
|
||||
| `tools/` | Installer, validators, generators, and support scripts |
|
||||
| `data/` | Generated catalog, aliases, bundles, and workflows |
|
||||
|
||||
## Top Starter Skills
|
||||
### Universal starter skills
|
||||
|
||||
- `@brainstorming` for planning before implementation.
|
||||
- `@architecture` for system and component design.
|
||||
- `@test-driven-development` for TDD-oriented work.
|
||||
- `@doc-coauthoring` for structured documentation writing.
|
||||
- `@lint-and-validate` for lightweight quality checks.
|
||||
- `@create-pr` for packaging work into a clean pull request.
|
||||
- `@debugging-strategies` for systematic troubleshooting.
|
||||
- `@api-design-principles` for API shape and consistency.
|
||||
- `@frontend-design` for UI and interaction quality.
|
||||
- `@lint-and-validate` for lightweight quality checks.
|
||||
- `@security-auditor` for security-focused reviews.
|
||||
- `@frontend-design` for UI and interaction quality.
|
||||
- `@api-design-principles` for API shape and consistency.
|
||||
- `@create-pr` for packaging work into a clean pull request.
|
||||
|
||||
|
||||
### Community Contributed Skills
|
||||
|
||||
- [Overnight Worker](https://github.com/fullstackcrew-alpha/skill-overnight-worker) - Autonomous overnight work agent. Assign tasks before sleep, get structured results by morning.
|
||||
- [Cost Optimizer](https://github.com/fullstackcrew-alpha/skill-cost-optimizer) - Save 60-80% on AI token costs with smart model routing, context compression, and heartbeat tuning.
|
||||
- [DevOps Agent](https://github.com/fullstackcrew-alpha/skill-devops-agent) - One-click deploy, monitoring setup, scheduled backups, fault diagnosis with safety-first design.
|
||||
- [CN Content Matrix](https://github.com/fullstackcrew-alpha/skill-cn-content-matrix) - Chinese multi-platform content generator for Xiaohongshu, WeChat, Douyin, Bilibili with true style transfer.
|
||||
- [Smart PR Review](https://github.com/fullstackcrew-alpha/skill-smart-pr-review) - Opinionated AI code reviewer with 6-layer deep review, Devil's Advocate mode, MUST FIX/SHOULD FIX/SUGGESTION output.
|
||||
- [HubSpot Admin Skills](https://github.com/TomGranot/hubspot-admin-skills) - 32 Claude Code skills for auditing, cleaning, enriching, and automating HubSpot CRM. Includes Python scripts, Breeze AI workflow prompts, and a full audit → plan → execute → maintain flow.
|
||||
- [Tutor Skills](https://github.com/RoundTable02/tutor-skills) - Transform PDFs, docs, and codebases into Obsidian study vaults with interactive quiz-based learning and proficiency tracking.
|
||||
- [CoinPaprika & DexPaprika Skills](https://github.com/coinpaprika/skills) - Two crypto data skills: CoinPaprika (12K+ coins, 350+ exchanges, OHLCV, tickers) and DexPaprika (34 chains, 30M+ DEX pools, real-time streaming). Free, no API key. Install: `npx skills add github.com/coinpaprika/skills`
|
||||
- [SoulPass](https://github.com/soulpassai/soulpass-skill) - Hardware-secured Solana wallet, trading terminal, and agent identity layer with Jupiter swaps, meme coin trading, DeFi yield, trading bots, encrypted agent-to-agent messaging, and Apple Secure Enclave key storage.
|
||||
|
||||
## Three Real Examples
|
||||
### Real prompt examples
|
||||
|
||||
```text
|
||||
Use @brainstorming to turn this product idea into a concrete MVP plan.
|
||||
@@ -342,192 +156,79 @@ Use @brainstorming to turn this product idea into a concrete MVP plan.
|
||||
Use @security-auditor to review this API endpoint for auth and validation risks.
|
||||
```
|
||||
|
||||
## Curated Collections
|
||||
## Bundles & Workflows
|
||||
|
||||
**Bundles** are curated groups of skills for a specific role or goal (for example: `Web Wizard`, `Security Engineer`, `OSS Maintainer`).
|
||||
Bundles help you choose where to start. Workflows help you execute skills in the right order.
|
||||
|
||||
They help you avoid picking through the full catalog one by one.
|
||||
### Start with bundles
|
||||
|
||||
### ⚠️ Important: Bundles Are NOT Separate Installations!
|
||||
Bundles are curated groups of recommended skills for a role or goal such as `Web Wizard`, `Security Engineer`, or `OSS Maintainer`.
|
||||
|
||||
**Common confusion:** "Do I need to install each bundle separately?"
|
||||
- Bundles are recommendations, not separate installs.
|
||||
- Install the repository once, then use [docs/users/bundles.md](docs/users/bundles.md) to pick a starting set.
|
||||
- Good starter combinations:
|
||||
- SaaS MVP: `Essentials` + `Full-Stack Developer` + `QA & Testing`
|
||||
- Production hardening: `Security Developer` + `DevOps & Cloud` + `Observability & Monitoring`
|
||||
- OSS shipping: `Essentials` + `OSS Maintainer`
|
||||
|
||||
**Answer: NO!** Here's what bundles actually are:
|
||||
### Use workflows for outcome-driven execution
|
||||
|
||||
**What bundles ARE:**
|
||||
- Read [docs/users/workflows.md](docs/users/workflows.md) for human-readable playbooks.
|
||||
- Use [data/workflows.json](data/workflows.json) for machine-readable workflow metadata.
|
||||
- Initial workflows include shipping a SaaS MVP, security audits, AI agent systems, QA/browser automation, and DDD-oriented design work.
|
||||
|
||||
- ✅ Recommended skill lists organized by role
|
||||
- ✅ Curated starting points to help you decide what to use
|
||||
- ✅ Time-saving shortcuts for discovering relevant skills
|
||||
### Need fewer active skills at runtime?
|
||||
|
||||
**What bundles are NOT:**
|
||||
If Antigravity starts hitting context limits with too many active skills, the activation guidance in [docs/users/agent-overload-recovery.md](docs/users/agent-overload-recovery.md) can materialize only the bundles or skill ids you want in the live Antigravity directory.
|
||||
|
||||
- ❌ Separate installations or downloads
|
||||
- ❌ Different git commands
|
||||
- ❌ Something most users need to activate during normal install
|
||||
## Browse 1,340+ Skills
|
||||
|
||||
### How to use bundles:
|
||||
Use the root repo as a landing page, then jump into the deeper surface that matches your intent.
|
||||
|
||||
1. **Install the repository once** (you already have all skills)
|
||||
2. **Browse bundles** in [docs/users/bundles.md](docs/users/bundles.md) to find your role
|
||||
3. **Pick 3-5 skills** from that bundle to start using in your prompts
|
||||
4. **Reference them in your conversations** with your AI (e.g., "Use @brainstorming...")
|
||||
### What you get in this repository
|
||||
|
||||
If Antigravity starts hitting context limits with too many active skills, the optional activation scripts in [`docs/users/agent-overload-recovery.md`](docs/users/agent-overload-recovery.md) can materialize only the bundles or skill ids you want in the live Antigravity directory.
|
||||
- **Skills library** in [`skills/`](skills/)
|
||||
- **Installer CLI** powered by the npm package in [`package.json`](package.json)
|
||||
- **Generated catalog and metadata** in [`CATALOG.md`](CATALOG.md), `skills_index.json`, and [`data/`](data/)
|
||||
- **Hosted and local web app** in [`apps/web-app`](apps/web-app) and on [GitHub Pages](https://sickn33.github.io/antigravity-awesome-skills/)
|
||||
- **Role-based bundles** in [docs/users/bundles.md](docs/users/bundles.md)
|
||||
- **Execution workflows** in [docs/users/workflows.md](docs/users/workflows.md)
|
||||
- **User, contributor, and maintainer docs** under [`docs/`](docs/)
|
||||
|
||||
For detailed examples of how to actually use skills, see the [**Usage Guide**](docs/users/usage.md).
|
||||
### Best ways to explore
|
||||
|
||||
### Examples:
|
||||
- Read the full catalog in [`CATALOG.md`](CATALOG.md).
|
||||
- Browse the hosted catalog at [https://sickn33.github.io/antigravity-awesome-skills/](https://sickn33.github.io/antigravity-awesome-skills/).
|
||||
- Start with [Getting Started](docs/users/getting-started.md) and [Usage](docs/users/usage.md) if you are new after installation.
|
||||
- Use [Bundles](docs/users/bundles.md) for role-based discovery and [Workflows](docs/users/workflows.md) for step-by-step execution.
|
||||
- Use [Plugins for Claude Code and Codex](docs/users/plugins.md) when you care about marketplace-safe distribution.
|
||||
|
||||
- Building a SaaS MVP: `Essentials` + `Full-Stack Developer` + `QA & Testing`.
|
||||
- Hardening production: `Security Developer` + `DevOps & Cloud` + `Observability & Monitoring`.
|
||||
- Shipping OSS changes: `Essentials` + `OSS Maintainer`.
|
||||
|
||||
## Antigravity Workflows
|
||||
|
||||
Bundles help you choose skills. Workflows help you execute them in order.
|
||||
|
||||
- Use bundles when you need curated recommendations by role.
|
||||
- Use workflows when you need step-by-step execution for a concrete goal.
|
||||
|
||||
Start here:
|
||||
|
||||
- [docs/users/workflows.md](docs/users/workflows.md): human-readable playbooks.
|
||||
- [data/workflows.json](data/workflows.json): machine-readable workflow metadata.
|
||||
|
||||
Initial workflows include:
|
||||
|
||||
- Ship a SaaS MVP
|
||||
- Security Audit for a Web App
|
||||
- Build an AI Agent System
|
||||
- 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:
|
||||
### Compare alternatives
|
||||
|
||||
- **[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:
|
||||
|
||||
| Category | Focus | Example skills |
|
||||
| :------------- | :------------------------------------------------- | :------------------------------------------------------------------------------------ |
|
||||
| Architecture | System design, ADRs, C4, and scalable patterns | `architecture`, `c4-context`, `senior-architect` |
|
||||
| Business | Growth, pricing, CRO, SEO, and go-to-market | `copywriting`, `pricing-strategy`, `seo-audit` |
|
||||
| Data & AI | LLM apps, RAG, agents, observability, analytics | `rag-engineer`, `prompt-engineer`, `langgraph` |
|
||||
| Development | Language mastery, framework patterns, code quality | `typescript-expert`, `python-patterns`, `react-patterns` |
|
||||
| General | Planning, docs, product ops, writing, guidelines | `brainstorming`, `doc-coauthoring`, `writing-plans` |
|
||||
| Infrastructure | DevOps, cloud, serverless, deployment, CI/CD | `docker-expert`, `aws-serverless`, `vercel-deployment` |
|
||||
| Security | AppSec, pentesting, vuln analysis, compliance | `api-security-best-practices`, `sql-injection-testing`, `vulnerability-scanner` |
|
||||
| Testing | TDD, test design, fixes, QA workflows | `test-driven-development`, `testing-patterns`, `test-fixing` |
|
||||
| Workflow | Automation, orchestration, jobs, agents | `workflow-automation`, `inngest`, `trigger-dev` |
|
||||
|
||||
Counts change as new skills are added. For the current full registry, see [CATALOG.md](CATALOG.md).
|
||||
|
||||
## Browse 1,340+ Skills
|
||||
|
||||
- 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).
|
||||
|
||||
## Documentation
|
||||
|
||||
| For Users | For Contributors | For Maintainers |
|
||||
| --------------------------------------------------------------- | ------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------- |
|
||||
| [`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/plugins.md`](docs/users/plugins.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/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/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
|
||||
|
||||
### Windows install note
|
||||
Keep the root README short; use the dedicated docs for recovery and platform-specific guidance.
|
||||
|
||||
Use the normal install flow on Windows:
|
||||
- If you are confused after installation, start with the [Usage Guide](docs/users/usage.md).
|
||||
- For Windows truncation or context crash loops, use [docs/users/windows-truncation-recovery.md](docs/users/windows-truncation-recovery.md).
|
||||
- For Linux/macOS overload or selective activation, use [docs/users/agent-overload-recovery.md](docs/users/agent-overload-recovery.md).
|
||||
- For plugin install details, host compatibility, and marketplace-safe distribution, use [docs/users/plugins.md](docs/users/plugins.md).
|
||||
- For contributor expectations and guardrails, use [CONTRIBUTING.md](CONTRIBUTING.md), [`CODE_OF_CONDUCT.md`](CODE_OF_CONDUCT.md), and [`SECURITY.md`](SECURITY.md).
|
||||
|
||||
```bash
|
||||
git clone https://github.com/sickn33/antigravity-awesome-skills.git .agent/skills
|
||||
```
|
||||
## Support the Project
|
||||
|
||||
If you have an older clone created around the removed symlink workaround, reinstall into a fresh directory or rerun the `npx antigravity-awesome-skills` installer.
|
||||
Support is optional. The project stays free and open-source for everyone.
|
||||
|
||||
### Windows truncation or context crash loop
|
||||
- [Buy me a book on Buy Me a Coffee](https://buymeacoffee.com/sickn33)
|
||||
- Star the repository
|
||||
- Open reproducible issues
|
||||
- Contribute docs, fixes, and skills
|
||||
|
||||
If Antigravity or a Jetski/Cortex-based host keeps reopening into a truncation error, use the dedicated recovery guide:
|
||||
|
||||
- [`docs/users/windows-truncation-recovery.md`](docs/users/windows-truncation-recovery.md)
|
||||
|
||||
That guide includes:
|
||||
|
||||
- backup paths before cleanup
|
||||
- the storage folders that usually need to be cleared
|
||||
- an optional batch helper adapted from [issue #274](https://github.com/sickn33/antigravity-awesome-skills/issues/274)
|
||||
|
||||
### Linux and macOS agent overload
|
||||
|
||||
If Antigravity becomes unstable only when too many skills are active at once, use the cross-platform overload guide:
|
||||
|
||||
- [`docs/users/agent-overload-recovery.md`](docs/users/agent-overload-recovery.md)
|
||||
|
||||
### Fixing agent overload (activation scripts)
|
||||
|
||||
If your agent is struggling with context window limits due to too many loaded skills, use the activation scripts. They keep the full library in a separate archive folder and only activate the bundles or skills you need into the live Antigravity skills directory.
|
||||
|
||||
**Important Usage Instructions:**
|
||||
|
||||
1. **First, manually close the repository** (e.g., exit your AI agent or close your IDE).
|
||||
2. Open a terminal inside the folder where you cloned this repository (NOTE: repository has to be cloned).
|
||||
3. Run the script located in the `scripts` folder.
|
||||
|
||||
macOS/Linux examples:
|
||||
|
||||
```bash
|
||||
# Activate specific bundles
|
||||
./scripts/activate-skills.sh "Web Wizard" "Integration & APIs"
|
||||
|
||||
# Activate literal skill ids
|
||||
./scripts/activate-skills.sh brainstorming systematic-debugging
|
||||
|
||||
# Clear and reset (archives the live directory first)
|
||||
./scripts/activate-skills.sh --clear
|
||||
```
|
||||
|
||||
Windows examples:
|
||||
|
||||
```bat
|
||||
:: Activate specific bundles
|
||||
.\scripts\activate-skills.bat "Web Wizard" "Integration & APIs"
|
||||
|
||||
:: Clear and reset (removes all skills except the Essentials bundle)
|
||||
.\scripts\activate-skills.bat --clear
|
||||
```
|
||||
|
||||
## Web App
|
||||
|
||||
The web app is the fastest way to navigate a large repository like this.
|
||||
|
||||
**Run locally:**
|
||||
|
||||
```bash
|
||||
npm run app:install
|
||||
npm run app:dev
|
||||
```
|
||||
|
||||
That will copy the generated skill index into `apps/web-app/public/skills.json`, mirror the current `skills/` tree into `apps/web-app/public/skills/`, and start the Vite development server.
|
||||
|
||||
On the hosted GitHub Pages site, the same app runs as a static public catalog: dev-only sync controls stay hidden there, and save/star actions remain local to the browser.
|
||||
|
||||
**Hosted online:** The same app is available at [https://sickn33.github.io/antigravity-awesome-skills/](https://sickn33.github.io/antigravity-awesome-skills/) and is deployed automatically on every push to `main`. To enable it once: **Settings → Pages → Build and deployment → Source: GitHub Actions**.
|
||||
---
|
||||
|
||||
## Contributing
|
||||
|
||||
@@ -547,17 +248,6 @@ On the hosted GitHub Pages site, the same app runs as a static public catalog: d
|
||||
- [`CODE_OF_CONDUCT.md`](CODE_OF_CONDUCT.md) for community expectations and moderation standards.
|
||||
- [`SECURITY.md`](SECURITY.md) for security reporting.
|
||||
|
||||
## Support the Project
|
||||
|
||||
Support is optional. The project stays free and open-source for everyone.
|
||||
|
||||
- [Buy me a book on Buy Me a Coffee](https://buymeacoffee.com/sickn33)
|
||||
- Star the repository
|
||||
- Open reproducible issues
|
||||
- Contribute docs, fixes, and skills
|
||||
|
||||
---
|
||||
|
||||
## Credits & Sources
|
||||
|
||||
We stand on the shoulders of giants.
|
||||
@@ -793,14 +483,6 @@ We officially thank the following contributors for their help in making this rep
|
||||
- [@jamescha-earley](https://github.com/jamescha-earley)
|
||||
- [@qcwssss](https://github.com/qcwssss)
|
||||
|
||||
## License
|
||||
|
||||
Original code and tooling are licensed under the MIT License. See [LICENSE](LICENSE).
|
||||
|
||||
Original documentation and other non-code written content are licensed under [CC BY 4.0](LICENSE-CONTENT), unless a more specific upstream notice says otherwise. See [docs/sources/sources.md](docs/sources/sources.md) for attributions and third-party license details.
|
||||
|
||||
---
|
||||
|
||||
## Star History
|
||||
|
||||
[](https://star-history.com/sickn33/antigravity-awesome-skills)
|
||||
@@ -810,3 +492,11 @@ Original documentation and other non-code written content are licensed under [CC
|
||||
If Antigravity Awesome Skills has been useful, consider ⭐ starring the repo!
|
||||
|
||||
<!-- GitHub Topics (for maintainers): claude-code, gemini-cli, codex-cli, antigravity, cursor, github-copilot, opencode, agentic-skills, ai-coding, llm-tools, ai-agents, autonomous-coding, mcp, ai-developer-tools, ai-pair-programming, vibe-coding, skill, skills, SKILL.md, rules.md, CLAUDE.md, GEMINI.md, CURSOR.md -->
|
||||
|
||||
## License
|
||||
|
||||
Original code and tooling are licensed under the MIT License. See [LICENSE](LICENSE).
|
||||
|
||||
Original documentation and other non-code written content are licensed under [CC BY 4.0](LICENSE-CONTENT), unless a more specific upstream notice says otherwise. See [docs/sources/sources.md](docs/sources/sources.md) for attributions and third-party license details.
|
||||
|
||||
---
|
||||
|
||||
Reference in New Issue
Block a user