opencode-skills-antigravity 1.0.6 → 1.0.7

package/bundled-skills/docs/maintainers/release-process.md

@@ -17,6 +17,8 @@ This is the maintainer playbook for cutting a repository release. Historical rel
 npm run release:preflight
 ```
 
+This preflight now runs the deterministic `sync:release-state` flow, refreshes the tracked web assets in `apps/web-app/public`, executes the local test suite, runs the web-app build, and performs `npm pack --dry-run --json` so release tags are validated against the same artifact path used later in CI.
+
 2. Mandatory documentation hardening (repo-wide SKILL.md security scan):
 
 ```bash
@@ -71,6 +73,7 @@ npm publish
 ```
 
 Normally this still happens via the existing GitHub release workflow after the GitHub release is published.
+That workflow now reruns `sync:release-state`, refreshes tracked web assets, fails on canonical drift via `git diff --exit-code`, executes tests and docs security checks, builds the web app, and dry-runs the npm package before `npm publish`.
 
 ## Rollback Notes
 

package/bundled-skills/docs/users/faq.md

@@ -93,9 +93,16 @@ _Always check the Risk label and review the code._
 
 ### Where should I install the skills?
 
-The universal path that works with most tools is `.agent/skills/`.
+It depends on how you install:
 
-**Using npx:** `npx antigravity-awesome-skills` (or `npx github:sickn33/antigravity-awesome-skills` if you get a 404).
+- **Using the installer CLI (`npx antigravity-awesome-skills`)**:
+  The default install target is `~/.gemini/antigravity/skills/` for Antigravity's global library.
+- **Using a tool-specific flag**:
+  Use `--claude`, `--cursor`, `--gemini`, `--codex`, `--kiro`, or `--antigravity` to target the matching tool path automatically.
+- **Using a manual clone or custom workspace path**:
+  `.agent/skills/` is still a good universal workspace convention for Antigravity/custom setups.
+
+If you get a 404 from npm, use: `npx github:sickn33/antigravity-awesome-skills`
 
 **Using git clone:**
 
@@ -121,10 +128,10 @@ This repository now includes `.claude-plugin/marketplace.json` and `.claude-plug
 
 ### Does this work with Windows?
 
-**Yes.** Use the standard install flow:
+**Yes.** Use the same standard install flow as other platforms:
 
 ```bash
-git clone https://github.com/sickn33/antigravity-awesome-skills.git .agent/skills
+npx antigravity-awesome-skills
 ```
 
 If you have an older clone created around the removed symlink workaround, reinstall into a fresh directory or rerun `npx antigravity-awesome-skills`.
@@ -221,8 +228,10 @@ Include:
 The repository enforces automated quality control. Your skill might be missing:
 
 1. A valid `description`.
-2. Usage examples.
-   Run `npm run validate` locally to check before you push.
+2. Clear usage guidance or examples.
+3. The expected PR template checklist in the PR body.
+
+Run `npm run validate` locally before you push, and make sure you opened the PR with the default template so the Quality Bar checklist is present.
 
 ### My PR failed "security docs" check. What should I do?
 
@@ -254,6 +263,18 @@ Since v8.0.0, GitHub automatically runs a `skill-review` workflow on any PR that
 
 You do not need to close and reopen the PR. Informational or style-only findings do not block merging.
 
+### Do community PRs need generated files like `CATALOG.md` or `skills_index.json`?
+
+**No.** Community PRs should stay **source-only**.
+
+Do **not** include generated registry artifacts like:
+
+- `CATALOG.md`
+- `skills_index.json`
+- `data/*.json`
+
+Maintainers regenerate and canonicalize those files on `main` after merge. If you touch docs, workflows, or infra, run `npm run validate:references` and `npm test` locally instead.
+
 ### Can I update an "Official" skill?
 
 **No.** Official skills (in `skills/official/`) are mirrored from vendors. Open an issue instead.

