acp-vscode 0.3.2 → 0.3.8

package/.github/workflows/ci.yml

@@ -17,5 +17,7 @@ jobs:
           node-version: '20'
       - name: Install dependencies
         run: npm ci
+      - name: Run linting
+        run: npm run lint
       - name: Run tests
         run: npm test

package/.github/workflows/release.yml

@@ -5,9 +5,9 @@ name: Release
 #   Then push the tag: `git push --follow-tags` (or `git push origin vX.Y.Z`).
 # - Alternatively, use a release manager like `semantic-release` to automate versioning and changelogs.
 # - This workflow runs when a tag matching `v*.*.*` is pushed. Ensure you create/tag using the v-prefixed semver format.
-# - Secrets required:
-#   - `NPM_TOKEN` (used for npm publish)
-#   - The default `GITHUB_TOKEN` is provided automatically by Actions for creating releases.
+# - This workflow uses Trusted Publishing (OIDC) for npm - no NPM_TOKEN secret needed!
+# - Provenance attestations are automatically generated when using trusted publishing.
+# - The default `GITHUB_TOKEN` is provided automatically by Actions for creating releases.
 
 on:
   push:
@@ -21,6 +21,8 @@ jobs:
     permissions:
       contents: write # needed to create a release
       packages: write # not strictly required for npm but useful if you use GitHub Packages
+      id-token: write  # Required for OIDC
+
     steps:
       # Fetch full history so tags and changelog generation work correctly
       - uses: actions/checkout@v4
@@ -29,15 +31,17 @@ jobs:
       - name: Use Node.js
         uses: actions/setup-node@v4
         with:
-          node-version: '20'
+          node-version: '22'
           registry-url: 'https://registry.npmjs.org'
+      - name: Upgrade npm for trusted publishing
+        run: npm install -g npm@latest
       - name: Install
         run: npm ci
+      - name: Run linting
+        run: npm run lint
       - name: Run tests
         run: npm test
       - name: Publish to npm
-        env:
-          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
         run: npm publish
       - name: Create GitHub Release
         # Create a GitHub Release for the pushed tag. Uses the git ref by default.

package/README.md

@@ -1,6 +1,6 @@
 # acp-vscode
 
-acp-vscode is a small CLI to fetch and install chatmodes, prompts and instructions from the GitHub "awesome-copilot" repository into your VS Code workspace or VS Code User profile.
+acp-vscode is a small CLI to fetch and install agents, prompts, instructions and skills from the GitHub "awesome-copilot" repository into your VS Code workspace or VS Code User profile.
 
 Install (when published):
 
@@ -14,9 +14,9 @@ Commands:
 - install <workspace|user> [names...]
   - target: `workspace` or `user`
   - names: optional list of ids or names to install (supports `repo:id` form)
-  - type: specify with the option `--type <type>` (prompts|chatmodes|instructions|all). For backwards compatibility you can still pass the type as the first positional name (e.g. `install workspace prompts p1 p2`). Note: the `install` command also accepts a deliberate typo alias `--referesh` (alias for `--refresh`) to preserve historical behavior.
+  - type: specify with the option `--type <type>` (prompts|agents|instructions|skills|chatmodes|all). Note: `chatmodes` is legacy/deprecated (use `agents` instead). For backwards compatibility you can still pass the type as the first positional name (e.g. `install workspace prompts p1 p2`). The `install` command also accepts a deliberate typo alias `--referesh` (alias for `--refresh`) to preserve historical behavior.
 - list [type]
-  - list items available. type can be `prompts`, `chatmodes`, `instructions`, or `all`
+  - list items available. type can be `prompts`, `agents`, `instructions`, `skills`, `chatmodes` (legacy), or `all`
 - search <query>
   - search across items
 - uninstall <workspace|user> <type> [names...]
@@ -92,7 +92,7 @@ Troubleshooting
 ---------------
 
 - Cache and stale index
