opencode-skills-antigravity 0.0.1

package/.github/workflows/publish.yml

@@ -0,0 +1,40 @@
+name: Publish to npm
+
+on:
+  workflow_run:
+    workflows: ["Create Release"]
+    types: [completed]
+  workflow_dispatch:
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    # Skip if triggered by workflow_run that did not succeed
+    if: ${{ github.event_name == 'workflow_dispatch' || github.event.workflow_run.conclusion == 'success' }}
+    permissions:
+      contents: read
+      id-token: write
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+        with:
+          ref: ${{ github.event.workflow_run.head_sha || github.sha }}
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+          registry-url: 'https://registry.npmjs.org'
+          cache: 'npm'
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Build TypeScript
+        run: npm run build
+
+      - name: Publish to npm
+        run: npm publish --provenance --access public
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}

package/.github/workflows/release.yml

@@ -0,0 +1,60 @@
+name: Create Release
+
+on:
+  workflow_dispatch:
+    inputs:
+      version:
+        description: 'Version bump type'
+        required: true
+        type: choice
+        options:
+          - patch
+          - minor
+          - major
+
+jobs:
+  release:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+        with:
+          token: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+          cache: 'npm'
+
+      - name: Configure git
+        run: |
+          git config user.name "github-actions[bot]"
+          git config user.email "github-actions[bot]@users.noreply.github.com"
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Bump version
+        id: bump
+        run: |
+          NEW_VERSION=$(npm version ${{ github.event.inputs.version }} --no-git-tag-version)
+          echo "new_version=$NEW_VERSION" >> $GITHUB_OUTPUT
+
+      - name: Commit and push
+        run: |
+          git add package.json package-lock.json
+          git commit -m "chore: bump version to ${{ steps.bump.outputs.new_version }}"
+          git tag ${{ steps.bump.outputs.new_version }}
+          git push origin main --tags
+
+      - name: Create GitHub Release
+        uses: softprops/action-gh-release@v2
+        with:
+          tag_name: ${{ steps.bump.outputs.new_version }}
+          name: ${{ steps.bump.outputs.new_version }}
+          generate_release_notes: true
+          make_latest: true

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Davide Ladisa
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,80 @@
+# opencode-skills-antigravity
+
+An [OpenCode CLI](https://opencode.ai/) plugin that automatically downloads and keeps the [Antigravity Awesome Skills](https://github.com/sickn33/antigravity-awesome-skills) repository up to date every time you start OpenCode.
+
+## ✨ How it works
+
+Every time OpenCode starts, this plugin runs silently in the background:
+
+- **First run:** clones the full `antigravity-awesome-skills` repo into `~/.config/opencode/skills/antigravity-awesome-skills`
+- **Subsequent runs:** runs `git pull origin main` to silently fetch any new skills
+- **Offline:** if no network is available, a warning is shown and OpenCode continues normally
+
+OpenCode will then automatically detect all skills inside that folder and make them available to the AI agent.
+
+You can then invoke any skill explicitly in your prompt:
+
+```bash
+opencode run @brainstorming help me plan a feature
+```
+
+Or simply describe what you want and OpenCode will pick the right skill automatically.
+
+## 🚀 Installation
+
+### 1. Add the plugin to your global OpenCode config
+
+Edit (or create) `~/.config/opencode/opencode.json`:
+
+```json
+{
+  "plugin": [
+    "opencode-skills-antigravity"
+  ]
+}
+```
+
+OpenCode will automatically download the npm package on next startup via Bun. No manual `npm install` required.
+
+### 2. Make sure `git` is installed
+
+The plugin uses `git clone` and `git pull` under the hood. Verify with:
+
+```bash
+git --version
+```
+
+## 📁 Skills location
+
+Skills are stored at:
+
+```
+~/.config/opencode/skills/antigravity-awesome-skills/
+```
+
+OpenCode scans this directory automatically at startup.
+
+## 🛠️ Development
+
+```bash
+git clone https://github.com/FrancoStino/opencode-skills-antigravity.git
+cd opencode-skills-antigravity
+npm install
+npm run build
+```
+
+### Test locally before publishing
+
+Add the local path directly to your `opencode.json` to test without publishing:
+
+```json
+{
+  "plugin": [
+    "/absolute/path/to/opencode-skills-antigravity/src/index.ts"
+  ]
+}
+```
+
+## 📄 License
+
+MIT © [Davide Ladisa](https://www.davideladisa.it/)

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+import type { Plugin } from "@opencode-ai/plugin";
+declare const AntigravityAutoUpdater: Plugin;
+export default AntigravityAutoUpdater;

package/dist/index.js

@@ -0,0 +1,29 @@
+import { exec } from "child_process";
+import { promisify } from "util";
+import path from "path";
+import os from "os";
+const execAsync = promisify(exec);
+const AntigravityAutoUpdater = async (_ctx) => {
+    // Run asynchronously in background to not block OpenCode startup
+    setTimeout(async () => {
+        try {
+            console.log("🔄 [Antigravity Plugin] Syncing Awesome Skills...");
+            // Resolve absolute path to OpenCode's config directory
+            // so it works regardless of the cwd when OpenCode is launched
+            const opencodeCfgDir = path.join(os.homedir(), ".config", "opencode");
+            const skillsPath = path.join(opencodeCfgDir, ".agents", "skills");
+            // --yes skips the interactive "Ok to proceed?" prompt from npx
+            const { stdout, stderr } = await execAsync(`npx --yes antigravity-awesome-skills --path "${skillsPath}"`);
+            if (stdout)
+                console.log("✅ [Antigravity Plugin]", stdout.trim());
+            if (stderr)
+                console.error("⚠️  [Antigravity Plugin]", stderr.trim());
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            console.error("⚠️  [Antigravity Plugin] Could not sync skills (offline?):", message);
+        }
+    }, 0);
+    return {};
+};
+export default AntigravityAutoUpdater;

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "opencode-skills-antigravity",
+  "version": "0.0.1",
+  "description": "OpenCode CLI plugin that automatically downloads and keeps Antigravity Awesome Skills up to date.",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/FrancoStino/opencode-skills-antigravity"
+  },
+  "homepage": "https://github.com/FrancoStino/opencode-skills-antigravity",
+  "bugs": {
+    "url": "https://github.com/FrancoStino/opencode-skills-antigravity/issues"
+  },
+  "scripts": {
+    "build": "tsc",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "opencode",
+    "opencode-plugin",
+    "antigravity",
+    "skills",
+    "ai",
+    "agent"
+  ],
+  "author": "Davide Ladisa <rawsar@gmail.com>",
+  "license": "MIT",
+  "dependencies": {
+    "@opencode-ai/plugin": "^1.0.0"
+  },
+  "devDependencies": {
+    "@opencode-ai/sdk": "^1.0.0",
+    "@types/bun": "latest",
+    "@types/node": "^20.0.0",
+    "typescript": "^5.0.0"
+  }
+}