package/bundled-skills/docs/users/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 1,304+ skill files** to your computer (default: `~/.gemini/antigravity/skills/`; or `~/.agent/skills/` if you used `--path`)  
+✅ **Downloaded 1,304+ skill files** to your computer (default: `~/.gemini/antigravity/skills/`; or a custom path like `~/.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)
 
@@ -310,7 +310,7 @@ AI: [Creates tests, sets up CI/CD, deploys to Vercel]
 Yes! Three ways:
 
 1. Browse [CATALOG.md](../../CATALOG.md) (searchable list)
-2. Run `ls ~/.agent/skills/` (if installed there)
+2. Run `ls ~/.gemini/antigravity/skills/` (or your actual install path)
 3. Ask your AI: "What skills do you have for [topic]?"
 
 ### "Do I need to restart my IDE after installing?"
@@ -344,7 +344,7 @@ Use @skill-creator to help me build a custom skill for [your task]
 
 ### "What if a skill doesn't work as expected?"
 
-1. Check the skill's SKILL.md file directly: `~/.agent/skills/[skill-name]/SKILL.md`
+1. Check the skill's `SKILL.md` file directly in your installed path, for example: `~/.gemini/antigravity/skills/[skill-name]/SKILL.md`
 2. Read the description to ensure you're using it correctly
 3. [Open an issue](https://github.com/sickn33/antigravity-awesome-skills/issues) with details
 

package/bundled-skills/docs/users/visual-guide.md

@@ -70,7 +70,7 @@ antigravity-awesome-skills/
 
 ```
 ┌──────────────┐
-│ 1. INSTALL   │  Copy skills to .agent/skills/
+│ 1. INSTALL   │  Run npx installer or clone to your tool path
 └──────┬───────┘
        │
        ↓
@@ -178,31 +178,30 @@ antigravity-awesome-skills/
 
 ## Installation (Visual Steps)
 
-### Step 1: Clone the Repository
+### Step 1: Install the Repository
 ```
 ┌─────────────────────────────────────────┐
 │ Terminal                                │
 ├─────────────────────────────────────────┤
-│ $ git clone https://github.com/        │
-│   sickn33/antigravity-awesome-skills    │
-│   .agent/skills                         │
+│ $ npx antigravity-awesome-skills        │
 │                                         │
-│ ✓ Cloning into '.agent/skills'...      │
-│ ✓ Done!                                 │
+│ ✓ Installing to                         │
+│   ~/.gemini/antigravity/skills/         │
 └─────────────────────────────────────────┘
 ```
 
+If you want a workspace-style manual install instead, cloning into `.agent/skills/` is still a valid custom path for Antigravity.
+
 ### Step 2: Verify Installation
 ```
 ┌─────────────────────────────────────────┐
 │ File Explorer                           │
 ├─────────────────────────────────────────┤
-│ 📁 .agent/                              │
-│   └── 📁 skills/                        │
-│       ├── 📁 brainstorming/             │
-│       ├── 📁 stripe-integration/        │
-│       ├── 📁 react-best-practices/      │
-│       └── ... (1,304+ total)            │
+│ 📁 ~/.gemini/antigravity/skills/        │
+│   ├── 📁 brainstorming/                 │
+│   ├── 📁 stripe-integration/            │
+│   ├── 📁 react-best-practices/          │
+│   └── ... (1,304+ total)                │
 └─────────────────────────────────────────┘
 ```
 
@@ -311,7 +310,7 @@ Open skills_index.json → Search for keyword → Find skill path
        │
        ↓
 ┌──────────────┐
-│ 4. TEST      │  Copy to .agent/skills/
+│ 4. TEST      │  Copy to your tool's installed skills path
 └──────┬───────┘  Try: @docker-mastery
        │
        ↓
@@ -435,7 +434,7 @@ START HERE
 ├─────────────────────────────────────────────────────────────┤
 │                                                             │
 │  📥 INSTALL                                                 │
-│  git clone [repo] .agent/skills                             │
+│  npx antigravity-awesome-skills                             │
 │                                                             │
 │  🎯 USE                                                     │
 │  @skill-name [your request]                                 │
@@ -455,6 +454,7 @@ START HERE
 │                                                             │
 │  🆘 HELP                                                    │
 │  • docs/users/getting-started.md                            │
+│  • docs/users/faq.md                                        │
 │  • CONTRIBUTING.md                                          │
 │  • docs/contributors/skill-anatomy.md                       │
 │  • GitHub Issues - Ask questions                            │

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "opencode-skills-antigravity",
-  "version": "1.0.6",
+  "version": "1.0.7",
   "description": "OpenCode CLI plugin that automatically downloads and keeps Antigravity Awesome Skills up to date.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",