opencode-skills-collection 1.0.210 → 2.0.0-beta.2

package/README.md

@@ -14,42 +14,87 @@
 
 # OpenCode Skills Collection
 
-> 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.
+> An [OpenCode CLI](https://opencode.ai/) plugin that bundles and auto-syncs a universal collection of AI skills —
+> delivered instantly, with zero network latency at startup.
 
-> ⚠️ **Previously published as [`opencode-skills-antigravity`](https://www.npmjs.com/package/opencode-skills-antigravity)** — that package is now deprecated and points to this one.
+> ⚠️ **Previously published
+as [`opencode-skills-antigravity`](https://www.npmjs.com/package/opencode-skills-antigravity)** — that package is now
+> deprecated and points to this one.
 
 ---
 
 ## Overview
 
-**OpenCode Skills Collection** 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.
+**OpenCode Skills Collection** ships a pre-bundled snapshot of 800+ universal skills for the OpenCode CLI.
 
-The result: skills are always fresh (synced hourly via GitHub Actions), always available (even offline), and always instant.
+Instead of loading every skill into the AI context at startup — which would consume ~80k tokens and cause compaction
+loops — the plugin uses a **SkillPointer** architecture: skills are organized into categories inside a hidden vault and
+only loaded into context on demand.
 
 ---
 
 ## How It Works
 
-The plugin operates in two phases:
+The plugin operates in three phases:
 
-**1. Automated upstream sync (CI)**
+**1. Local deployment (startup)**
 
-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:
+When OpenCode starts, the plugin copies the pre-bundled skills from the npm package and runs the **SkillPointer pipeline
+**:
 
-- Re-bundles the skill files into `bundled-skills/`
-- Bumps the package version (`patch`)
-- Creates a tagged GitHub Release
-- Publishes the new version to npm
+```
+bundled-skills/ (npm package)
+        │
+        ▼
+~/.config/opencode/skills/          ← OpenCode reads this
+        │
+        └── SkillPointer pipeline
+              │
+              ├─ vault-manager     → moves 800+ raw skills to the vault
+              └─ pointer-generator → writes ~35 lightweight pointer files
+```
+
+**2. On-demand skill loading**
+
+Each pointer file tells the AI: *"there are N skills for this category in the vault — use `list_dir` / `view_file` to
+retrieve them when needed."*
+The full skill content is only injected into context when the AI actually needs it.
 
-**2. Local deployment (startup)**
+---
+
+## Disk Layout
 
-When OpenCode starts, the plugin runs and copies the pre-bundled skills from the npm package to:
+After the first startup, your `~/.config/opencode/` directory looks like this:
 
 ```
-~/.config/opencode/skills/
+~/.config/opencode/
+├── opencode.json
+├── skills/                          ← ~35 pointer folders (active, read by OpenCode)
+│   ├── backend-dev-category-pointer/
+│   │   └── SKILL.md
+│   ├── devops-category-pointer/
+│   │   └── SKILL.md
+│   └── ...
+└── skill-libraries/                 ← vault with all raw skills (hidden from startup context)
+    ├── backend-dev/
+    │   ├── laravel-expert/
+    │   │   └── SKILL.md
+    │   └── wordpress-core/
+    │       └── SKILL.md
+    ├── devops/
+    └── ...
 ```
 
-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.
+---
+
+## Context Usage
+
+|                      | Without SkillPointer | With SkillPointer   |
+|----------------------|----------------------|---------------------|
+| Folders in `skills/` | ~800                 | ~35                 |
+| Tokens at startup    | ~80,000              | ~255                |
+| Skills available     | All injected upfront | On-demand via vault |
+| Compaction loops     | ✗ frequent           | ✓ none              |
 
 ---
 
@@ -65,21 +110,24 @@ Add the plugin to your global OpenCode configuration file at `~/.config/opencode
 }
 ```
 
-That's it. OpenCode will automatically download the npm package on next startup via Bun — no manual `npm install` needed.
+That's it. OpenCode will automatically download the npm package on next startup via Bun — no manual `npm install`
+needed.
 
 ---
 
 ## Usage
 
-Once installed, all bundled skills are available in three ways:
+Once installed, all skills are available in three ways:
 
 **Explicit invocation via CLI:**
+
 ```bash
 opencode run /brainstorming help me plan a new feature
 opencode run /refactor clean up this function
 ```
 
 **Slash commands in the OpenCode chat:**
+
 ```
 /brainstorming
 /refactor
@@ -87,6 +135,7 @@ opencode run /refactor clean up this function
 ```
 
 **Natural language — OpenCode picks the right skill automatically:**
+
 ```
 "Help me brainstorm ideas for a REST API design"
 "Refactor this function to be more readable"
@@ -94,26 +143,6 @@ opencode run /refactor clean up this function
 
 ---
 
-## Project Structure
-
-```
-opencode-skills-collection/
-├── src/
-│   └── index.ts          # Plugin entry point — copies bundled skills on startup
-├── bundled-skills/        # Pre-bundled skills snapshot (auto-updated by CI)
-├── dist/                  # Compiled TypeScript output
-├── .github/
-│   └── workflows/
-│       ├── sync-skills.yml   # Hourly skill sync + auto-publish
-│       ├── release.yml       # Manual version bump + GitHub Release
-│       ├── publish.yml       # npm publish on new release
-│       └── merge-branch.yml  # Keeps develop in sync with main
-├── package.json
-└── tsconfig.json
-```
-
----
-
 ## Development
 
 **Requirements:** Node.js ≥ 20, TypeScript ≥ 5
@@ -128,7 +157,8 @@ npm run build
 # Output is in dist/
 ```
 
-The plugin is written in TypeScript and compiled to ESNext with full type declarations. It targets ES2022 and uses ESM module resolution.
+The plugin is written in TypeScript and compiled to ESNext with full type declarations. It targets ES2022 and uses ESM
+module resolution.
 
 ---
 
@@ -150,12 +180,30 @@ The old `opencode-skills-antigravity` package on npm is deprecated and re-export
 
 ## Contributing
 
-Issues and pull requests are welcome at [github.com/FrancoStino/opencode-skills-collection](https://github.com/FrancoStino/opencode-skills-collection/issues).
+Issues and pull requests are welcome
+at [github.com/FrancoStino/opencode-skills-collection](https://github.com/FrancoStino/opencode-skills-collection/issues).
 
-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.
+If you'd like to contribute new skills to the collection, open a PR adding a new folder inside `bundled-skills/` — it
+will be automatically picked up on next sync.
 
 ---
 
+## Beta Releases
+
+Beta versions are published from the `develop` branch for testing before official releases.
+
+### Installing Beta Versions
+
+To use the latest beta version, update your `~/.config/opencode/opencode.json`:
+
+```json
+{
+  "plugin": [
+    "opencode-skills-collection@beta"
+  ]
+}
+```
+
 ## License
 
-MIT © [Davide Ladisa](https://www.davideladisa.it/)
+[MIT ©](./LICENSE) 

package/bundled-skills/.antigravity-install-manifest.json

@@ -1,6 +1,6 @@
 {
   "schemaVersion": 1,
-  "updatedAt": "2026-04-09T09:09:48.777Z",
+  "updatedAt": "2026-04-08T09:03:21.581Z",
   "entries": [
     "00-andruia-consultant",
     "007",
@@ -1288,14 +1288,7 @@
     "typescript-advanced-types",
     "typescript-expert",
     "typescript-pro",
-    "ui-a11y",
-    "ui-component",
-    "ui-page",
-    "ui-pattern",
-    "ui-review",
-    "ui-setup",
     "ui-skills",
-    "ui-tokens",
     "ui-ux-designer",
     "ui-ux-pro-max",
     "ui-visual-validator",
@@ -1312,10 +1305,6 @@
     "using-neon",
     "using-superpowers",
     "uv-package-manager",
-    "ux-audit",
-    "ux-copy",
-    "ux-feedback",
-    "ux-flow",
     "ux-persuasion-engineer",
     "uxui-principles",
     "variant-analysis",

package/bundled-skills/docs/integrations/jetski-cortex.md

@@ -1,9 +1,9 @@
 ---
 title: Jetski/Cortex + Gemini Integration Guide
-description: "Use antigravity-awesome-skills with Jetski/Cortex without hitting context-window overflow with 1.392+ skills."
+description: "Use antigravity-awesome-skills with Jetski/Cortex without hitting context-window overflow with 1.381+ skills."
 ---
 
-# Jetski/Cortex + Gemini: safe integration with 1,1.392+ skills
+# Jetski/Cortex + Gemini: safe integration with 1,1.381+ skills
 
 This guide shows how to integrate the `antigravity-awesome-skills` repository with an agent based on **Jetski/Cortex + Gemini** (or similar frameworks) **without exceeding the model context window**.
 
@@ -23,7 +23,7 @@ Never do:
 - concatenate all `SKILL.md` content into a single system prompt;
 - re-inject the entire library for **every** request.
 
-With over 1,1.392 skills, this approach fills the context window before user messages are even added, causing truncation.
+With over 1,1.381 skills, this approach fills the context window before user messages are even added, causing truncation.
 
 ---
 

package/bundled-skills/docs/integrations/jetski-gemini-loader/README.md

@@ -20,7 +20,7 @@ This example shows one way to integrate **antigravity-awesome-skills** with a Je
 - How to enforce a **maximum number of skills per turn** via `maxSkillsPerTurn`.
 - How to choose whether to **truncate or error** when too many skills are requested via `overflowBehavior`.
 
-This pattern avoids context overflow when you have 1,392+ skills installed.
+This pattern avoids context overflow when you have 1,381+ skills installed.
 
 ---
 

package/bundled-skills/docs/maintainers/repo-growth-seo.md

@@ -6,7 +6,7 @@ This document keeps the repository's GitHub-facing discovery copy aligned with t
 
 Preferred positioning:
 
-> Installable GitHub library of 1,392+ agentic skills for Claude Code, Cursor, Codex CLI, Gemini CLI, Antigravity, and other AI coding assistants.
+> Installable GitHub library of 1,381+ agentic skills for Claude Code, Cursor, Codex CLI, Gemini CLI, Antigravity, and other AI coding assistants.
 
 Key framing:
 
@@ -20,7 +20,7 @@ Key framing:
 
 Preferred description:
 
-> Installable GitHub library of 1,392+ agentic skills for Claude Code, Cursor, Codex CLI, Gemini CLI, Antigravity, and more. Includes installer CLI, bundles, workflows, and official/community skill collections.
+> Installable GitHub library of 1,381+ agentic skills for Claude Code, Cursor, Codex CLI, Gemini CLI, Antigravity, and more. Includes installer CLI, bundles, workflows, and official/community skill collections.
 
 Preferred homepage:
 
@@ -28,7 +28,7 @@ Preferred homepage:
 
 Preferred social preview:
 
-- use a clean preview image that says `1,392+ Agentic Skills`;
+- use a clean preview image that says `1,381+ Agentic Skills`;
 - mention Claude Code, Cursor, Codex CLI, and Gemini CLI;
 - avoid dense text and tiny logos that disappear in social cards.
 

package/bundled-skills/docs/maintainers/skills-update-guide.md

@@ -69,7 +69,7 @@ For manual updates, you need:
 The update process refreshes:
 - Skills index (`skills_index.json`)
 - Web app skills data (`apps\web-app\public\skills.json`)
-- All 1,392+ skills from the skills directory
+- All 1,381+ skills from the skills directory
 
 ## When to Update
 

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

@@ -673,4 +673,4 @@ Found a skill that should be in a bundle? Or want to create a new bundle? [Open
 
 ---
 
-_Last updated: March 2026 | Total Skills: 1,392+ | Total Bundles: 37_
+_Last updated: March 2026 | Total Skills: 1,381+ | Total Bundles: 37_

package/bundled-skills/docs/users/claude-code-skills.md

@@ -12,7 +12,7 @@ Install the library into Claude Code, then invoke focused skills directly in the
 
 ## Why use this repo for Claude Code
 
-- It includes 1,392+ skills instead of a narrow single-domain starter pack.
+- It includes 1,381+ skills instead of a narrow single-domain starter pack.
 - It supports the standard `.claude/skills/` path and the Claude Code plugin marketplace flow.
 - It also ships generated bundle plugins so teams can install focused packs like `Essentials` or `Security Developer` from the marketplace metadata.
 - It includes onboarding docs, bundles, and workflows so new users do not need to guess where to begin.

package/bundled-skills/docs/users/gemini-cli-skills.md

@@ -12,7 +12,7 @@ Install into the Gemini skills path, then ask Gemini to apply one skill at a tim
 
 - It installs directly into the expected Gemini skills path.
 - It includes both core software engineering skills and deeper agent/LLM-oriented skills.
-- It helps new users get started with bundles and workflows rather than forcing a cold start from 1,392+ files.
+- It helps new users get started with bundles and workflows rather than forcing a cold start from 1,381+ files.
 - It is useful whether you want a broad internal skill library or a single repo to test many workflows quickly.
 
 ## Install Gemini CLI Skills

package/bundled-skills/docs/users/getting-started.md

@@ -1,4 +1,4 @@
-# Getting Started with Antigravity Awesome Skills (V9.10.0)
+# Getting Started with Antigravity Awesome Skills (V9.9.0)
 
 **New here? This guide will help you supercharge your AI Agent in 5 minutes.**
 

package/bundled-skills/docs/users/kiro-integration.md

@@ -18,7 +18,7 @@ Kiro is AWS's agentic AI IDE that combines:
 
 Kiro's agentic capabilities are enhanced by skills that provide:
 
-- **Domain expertise** across 1,392+ specialized areas
+- **Domain expertise** across 1,381+ specialized areas
 - **Best practices** from Anthropic, OpenAI, Google, Microsoft, and AWS
 - **Workflow automation** for common development tasks
 - **AWS-specific patterns** for serverless, infrastructure, and cloud architecture

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

@@ -14,7 +14,7 @@ If you came in through a **Claude Code** or **Codex** plugin instead of a full l
 
 When you ran `npx antigravity-awesome-skills` or cloned the repository, you:
 
-✅ **Downloaded 1,392+ skill files** to your computer (default: `~/.gemini/antigravity/skills/`; or a custom path like `~/.agent/skills/` if you used `--path`)  
+✅ **Downloaded 1,381+ 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)
 
@@ -34,7 +34,7 @@ Bundles are **curated groups** of skills organized by role. They help you decide
 
 **Analogy:**
 
-- You installed a toolbox with 1,392+ tools (✅ done)
+- You installed a toolbox with 1,381+ tools (✅ done)
 - Bundles are like **labeled organizer trays** saying: "If you're a carpenter, start with these 10 tools"
 - You can either **pick skills from the tray** or install that tray as a focused marketplace bundle plugin
 
@@ -212,7 +212,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 1,392+ skills at once. Here's a sensible approach:
+Don't try to use all 1,381+ skills at once. Here's a sensible approach:
 
 If you want a tool-specific starting point before choosing skills, use:
 
@@ -343,7 +343,7 @@ Usually no, but if your AI doesn't recognize a skill:
 
 ### "Can I load all skills into the model at once?"
 
-No. Even though you have 1,392+ skills installed locally, you should **not** concatenate every `SKILL.md` into a single system prompt or context block.
+No. Even though you have 1,381+ skills installed locally, you should **not** concatenate every `SKILL.md` into a single system prompt or context block.
 
 The intended pattern is:
 

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

@@ -34,7 +34,7 @@ antigravity-awesome-skills/
 ├── 📄 CONTRIBUTING.md                  ← Contributor workflow
 ├── 📄 CATALOG.md                       ← Full generated catalog
 │
-├── 📁 skills/                          ← 1,392+ skills live here
+├── 📁 skills/                          ← 1,381+ skills live here
 │   │
 │   ├── 📁 brainstorming/
 │   │   └── 📄 SKILL.md                 ← Skill definition
@@ -47,7 +47,7 @@ antigravity-awesome-skills/
 │   │   └── 📁 2d-games/
 │   │       └── 📄 SKILL.md             ← Nested skills also supported
 │   │
-│   └── ... (1,392+ total)
+│   └── ... (1,381+ total)
 │
 ├── 📁 apps/
 │   └── 📁 web-app/                     ← Interactive browser
@@ -100,7 +100,7 @@ antigravity-awesome-skills/
 
 ```
                     ┌─────────────────────────┐
-                    │  1,392+ SKILLS          │
+                    │  1,381+ SKILLS          │
                     └────────────┬────────────┘
                                  │
         ┌────────────────────────┼────────────────────────┐
@@ -201,7 +201,7 @@ If you want a workspace-style manual install instead, cloning into `.agent/skill
 │   ├── 📁 brainstorming/                 │
 │   ├── 📁 stripe-integration/            │
 │   ├── 📁 react-best-practices/          │
-│   └── ... (1,392+ total)                │
+│   └── ... (1,381+ total)                │
 └─────────────────────────────────────────┘
 ```
 

package/dist/constants/constants.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Shared constants used across the plugin.
+ */
+/** Suffix appended to every category pointer folder name. */
+export declare const POINTER_SUFFIX: "-category-pointer";
+/** Expected filename for every skill definition. */
+export declare const SKILL_FILENAME: "SKILL.md";
+/**
+ * Name of the vault directory that stores raw skills, co-located
+ * with the rest of OpenCode config under ~/.config/opencode/
+ */
+export declare const VAULT_DIR_NAME: "skill-libraries";
+/** Fallback category slug for skills not present in skills_index.json. */
+export declare const UNCATEGORIZED_CATEGORY: "uncategorized";

package/dist/constants/constants.js

@@ -0,0 +1,14 @@
+/**
+ * Shared constants used across the plugin.
+ */
+/** Suffix appended to every category pointer folder name. */
+export const POINTER_SUFFIX = "-category-pointer";
+/** Expected filename for every skill definition. */
+export const SKILL_FILENAME = "SKILL.md";
+/**
+ * Name of the vault directory that stores raw skills, co-located
+ * with the rest of OpenCode config under ~/.config/opencode/
+ */
+export const VAULT_DIR_NAME = "skill-libraries";
+/** Fallback category slug for skills not present in skills_index.json. */
+export const UNCATEGORIZED_CATEGORY = "uncategorized";

package/dist/index.d.ts

@@ -1,3 +1,13 @@
 import type { Plugin } from "@opencode-ai/plugin";
+/**
+ * OpenCode Skills Collection plugin.
+ *
+ * On every OpenCode startup:
+ * 1. Copies bundled skills directly into the vault
+ *    (~/.config/opencode/skill-libraries/) organised by category.
+ *    The active skills directory is never used as staging.
+ * 2. Generates lightweight category pointer SKILL.md files in
+ *    ~/.config/opencode/skills/ without touching user custom skills.
+ */
 declare const OpenCodeSkillsCollection: Plugin;
 export default OpenCodeSkillsCollection;

package/dist/index.js

@@ -1,71 +1,35 @@
-import fs from "fs";
-import path from "path";
 import os from "os";
+import path from "path";
 import { fileURLToPath } from "url";
-const LOG_FILE = path.join(os.homedir(), ".config", "opencode", "antigravity-debug.log");
-function log(msg) {
-    const line = `[${new Date().toISOString()}] ${msg}\n`;
-    try {
-        fs.appendFileSync(LOG_FILE, line);
-    }
-    catch (_) { }
-    process.stderr.write(line);
-}
-function copyDirContents(srcDir, destDir) {
-    fs.mkdirSync(destDir, { recursive: true });
-    for (const entry of fs.readdirSync(srcDir, { withFileTypes: true })) {
-        const srcEntry = path.join(srcDir, entry.name);
-        const destEntry = path.join(destDir, entry.name);
-        if (entry.isDirectory()) {
-            copyDirContents(srcEntry, destEntry);
-        }
-        else {
-            fs.copyFileSync(srcEntry, destEntry);
-        }
-    }
-}
+import { ensureDir } from "./utils/fs.utils.js";
+import { runSkillPointer } from "./skill-pointer/index.js";
+const ACTIVE_SKILLS_PATH_SEGMENTS = [".config", "opencode", "skills"];
 function resolveBundledSkillsPath() {
-    const fromFile = path.join(path.dirname(fileURLToPath(import.meta.url)), "..", "bundled-skills");
-    if (fs.existsSync(fromFile))
-        return fromFile;
-    let dir = path.dirname(fileURLToPath(import.meta.url));
-    for (let i = 0; i < 5; i++) {
-        const candidate = path.join(dir, "bundled-skills");
-        if (fs.existsSync(candidate))
-            return candidate;
-        const parent = path.dirname(dir);
-        if (parent === dir)
-            break;
-        dir = parent;
-    }
-    throw new Error(`bundled-skills not found. import.meta.url=${import.meta.url}`);
+    const __dirname = path.dirname(fileURLToPath(import.meta.url));
+    return path.join(__dirname, "..", "bundled-skills");
+}
+function resolveActiveSkillsDir() {
+    return path.join(os.homedir(), ...ACTIVE_SKILLS_PATH_SEGMENTS);
 }
+/**
+ * OpenCode Skills Collection plugin.
+ *
+ * On every OpenCode startup:
+ * 1. Copies bundled skills directly into the vault
+ *    (~/.config/opencode/skill-libraries/) organised by category.
+ *    The active skills directory is never used as staging.
+ * 2. Generates lightweight category pointer SKILL.md files in
+ *    ~/.config/opencode/skills/ without touching user custom skills.
+ */
 const OpenCodeSkillsCollection = async (_ctx) => {
-    log("plugin start");
     try {
         const bundledSkillsPath = resolveBundledSkillsPath();
-        const skillsPath = path.join(os.homedir(), ".config", "opencode", "skills");
-        log(`bundled-skills path: ${bundledSkillsPath}`);
-        log(`skills dest: ${skillsPath}`);
-        fs.mkdirSync(skillsPath, { recursive: true });
-        const entries = fs.readdirSync(bundledSkillsPath, { withFileTypes: true });
-        log(`entries in bundled-skills: ${entries.length}`);
-        let installed = 0;
-        for (const entry of entries) {
-            if (!entry.isDirectory())
-                continue;
-            if (entry.name.startsWith("."))
-                continue;
-            const src = path.join(bundledSkillsPath, entry.name);
-            if (!fs.existsSync(path.join(src, "SKILL.md")))
-                continue;
-            copyDirContents(src, path.join(skillsPath, entry.name));
-            installed++;
-        }
-        log(`done — installed ${installed} skills`);
+        const activeSkillsDir = resolveActiveSkillsDir();
+        ensureDir(activeSkillsDir);
+        runSkillPointer({ bundledSkillsPath, activeSkillsDir });
     }
-    catch (error) {
-        log(`ERROR: ${String(error)}`);
+    catch {
+        // Plugin errors must never crash OpenCode.
     }
     return {};
 };

package/dist/skill-pointer/index.d.ts

@@ -0,0 +1,23 @@
+export interface SkillPointerOptions {
+    /** Absolute path where OpenCode looks for active skills. */
+    activeSkillsDir: string;
+    /** Absolute path to the bundled-skills snapshot inside the npm package. */
+    bundledSkillsPath: string;
+    /**
+     * Absolute path of the hidden vault where raw skills are stored.
+     * Defaults to ~/.config/opencode/skill-libraries
+     */
+    vaultDir?: string;
+}
+/**
+ * Orchestrates the full SkillPointer pipeline:
+ *
+ * 1. Reads skills_index.json bundled alongside the skills snapshot.
+ * 2. Copies bundled skills directly into the vault, categorised by the index.
+ * 3. Generates pointer SKILL.md files in activeSkillsDir with full skill
+ *    listings so keyword searches (e.g. "laravel") resolve out of the box.
+ *
+ * The activeSkillsDir is never used as a staging area — user custom
+ * skills already present there are never moved or overwritten.
+ */
+export declare function runSkillPointer(options: SkillPointerOptions): void;

package/dist/skill-pointer/index.js

@@ -0,0 +1,28 @@
+import os from "os";
+import path from "path";
+import { VAULT_DIR_NAME } from "../constants/constants.js";
+import { ensureDir } from "../utils/fs.utils.js";
+import { generatePointers } from "./pointer-generator.js";
+import { installSkillsToVault, loadSkillsIndex } from "./vault-installer.js";
+function resolveDefaultVaultDir() {
+    return path.join(os.homedir(), ".config", "opencode", VAULT_DIR_NAME);
+}
+/**
+ * Orchestrates the full SkillPointer pipeline:
+ *
+ * 1. Reads skills_index.json bundled alongside the skills snapshot.
+ * 2. Copies bundled skills directly into the vault, categorised by the index.
+ * 3. Generates pointer SKILL.md files in activeSkillsDir with full skill
+ *    listings so keyword searches (e.g. "laravel") resolve out of the box.
+ *
+ * The activeSkillsDir is never used as a staging area — user custom
+ * skills already present there are never moved or overwritten.
+ */
+export function runSkillPointer(options) {
+    const vaultDir = options.vaultDir ?? resolveDefaultVaultDir();
+    ensureDir(options.activeSkillsDir);
+    ensureDir(vaultDir);
+    const index = loadSkillsIndex(options.bundledSkillsPath);
+    installSkillsToVault(options.bundledSkillsPath, vaultDir, index);
+    generatePointers(options.activeSkillsDir, vaultDir, index);
+}

package/dist/skill-pointer/pointer-generator.d.ts

@@ -0,0 +1,10 @@
+import type { SkillIndexEntry } from "./vault-installer.js";
+/**
+ * Scans every category directory in the vault and writes
+ * a lightweight pointer SKILL.md into the active skills directory.
+ *
+ * Each pointer includes the full list of skill names + descriptions
+ * so keyword searches (e.g. "laravel", "wordpress") resolve correctly
+ * via get_available_skills without loading every SKILL.md.
+ */
+export declare function generatePointers(activeSkillsDir: string, vaultDir: string, index?: SkillIndexEntry[]): void;