opencode-skills-antigravity 0.0.9 → 1.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +140 -21
  2. package/package.json +1 -1
package/README.md CHANGED
@@ -1,31 +1,59 @@
1
+ <div align="center">
2
+
3
+ <img src="./docs/logo.svg" alt="OpenCode Skills Antigravity"/>
4
+
5
+ <br/>
6
+ <br/>
7
+ <br/>
8
+
9
+ [![npm version](https://img.shields.io/npm/v/opencode-skills-antigravity?style=for-the-badge&color=cb3837&label=npm)](https://www.npmjs.com/package/opencode-skills-antigravity)
10
+ [![npm downloads](https://img.shields.io/npm/dm/opencode-skills-antigravity?style=for-the-badge&color=orange)](https://www.npmjs.com/package/opencode-skills-antigravity)
11
+ [![license](https://img.shields.io/github/license/FrancoStino/opencode-skills-antigravity?style=for-the-badge&color=blue)](./LICENSE)
12
+
13
+ </div>
14
+
1
15
  # OpenCode Skills Antigravity
2
16
 
3
- An [OpenCode CLI](https://opencode.ai/) plugin that bundles and manages the [Antigravity Awesome Skills](https://github.com/sickn33/antigravity-awesome-skills) repository for instant use.
17
+ > An [OpenCode CLI](https://opencode.ai/) plugin that bundles and auto-syncs the [Antigravity Awesome Skills](https://github.com/sickn33/antigravity-awesome-skills) collection — delivered instantly, with zero network latency at startup.
4
18
 
5
- ## ✨ How it works
19
+ ---
6
20
 
7
- This plugin ensures you always have the latest skills without any network latency at startup.
21
+ ## Overview
8
22
 
9
- - **Automated Updates:** A GitHub Action checks for updates in the [Antigravity Awesome Skills](https://github.com/sickn33/antigravity-awesome-skills) repository every hour. If new skills are found, it automatically bundles them and publishes a new version of the NPM package.
10
- - **Instant Deployment:** When you start OpenCode, the plugin instantly copies the pre-bundled skills to your local machine. This process works perfectly offline and ensures zero network latency during startup.
23
+ **OpenCode Skills Antigravity** bridges the OpenCode CLI with the Antigravity Awesome Skills repository. Instead of fetching skills on every startup, this plugin ships with a pre-bundled snapshot that gets copied directly to your local machine the moment OpenCode launches.
11
24
 
12
- OpenCode automatically detects all skills and makes them available to the AI agent.
25
+ The result: skills are always fresh (synced hourly via GitHub Actions), always available (even offline), and always instant.
13
26
 
14
- You can then invoke any skill explicitly in your prompt:
27
+ ---
15
28
 
16
- ```bash
17
- opencode run /brainstorming help me plan a feature
18
- ```
29
+ ## How It Works
30
+
31
+ The plugin operates in two phases:
32
+
33
+ **1. Automated upstream sync (CI)**
34
+
35
+ A GitHub Actions workflow runs every hour, checking the [Antigravity Awesome Skills](https://github.com/sickn33/antigravity-awesome-skills) repository for changes. When new or updated skills are detected, the workflow:
36
+
37
+ - Re-bundles the skill files into `bundled-skills/`
38
+ - Bumps the package version (`patch`)
39
+ - Creates a tagged GitHub Release
40
+ - Publishes the new version to npm
41
+
42
+ **2. Local deployment (startup)**
19
43
 
20
- Skills are also available as `/` commands directly in the OpenCode chat (e.g., `/brainstorming`).
44
+ When OpenCode starts, the plugin runs and copies the pre-bundled skills from the npm package to:
21
45
 
22
- Or simply describe what you want and OpenCode will pick the right skill automatically.
46
+ ```
47
+ ~/.config/opencode/skills/
48
+ ```
23
49
 
24
- ## 🚀 Installation
50
+ No network calls, no latency, no failures. If the copy somehow fails, a silent fallback attempts to fetch via `npx antigravity-awesome-skills` in the background.
25
51
 
26
- ### Add the plugin to your global OpenCode config
52
+ ---
27
53
 
28
- Edit (or create) `~/.config/opencode/opencode.json`:
54
+ ## Installation
55
+
56
+ Add the plugin to your global OpenCode configuration file at `~/.config/opencode/opencode.json`:
29
57
 
30
58
  ```json
31
59
  {
@@ -35,19 +63,110 @@ Edit (or create) `~/.config/opencode/opencode.json`:
35
63
  }
36
64
  ```
37
65
 
38
- OpenCode will automatically download the npm package on next startup via Bun. No manual `npm install` required.
66
+ That's it. OpenCode will automatically download the npm package on next startup via Bun — no manual `npm install` needed.
67
+
68
+ ---
69
+
70
+ ## Usage
39
71
 
40
- ## 📁 Skills location
72
+ Once installed, all bundled skills are available in three ways:
41
73
 
42
- Skills are stored at:
74
+ **Explicit invocation via CLI:**
75
+ ```bash
76
+ opencode run /brainstorming help me plan a new feature
77
+ opencode run /refactor clean up this function
78
+ ```
43
79
 
80
+ **Slash commands in the OpenCode chat:**
44
81
  ```
45
- ~/.config/opencode/skills/
82
+ /brainstorming
83
+ /refactor
84
+ /document
85
+ ```
86
+
87
+ **Natural language — OpenCode picks the right skill automatically:**
88
+ ```
89
+ "Help me brainstorm ideas for a REST API design"
90
+ "Refactor this function to be more readable"
46
91
  ```
47
92
 
48
- OpenCode scans this directory automatically at startup.
93
+ ---
94
+
95
+ ## CI/CD Pipeline
96
+
97
+ The release pipeline is fully automated and self-contained:
98
+
99
+ ```
100
+ [Hourly Cron]
101
+ │
102
+ ▼
103
+ Auto-Sync Skills ──── no changes ───▶ (skip)
104
+ │
105
+ changes detected
106
+ │
107
+ ▼
108
+ Bump patch version + commit + tag
109
+ │
110
+ ▼
111
+ Create GitHub Release
112
+ │
113
+ ▼
114
+ Publish to npm
115
+ │
116
+ ▼
117
+ Sync main → develop
118
+ ```
119
+
120
+ Manual releases (minor/major/patch) can also be triggered via the **Create Release** workflow dispatch in the Actions tab.
121
+
122
+ ---
123
+
124
+ ## Project Structure
125
+
126
+ ```
127
+ opencode-skills-antigravity/
128
+ ├── src/
129
+ │ └── index.ts # Plugin entry point — copies bundled skills on startup
130
+ ├── bundled-skills/ # Pre-bundled skills snapshot (auto-updated by CI)
131
+ ├── dist/ # Compiled TypeScript output
132
+ ├── .github/
133
+ │ └── workflows/
134
+ │ ├── sync-skills.yml # Hourly skill sync + auto-publish
135
+ │ ├── release.yml # Manual version bump + GitHub Release
136
+ │ ├── publish.yml # npm publish on new release
137
+ │ └── merge-branch.yml # Keeps develop in sync with main
138
+ ├── package.json
139
+ └── tsconfig.json
140
+ ```
141
+
142
+ ---
143
+
144
+ ## Development
145
+
146
+ **Requirements:** Node.js ≥ 20, TypeScript ≥ 5
147
+
148
+ ```bash
149
+ # Install dependencies
150
+ npm install
151
+
152
+ # Build
153
+ npm run build
154
+
155
+ # Output is in dist/
156
+ ```
157
+
158
+ The plugin is written in TypeScript and compiled to ESNext with full type declarations. It targets ES2022 and uses ESM module resolution.
159
+
160
+ ---
161
+
162
+ ## Contributing
163
+
164
+ Issues and pull requests are welcome at [github.com/FrancoStino/opencode-skills-antigravity](https://github.com/FrancoStino/opencode-skills-antigravity/issues).
165
+
166
+ If you'd like to contribute new skills to the upstream collection, head over to [antigravity-awesome-skills](https://github.com/sickn33/antigravity-awesome-skills) — they'll be automatically picked up and bundled here within the hour.
49
167
 
168
+ ---
50
169
 
51
- ## 📄 License
170
+ ## License
52
171
 
53
172
  MIT © [Davide Ladisa](https://www.davideladisa.it/)
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "opencode-skills-antigravity",
3
- "version": "0.0.9",
3
+ "version": "1.0.0",
4
4
  "description": "OpenCode CLI plugin that automatically downloads and keeps Antigravity Awesome Skills up to date.",
5
5
  "main": "dist/index.js",
6
6
  "types": "dist/index.d.ts",