docs: align 5.9.0 release audit — default path, credits, skill count

- 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 <cursoragent@cursor.com>

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

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 <dir>` 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.
 
 ---
 

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)