-  - The CLI writes a disk cache at `./.acp-cache/index.json` (30 minute TTL). If you see stale results or want to force a fresh fetch, remove the cache file and retry:
+  - By default the CLI writes a disk cache under the user's home directory in `~/.acp/cache/index.json` (30 minute TTL). When running in development or tests the CLI preserves the old behavior and keeps the cache in the current working directory at `./.acp-cache/index.json` to avoid surprising local workflows. If you see stale results or want to force a fresh fetch, remove the cache file and retry:
 
 ```bash
 rm -rf .acp-cache
@@ -126,7 +126,9 @@ You can inject a full, pre-built index via the `ACP_INDEX_JSON` environment vari
 {
   "prompts": [{ "id": "p1", "name": "Prompt 1", "repo": "r1", "url": "https://..." }],
   "chatmodes": [],
-  "instructions": []
+  "agents": [],
+  "instructions": [],
+  "skills": []
 }
 ```
 
@@ -147,6 +149,17 @@ Example:
 
 When multiple repos contain files with the same `id`, the fetcher adds an `_conflicts` array to the returned index listing conflicted ids. Consumers will display items as `repo:id` when necessary to disambiguate.
 
+Local repo file (acp-repos.json)
+-------------------------------
+
+In addition to `ACP_REPOS_JSON` the CLI will look for a file named `acp-repos.json` in the `~/.acp` directory and use it to populate the upstream repo list if the environment variable is not set. This file should contain the same JSON array format as `ACP_REPOS_JSON` and is useful for per-user configuration without exporting environment variables. Precedence when building the repos list is:
+
+1. `ACP_REPOS_JSON` environment variable (highest priority)
+2. `~/.acp/acp-repos.json` file (if present)
+3. Built-in default repo (github/awesome-copilot)
+
+Note: when running in development or tests the CLI will attempt to read `acp-repos.json` from the current working directory instead of `~/.acp` to keep test fixtures and local development predictable.
+
 Dry-run:
 
 You can preview what would be installed without writing files using --dry-run:
@@ -168,8 +181,8 @@ Commands reference
 Short reference for each command, key options, and quick examples.
 
 - install <workspace|user> [names...]
-  - Description: Install prompts/chatmodes/instructions into a workspace or VS Code user profile.
-  - Options: `-t, --type <type>` (prompts|chatmodes|instructions|all), `--dry-run`, `--referesh` (alias for refresh), `--verbose`
+  - Description: Install prompts/agents/instructions/skills into a workspace or VS Code user profile.
+  - Options: `-t, --type <type>` (prompts|agents|instructions|skills|chatmodes|all; `chatmodes` is legacy/deprecated), `--dry-run`, `--referesh` (alias for refresh), `--verbose`
   - Examples:
     - Install all prompts into the current workspace:
       - `acp-vscode install workspace prompts`
@@ -177,10 +190,10 @@ Short reference for each command, key options, and quick examples.
       - `acp-vscode install user --type instructions "Instruction Name"`
 
 - list [type]
-  - Description: List available items. Type can be `prompts`, `chatmodes`, `instructions`, or `all` (default).
+  - Description: List available items. Type can be `prompts`, `agents`, `instructions`, `skills`, `chatmodes` (legacy), or `all` (default).
   - Options: `-r, --refresh` (clear caches and refetch), `-j, --json`, `--verbose`
   - Examples:
-    - `acp-vscode list chatmodes`
+    - `acp-vscode list agents`
     - `acp-vscode list --json`
 
 - search <query>

package/__tests__/commands-actions.test.js

@@ -1,6 +1,4 @@
 const cache = require('../src/cache');