package/src/index.ts

@@ -0,0 +1,37 @@
+import type { Plugin } from "@opencode-ai/plugin";
+import { exec } from "child_process";
+import { promisify } from "util";
+import path from "path";
+import os from "os";
+
+const execAsync = promisify(exec);
+
+const AntigravityAutoUpdater: Plugin = async (_ctx) => {
+  // Run asynchronously in background to not block OpenCode startup
+  setTimeout(async () => {
+    try {
+      console.log("🔄 [Antigravity Plugin] Syncing Awesome Skills...");
+
+      // Resolve absolute path to OpenCode's config directory
+      // so it works regardless of the cwd when OpenCode is launched
+      const opencodeCfgDir = path.join(os.homedir(), ".config", "opencode");
+      const skillsPath = path.join(opencodeCfgDir, ".agents", "skills");
+
+      // --yes skips the interactive "Ok to proceed?" prompt from npx
+      const { stdout, stderr } = await execAsync(
+        `npx --yes antigravity-awesome-skills --path "${skillsPath}"`
+      );
+
+      if (stdout) console.log("✅ [Antigravity Plugin]", stdout.trim());
+      if (stderr) console.error("⚠️  [Antigravity Plugin]", stderr.trim());
+
+    } catch (error: unknown) {
+      const message = error instanceof Error ? error.message : String(error);
+      console.error("⚠️  [Antigravity Plugin] Could not sync skills (offline?):", message);
+    }
+  }, 0);
+
+  return {};
+};
+
+export default AntigravityAutoUpdater;

package/tsconfig.json

@@ -0,0 +1,15 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "ESNext",
+    "moduleResolution": "bundler",
+    "outDir": "./dist",
+    "rootDir": "./src",
+    "declaration": true,
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true
+  },
+  "include": ["src/**/*"]
+}