From 4935870c7dbe67e2808aafa43b629df44f5e88d4 Mon Sep 17 00:00:00 2001 From: sck_0 Date: Fri, 20 Feb 2026 22:10:34 +0100 Subject: [PATCH] =?UTF-8?q?docs:=20align=205.9.0=20release=20audit=20?= =?UTF-8?q?=E2=80=94=20default=20path,=20credits,=20skill=20count?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - README: default path ~/.gemini/antigravity/skills, Compatibility table, TIP, install/troubleshoot examples - USAGE.md: default path and 883+ skill count - CHANGELOG 5.9.0: 897→883 skills, @zack→@SebConejo (PR #103) Co-authored-by: Cursor --- CHANGELOG.md | 4 ++-- README.md | 43 +++++++++++++++++++++++++++++-------------- docs/USAGE.md | 6 +++--- 3 files changed, 34 insertions(+), 19 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index c4e678e4..6a1b988f 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -38,7 +38,7 @@ Walks through a 6-step setup for the Manifest observability platform, including ## 📦 Improvements -- **Registry Update**: Now tracking 897 skills. +- **Registry Update**: Now tracking 883 skills. - **CLI Installer**: Fixed the default `.agent/skills` path to properly default to `~/.gemini/antigravity/skills` and added an explicit `--antigravity` flag (fixes #101). - **Validation**: Enforced strict folder-to-name matching and concise (<200 char) descriptions based on `agentskills-ref` (fixes #97). - **Validation**: Added build-time Markdown dangling link validation to `validate_skills.py` to prevent agents from hallucinating relative paths (fixes #102). @@ -49,7 +49,7 @@ A huge shoutout to our community contributors: - **@raintree-technology** for the Apple HIG Skills (PR #90) - **@sergeyklay** for the skill quality validations (PR #97) -- **@zack** for the manifest observability skill (PR #103) +- **@SebConejo** for the manifest observability skill (PR #103) - **@community** for identifying installer and link bugs (Issues #101, #102) --- diff --git a/README.md b/README.md index 8cfb34c8..99fa44c9 100644 --- a/README.md +++ b/README.md @@ -53,11 +53,11 @@ This repository provides essential skills to transform your AI assistant into a ## New Here? Start Here! -**Welcome to the V5.4.0 Workflows Edition.** This isn't just a list of scripts; it's a complete operating system for your AI Agent. +**Welcome to the V5.9.0 Workflows Edition.** This isn't just a list of scripts; it's a complete operating system for your AI Agent. ### 1. 🐣 Context: What is this? -**Antigravity Awesome Skills** (Release 5.4.0) is a massive upgrade to your AI's capabilities. +**Antigravity Awesome Skills** (Release 5.9.0) is a massive upgrade to your AI's capabilities. 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. @@ -69,14 +69,14 @@ Install once; then use Starter Packs in [docs/BUNDLES.md](docs/BUNDLES.md) to fo 1. **Install**: ```bash - # Default path: ~/.agent/skills + # Default: ~/.gemini/antigravity/skills (Antigravity global). Use --path for other locations. npx antigravity-awesome-skills ``` 2. **Verify**: ```bash - test -d ~/.agent/skills && echo "Skills installed in ~/.agent/skills" + test -d ~/.gemini/antigravity/skills && echo "Skills installed in ~/.gemini/antigravity/skills" ``` 3. **Run your first skill**: @@ -110,14 +110,14 @@ These skills follow the universal **SKILL.md** format and work with any AI codin | **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/` | -| **Antigravity** | IDE | `(Agent Mode) Use skill...` | `.agent/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] -> **Universal Path**: We recommend cloning to `.agent/skills/`. Most modern tools (Antigravity, recent CLIs) look here by default. +> **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. > [!WARNING] @@ -133,9 +133,12 @@ To use these skills with **Claude Code**, **Gemini CLI**, **Codex CLI**, **Curso ### Option A: npx (recommended) ```bash -# Default: ~/.agent/skills (universal) +# Default: ~/.gemini/antigravity/skills (Antigravity global) npx antigravity-awesome-skills +# Antigravity (explicit; same as default) +npx antigravity-awesome-skills --antigravity + # Cursor npx antigravity-awesome-skills --cursor @@ -151,6 +154,9 @@ npx antigravity-awesome-skills --codex # OpenCode npx antigravity-awesome-skills --path .agents/skills +# Workspace-specific (e.g. .agent/skills for Antigravity workspace) +npx antigravity-awesome-skills --path ~/.agent/skills + # Custom path npx antigravity-awesome-skills --path ./my-skills ``` @@ -159,8 +165,13 @@ Run `npx antigravity-awesome-skills --help` for all options. If the directory al ### Option B: git clone +Without `--path`, the npx installer uses `~/.gemini/antigravity/skills`. For manual clone or a different path (e.g. workspace `.agent/skills`), use one of the following: + ```bash -# Universal (works with most tools) +# Antigravity global (matches npx default) +git clone https://github.com/sickn33/antigravity-awesome-skills.git ~/.gemini/antigravity/skills + +# Workspace-specific (e.g. .agent/skills in your project) git clone https://github.com/sickn33/antigravity-awesome-skills.git .agent/skills # Claude Code specific @@ -201,18 +212,22 @@ git clone -c core.symlinks=true https://github.com/sickn33/antigravity-awesome-s ### Skills installed but not detected by your tool -Install to the tool-specific path (for example `.claude/skills`, `.gemini/skills`, `.codex/skills`, `.cursor/skills`) or use the installer flags (`--claude`, `--gemini`, `--codex`, `--cursor`, `--path`). +Install to the tool-specific path. Use installer flags: `--antigravity` (default), `--claude`, `--gemini`, `--codex`, `--cursor`, or `--path ` for a custom location (e.g. `~/.agent/skills` for Antigravity workspace). ### Update an existing installation ```bash +# If you used the default installer (Antigravity global): +git -C ~/.gemini/antigravity/skills pull + +# If you installed to a custom path (e.g. ~/.agent/skills): git -C ~/.agent/skills pull ``` ### Reinstall from scratch ```bash -rm -rf ~/.agent/skills +rm -rf ~/.gemini/antigravity/skills npx antigravity-awesome-skills ``` @@ -222,7 +237,7 @@ npx antigravity-awesome-skills **Bundles** are curated groups of skills for a specific role or goal (for example: `Web Wizard`, `Security Engineer`, `OSS Maintainer`). -They help you avoid picking from 860+ skills one by one. +They help you avoid picking from 883+ skills one by one. ### ⚠️ Important: Bundles Are NOT Separate Installations! @@ -306,11 +321,11 @@ We welcome contributions from the community! To add a new skill: 1. **Fork** the repository. 2. **Create a new directory** inside `skills/` for your skill. -3. **Add a `SKILL.md`** with the required frontmatter (name and description). -4. **Run validation**: `python3 scripts/validate_skills.py`. +3. **Add a `SKILL.md`** with the required frontmatter (name, description, risk, source). See [docs/SKILL_ANATOMY.md](docs/SKILL_ANATOMY.md) and [docs/QUALITY_BAR.md](docs/QUALITY_BAR.md). +4. **Run validation**: `npm run validate` (or `npm run validate:strict` for CI). Optionally run `python3 scripts/validate_references.py` if you touch workflows or bundles. 5. **Submit a Pull Request**. -Please ensure your skill follows the Antigravity/Claude Code best practices. +Please ensure your skill follows the Antigravity/Claude Code best practices. Maintainers: see [docs/AUDIT.md](docs/AUDIT.md) for coherence checks and [.github/MAINTENANCE.md](.github/MAINTENANCE.md) for the full validation chain. --- diff --git a/docs/USAGE.md b/docs/USAGE.md index 1a6fab0d..feb16b14 100644 --- a/docs/USAGE.md +++ b/docs/USAGE.md @@ -12,7 +12,7 @@ Great question! Here's what just happened and what to do next: When you ran `npx antigravity-awesome-skills` or cloned the repository, you: -✅ **Downloaded 860+ skill files** to your computer (usually in `~/.agent/skills/`) +✅ **Downloaded 883+ skill files** to your computer (default: `~/.gemini/antigravity/skills/`; or `~/.agent/skills/` if you used `--path`) ✅ **Made them available** to your AI assistant ❌ **Did NOT enable them all automatically** (they're just sitting there, waiting) @@ -31,7 +31,7 @@ Think of it like installing a toolbox. You have all the tools now, but you need Bundles are **recommended lists** of skills grouped by role. They help you decide which skills to start using. **Analogy:** -- You installed a toolbox with 860 tools (✅ done) +- You installed a toolbox with 883+ tools (✅ done) - Bundles are like **labeled organizer trays** saying: "If you're a carpenter, start with these 10 tools" - You don't install bundles—you **pick skills from them** @@ -177,7 +177,7 @@ Let's actually use a skill right now. Follow these steps: ## 🗂️ Step 5: Picking Your First Skills (Practical Advice) -Don't try to use all 860 skills! Here's a sensible approach: +Don't try to use all 883+ skills! Here's a sensible approach: ### Start with "The Essentials" (5 skills, everyone needs these)