-const fs = require('fs-extra');
-const path = require('path');
 
 function makeCli() {
   const cli = {

package/__tests__/install-command-multi.test.js

@@ -1,7 +1,6 @@
 const fs = require('fs-extra');
 const path = require('path');
 const os = require('os');
-const axios = require('axios');
 jest.mock('axios');
 
 let performInstall;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "acp-vscode",
-  "version": "0.3.2",
-  "description": "CLI to install GitHub Awesome Copilot chatmodes, prompts, and instructions into VS Code workspace or user profile",
+  "version": "0.3.8",
+  "description": "CLI to install GitHub Awesome Copilot agents, prompts, instructions, and skills into VS Code workspace or user profile",
   "bin": {
     "acp-vscode": "./bin/acp-vscode.js"
   },

package/scripts/release.sh

@@ -0,0 +1,89 @@
+#!/bin/bash
+
+# Release script for acp-vscode
+# Usage: ./scripts/release.sh <major|minor|patch>
+# Example: ./scripts/release.sh minor
+
+set -e
+
+# Colors for output
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+NC='\033[0m' # No Color
+
+# Validate input
+if [ $# -ne 1 ]; then
+    echo -e "${RED}Error: Release type required${NC}"
+    echo "Usage: ./scripts/release.sh <major|minor|patch>"
+    exit 1
+fi
+
+VERSION_TYPE=$1
+
+# Validate version type
+if [[ ! $VERSION_TYPE =~ ^(major|minor|patch)$ ]]; then
+    echo -e "${RED}Error: Invalid release type '${VERSION_TYPE}'${NC}"
+    echo "Valid options: major, minor, patch"
+    exit 1
+fi
+
+echo -e "${YELLOW}Starting release process...${NC}"
+
+# Check if working directory is clean
+if [ -n "$(git status --porcelain)" ]; then
+    echo -e "${RED}Error: Working directory is not clean (uncommitted or untracked changes)${NC}"
+    echo "Please commit or stash your changes before releasing."
+    git status --short
+    exit 1
+fi
+
+echo -e "${GREEN}✓ Working directory is clean${NC}"
+
+# Run tests
+echo -e "${YELLOW}Running tests...${NC}"
+npm test || {
+    echo -e "${RED}Error: Tests failed${NC}"
+    exit 1
+}
+echo -e "${GREEN}✓ Tests passed${NC}"
+
+# Run linting if available
+if node -p "require('./package.json').scripts?.lint" 2>/dev/null | grep -v "undefined" >/dev/null; then
+    echo -e "${YELLOW}Running lint...${NC}"
+    if npm run lint; then
+        echo -e "${GREEN}✓ Linting passed${NC}"
+    else
+        echo -e "${RED}Error: Linting failed${NC}"
+        exit 1
+    fi
+else
+    echo -e "${YELLOW}⚠ Linting not available (skipping)${NC}"
+fi
+
+# Display current version
+CURRENT_VERSION=$(node -p "require('./package.json').version")
+echo -e "${YELLOW}Current version: ${CURRENT_VERSION}${NC}"
+
+# Use npm version to bump version and create tag
+echo -e "${YELLOW}Bumping version (${VERSION_TYPE})...${NC}"
+npm version "$VERSION_TYPE"
+
+# Get the new version
+NEW_VERSION=$(node -p "require('./package.json').version")
+echo -e "${GREEN}✓ Version bumped to ${NEW_VERSION}${NC}"
+
+# Get the tag that was created
+TAG="v${NEW_VERSION}"
+
+# Push the tag to remote
+echo -e "${YELLOW}Pushing tag ${TAG} to remote...${NC}"
+git push --follow-tags || {
+    echo -e "${RED}Error: Failed to push tag${NC}"
+    echo "You may need to push manually with: git push --follow-tags"
+    exit 1
+}
+
+echo -e "${GREEN}✓ Tag pushed successfully${NC}"
+echo -e "${GREEN}Release complete! Tag ${TAG} has been pushed.${NC}"
+echo -e "${YELLOW}The GitHub Actions workflow will now build and publish the release.${NC}"

package/src/commands/install.js

@@ -1,5 +1,5 @@
 const prompts = require('prompts');
-const { fetchIndex, diskPaths } = require('../fetcher');
+const { fetchIndex, diskPaths, cacheExists } = require('../fetcher');
 const cache = require('../cache');
 const { installFiles } = require('../installer');
 const fs = require('fs-extra');
@@ -8,7 +8,7 @@ async function performInstall({ target, type, names, options, workspaceDir = pro
   // support shorthand: if first arg is a package name (not 'workspace'|'user'),
   // treat it as package-mode and default target to 'workspace'.
   const key = 'index';
-  const TYPES = ['prompts','chatmodes','instructions','all'];
+  const TYPES = ['prompts','chatmodes','agents','instructions','skills','all'];
   const isTargetValid = (target === 'workspace' || target === 'user');
   let packageMode = false;
   if (!isTargetValid) {
@@ -40,6 +40,13 @@ async function performInstall({ target, type, names, options, workspaceDir = pro
   let index = cache.get(key);
   if (!index) {
     try {
+      // Check if disk cache exists to determine if this is a fresh fetch
+      const diskCacheExists = await cacheExists();
+      
+      if (!diskCacheExists && !doRefresh) {
+        console.log('Updating cache for the first time... (use --refresh/--referesh to force refresh)');
+      }
+      
       index = await fetchIndex();
       cache.set(key, index);
     } catch (err) {
@@ -48,7 +55,7 @@ async function performInstall({ target, type, names, options, workspaceDir = pro
     }
   }
 
-  const types = (type === 'all' || !type) ? ['prompts','chatmodes','instructions'] : [type];
+  const types = (type === 'all' || !type) ? ['prompts','chatmodes','agents','instructions','skills'] : [type];
   let anyFound = false;
   const missingNames = new Set();
   // If multiple types are being considered and names provided, resolve names across types
@@ -219,8 +226,8 @@ async function performInstall({ target, type, names, options, workspaceDir = pro
       continue;
     }
 
-  // If no specific names requested and the type is chatmodes, prompts, or instructions, confirm installing all
-  if ((!names || names.length === 0) && (t === 'chatmodes' || t === 'prompts' || t === 'instructions')) {
+  // If no specific names requested and the type is chatmodes, agents, prompts, instructions or skills, confirm installing all
+  if ((!names || names.length === 0) && (t === 'chatmodes' || t === 'agents' || t === 'prompts' || t === 'instructions' || t === 'skills')) {
       // When running non-interactively (no TTY), auto-confirm so CI/tests proceed
       const nonInteractive = !(process.stdin && process.stdin.isTTY);
       if (!nonInteractive) {
@@ -252,15 +259,15 @@ async function performInstall({ target, type, names, options, workspaceDir = pro
 function installCommand(cli) {
   // Change signature so that names are variadic and type is provided via option to
   // avoid the ambiguity where the second positional arg would be parsed as `type`.
-  cli.command('install <target> [names...]', 'Install items into workspace or user profile. target: workspace|user. type: prompts|chatmodes|instructions|all')
-  .option('-t, --type <type>', 'Specify type: prompts|chatmodes|instructions|all')
+  cli.command('install <target> [names...]', 'Install items into workspace or user profile. target: workspace|user. type: prompts|chatmodes|agents|instructions|skills|all')
+  .option('-t, --type <type>', 'Specify type: prompts|chatmodes|agents|instructions|skills|all')
   // Note: --refresh is intentionally not a per-command option for install; use only with list/search
   .option('--referesh', "Alias for --refresh (typo alias)")
     .option('--dry-run', 'Show what would be installed without writing files')
     .action(async (target, names, options) => {
       // names may be undefined or an array. Support legacy positional type in case
       // the user still passed it as the first name (e.g. `install workspace prompts p1`).
-      const TYPES = ['prompts','chatmodes','instructions','all'];
+      const TYPES = ['prompts','chatmodes','agents','instructions','skills','all'];
       let type = options.type;
       // Normalize names to an array. Some CLI parsers may provide a single
       // name as a string instead of a one-element array. Preserve values.

package/src/commands/list.js

@@ -1,4 +1,4 @@
-const { fetchIndex, diskPaths } = require('../fetcher');
+const { fetchIndex, diskPaths, cacheExists } = require('../fetcher');
 const cache = require('../cache');
 const fs = require('fs-extra');
 
@@ -18,14 +18,20 @@ function formatItems(index, filter) {
   if (!filter || filter === 'all' || filter === 'chatmodes') {
     if (index.chatmodes) out.push(...index.chatmodes.map(c => ({ type: 'chatmode', id: displayId(c), name: c.name })));
   }
+  if (!filter || filter === 'all' || filter === 'agents') {
+    if (index.agents) out.push(...index.agents.map(a => ({ type: 'agent', id: displayId(a), name: a.name })));
+  }
   if (!filter || filter === 'all' || filter === 'instructions') {
     if (index.instructions) out.push(...index.instructions.map(i => ({ type: 'instruction', id: displayId(i), name: i.name })));
   }
+  if (!filter || filter === 'all' || filter === 'skills') {
+    if (index.skills) out.push(...index.skills.map(s => ({ type: 'skill', id: displayId(s), name: s.name })));
+  }
   return out;
 }
 
 function listCommand(cli) {
-  cli.command('list [type]', 'List available items (prompts, chatmodes, instructions, all)')
+  cli.command('list [type]', 'List available items (prompts, chatmodes, agents, instructions, skills, all)')
     .option('-r, --refresh', 'Clear caches and force refresh from remote')
     .option('-j, --json', 'Emit machine-readable JSON output')
     .action(async (type, options) => {
@@ -52,6 +58,13 @@ function listCommand(cli) {
       let index = cache.get(key);
       if (!index) {
         try {
+          // Check if disk cache exists to determine if this is a fresh fetch
+          const diskCacheExists = await cacheExists();
+          
+          if (!diskCacheExists && !options.refresh) {
+            console.log('Updating cache for the first time... (use -r to force refresh)');
+          }
+          
           index = await fetchIndex();
           cache.set(key, index);
         } catch (err) {

package/src/commands/search.js

@@ -1,10 +1,10 @@
-const { fetchIndex, diskPaths } = require('../fetcher');
+const { fetchIndex, diskPaths, cacheExists } = require('../fetcher');
 const cache = require('../cache');
 const fs = require('fs-extra');
 const { formatListLines, visibleLines } = require('./list');
 
 function searchCommand(cli) {
-  cli.command('search <query>', 'Search prompts, chatmodes, instructions')
+  cli.command('search <query>', 'Search prompts, chatmodes, agents, instructions, skills')
     .option('-r, --refresh', 'Clear caches and force refresh from remote')
     .option('-j, --json', 'Emit machine-readable JSON output')
     .action(async (query, options) => {
@@ -27,6 +27,13 @@ function searchCommand(cli) {
       let index = cache.get(key);
       if (!index) {
         try {
+          // Check if disk cache exists to determine if this is a fresh fetch
+          const diskCacheExists = await cacheExists();
+          
+          if (!diskCacheExists && !options.refresh) {
+            console.log('Updating cache for the first time... (use -r to force refresh)');
+          }
+          
           index = await fetchIndex();
           cache.set(key, index);
         } catch (err) {
@@ -37,7 +44,7 @@ function searchCommand(cli) {
       }
       const q = query.toLowerCase();
       const results = [];
-      ['prompts','chatmodes','instructions'].forEach(cat => {
+      ['prompts','chatmodes','agents','instructions','skills'].forEach(cat => {
         const arr = index[cat] || [];
         arr.forEach(item => {
           const name = (item.name || item.id || '').toLowerCase();
@@ -66,7 +73,7 @@ function searchCommand(cli) {
 function searchIndex(index, query) {
   const q = query.toLowerCase();
   const results = [];
-  ['prompts','chatmodes','instructions'].forEach(cat => {
+  ['prompts','chatmodes','agents','instructions','skills'].forEach(cat => {
     const arr = index[cat] || [];
     arr.forEach(item => {
       const name = (item.name || item.id || '').toLowerCase();

package/src/commands/uninstall.js

@@ -1,7 +1,4 @@
 const prompts = require('prompts');
-const cache = require('../cache');
-const { fetchIndex, diskPaths } = require('../fetcher');
-const fs = require('fs-extra');
 const { removeFiles } = require('../installer');
 
 function uninstallCommand(cli) {
@@ -11,22 +8,6 @@ function uninstallCommand(cli) {
     .action(async (target, type, names, options) => {
       const workspaceDir = process.cwd();
       if (options && options.verbose) console.log('verbose: starting uninstall', { target, type, names });
-      const key = 'index';
-      if (options && options.refresh) {
-        if (options && options.verbose) console.log('verbose: refresh requested - clearing caches');
-        try { cache.del(key); } catch (e) { if (options && options.verbose) console.log('verbose: failed to clear in-memory cache', e.message); }
-        try { const { DISK_CACHE_FILE } = diskPaths(); if (fs.existsSync(DISK_CACHE_FILE)) fs.removeSync(DISK_CACHE_FILE); } catch (e) { if (options && options.verbose) console.log('verbose: failed to remove disk cache', e.message); }
-      }
-      let index = cache.get(key);
-      if (!index) {
-        try {
-          index = await fetchIndex();
-          cache.set(key, index);
-        } catch (err) {
-          console.error('Error fetching index:', err.message);
-          return process.exitCode = 2;
-        }
-      }
 
       const toRemove = names && names.length > 0 ? names : [];
       if (toRemove.length === 0) {

package/src/fetcher.js

@@ -1,8 +1,18 @@
 const axios = require('axios');
 const path = require('path');
 const fs = require('fs-extra');
+const os = require('os');
 const cache = require('./cache');
 
+// Helper to consistently decide where to store user-level data. In
+// development and test environments prefer process.cwd() for predictable
+// local workflows; otherwise use the user's homedir under ~/.acp.
+function getBaseDir() {
+  return (process.env.NODE_ENV === 'development' || process.env.NODE_ENV === 'test')
+    ? process.cwd()
+    : path.join(os.homedir(), '.acp');
+}
+
 // Default single upstream repo for backwards compatibility
 const DEFAULT_REPOS = [
   {
@@ -13,7 +23,11 @@ const DEFAULT_REPOS = [
 ];
 
 function diskPaths() {
-  const DISK_CACHE_DIR = path.join(process.cwd(), '.acp-cache');
+  // In development and tests keep the old behavior (cwd) to avoid surprising
+  // local workflows and test expectations. Otherwise store cache under the
+  // user's home directory in ~/.acp/cache/index.json
+  const baseDir = getBaseDir();
+  const DISK_CACHE_DIR = path.join(baseDir, 'cache');
   const DISK_CACHE_FILE = path.join(DISK_CACHE_DIR, 'index.json');
   return { DISK_CACHE_DIR, DISK_CACHE_FILE };
 }
@@ -70,7 +84,7 @@ async function fetchIndex() {
     }
   }
 
-  // Build repos list from env or default
+  // Build repos list from env, file, or default
   let repos = DEFAULT_REPOS;
   if (process.env.ACP_REPOS_JSON) {
     try {
@@ -79,6 +93,18 @@ async function fetchIndex() {
     } catch (e) {
       // ignore malformed env var and fall back to defaults
     }
+  } else {
+    // Try reading acp-repos.json from the user acp dir. Respect NODE_ENV handling
+      try {
+      const baseDir = getBaseDir();
+      const repoFile = path.join(baseDir, 'acp-repos.json');
+      if (await fs.pathExists(repoFile)) {
+        const fileContents = await fs.readJson(repoFile);
+        if (Array.isArray(fileContents) && fileContents.length > 0) repos = fileContents;
+      }
+    } catch (e) {
+      // ignore file read/parse errors and fall back to defaults
+    }
   }
 
   // Helper to parse frontmatter title from file content
@@ -98,7 +124,7 @@ async function fetchIndex() {
 
   // fetch each repo's tree and build combined index
   try {
-    const combined = { prompts: [], chatmodes: [], instructions: [] };
+    const combined = { prompts: [], chatmodes: [], agents: [], instructions: [], skills: [] };
     for (const repo of repos) {
       if (!repo || !repo.treeUrl) continue;
       let res = null;
@@ -112,9 +138,9 @@ async function fetchIndex() {
         continue;
       }
       if (!res || res.status !== 200 || !res.data) continue;
-      // If the remote returned a pre-built index object (prompts/chatmodes/instructions),
+      // If the remote returned a pre-built index object (prompts/chatmodes/agents/instructions/skills),
       // honor it and return immediately (backwards compatibility + tests).
-      if (!Array.isArray(res.data.tree) && (res.data.prompts || res.data.chatmodes || res.data.instructions)) {
+      if (!Array.isArray(res.data.tree) && (res.data.prompts || res.data.chatmodes || res.data.agents || res.data.instructions || res.data.skills)) {
         // Remote returned a pre-built index object. Return it unmodified for
         // backwards compatibility and tests which expect the exact shape.
         idx = res.data;
@@ -129,7 +155,7 @@ async function fetchIndex() {
         const matches = tree.filter(t => t.path.startsWith(`${prefix}/`));
         const parts = await Promise.all(matches.map(async t => {
           const file = path.basename(t.path);
-          const base = file.replace(/\.prompt\.md$|\.chatmode\.md$|\.instructions?\.md$/i, '').replace(/\.md$/i, '');
+          const base = file.replace(/\.prompt\.md$|\.chatmode\.md$|\.agent\.md$|\.instructions?\.md$/i, '').replace(/\.md$/i, '');
           const id = base;
           let name = base.replace(/[-_]+/g, ' ').replace(/\b\w/g, l => l.toUpperCase());
           const rawBase = (repo.rawBase || repo.url || '').replace(/\/$/, '');
@@ -150,12 +176,14 @@ async function fetchIndex() {
 
       combined.prompts.push(...(await makeEntriesForRepo('prompts')));
       combined.chatmodes.push(...(await makeEntriesForRepo('chatmodes')));
+      combined.agents.push(...(await makeEntriesForRepo('agents')));
       combined.instructions.push(...(await makeEntriesForRepo('instructions')));
+      combined.skills.push(...(await makeEntriesForRepo('skills')));
     }
 
     // detect id conflicts across repos
     const idCounts = new Map();
-    for (const cat of ['prompts','chatmodes','instructions']) {
+    for (const cat of ['prompts','chatmodes','agents','instructions','skills']) {
       for (const it of combined[cat]) {
         const k = it.id || it.name || '';
         if (!k) continue;
@@ -169,7 +197,7 @@ async function fetchIndex() {
 
   // If combined result is empty (no items found for any repo) and we have
   // a stale disk cache, prefer returning the disk payload as a fallback.
-  const totalItems = combined.prompts.length + combined.chatmodes.length + combined.instructions.length;
+  const totalItems = combined.prompts.length + combined.chatmodes.length + combined.agents.length + combined.instructions.length + combined.skills.length;
   if (totalItems === 0 && disk && disk.payload) return disk.payload;
 
   idx = combined;
@@ -187,4 +215,13 @@ async function fetchIndex() {
   }
 }
 
-module.exports = { fetchIndex, diskPaths };
+async function cacheExists() {
+  try {
+    const { DISK_CACHE_FILE } = diskPaths();
+    return await fs.pathExists(DISK_CACHE_FILE);
+  } catch (e) {
+    return false;
+  }
+}
+
+module.exports = { fetchIndex, diskPaths, cacheExists };

package/src/installer.js

@@ -25,11 +25,13 @@ function getVsCodeUserDir() {
 }
 
 async function installFiles({ items, type, target, workspaceDir }) {
-  // type: prompts|chatmodes|instructions
+  // type: prompts|chatmodes|agents|instructions|skills
   // Helper to derive filename and extension
   const extForType = t => {
     if (t === 'chatmodes') return '.chatmode.md';
+    if (t === 'agents') return '.agent.md';
     if (t === 'instructions' || t === 'instruction') return '.instructions.md';
+    if (t === 'skills') return '.md'; // skills typically use plain .md
     return '.prompt.md';
   };