@maccesar/aiskills 1.7.0 → 1.9.2

package/README.md

@@ -8,13 +8,22 @@
 
 </div>
 
-`aiskills` is a CLI for installing curated skills for AI coding assistants. It installs the skill files and links them to Claude Code, Gemini CLI, or Codex CLI.
+`aiskills` is a toolkit of curated skills for AI coding assistants. It provides skill files for Claude Code, Gemini CLI, or Codex CLI.
 
 Each skill is a small knowledge package: a `SKILL.md` file with YAML frontmatter plus a set of reference files. When a prompt matches the skill, the assistant reads those files and answers from the source material.
 
 ---
 
-## Quick setup
+## Installation
+
+### Option A: Plugin Marketplace (Claude Code only)
+
+```bash
+/plugin marketplace add maccesar/aiskills
+/plugin install aiskills@maccesar-aiskills
+```
+
+### Option B: CLI (Claude Code, Gemini CLI, Codex CLI)
 
 ```bash
 # 1) Install the CLI
@@ -33,10 +42,14 @@ Installed files:
 - All skills to `~/.agents/skills/`
 - Platform symlinks in `~/.claude/skills/`, `~/.gemini/skills/`, or `~/.codex/skills/`
 
-Why install with npm?
-- Cross-platform (macOS, Linux, Windows)
-- No sudo required
-- Simple updates with `aiskills update`
+### Which option should I use?
+
+| | Plugin (Option A) | CLI (Option B) |
+|---|---|---|
+| **Claude Code** | Recommended | Supported |
+| **Gemini CLI** | Not available | Supported |
+| **Codex CLI** | Not available | Supported |
+| **Auto-updates** | Via marketplace | `aiskills update` |
 
 ---
 
@@ -65,6 +78,58 @@ Use `aiskills list` to see available skills from the command line. Pull requests
 
 ---
 
+## Available commands
+
+Slash commands are Claude Code-only. They ship with the plugin (Option A). The CLI distribution (Option B) installs skills only.
+
+| Command    | Purpose                                                                        |
+| ---------- | ------------------------------------------------------------------------------ |
+| `/release` | Full release workflow: detect project, bump semver, update CHANGELOG + README, commit, push, tag, GitHub release |
+
+### /release
+
+End-to-end release janitor that works across project types: npm, Titanium (`tiapp.xml`), Composer, Cargo, CocoaPods, or versionless (git-tag-only) repos. **Designed for a dirty working tree** — it groups your uncommitted work into semantic commits, then ships the release on top.
+
+When to use it:
+- You have weeks of work in the working tree (with maybe a few interim commits you made along the way) and want one command to clean everything into proper semantic commits and ship a release.
+- You maintain `CHANGELOG.md` in Keep-a-Changelog format and want the `[Unreleased]` section promoted automatically.
+- You want the bump level inferred from Conventional Commits across both your existing commits and the proposed new ones, with the option to override.
+
+Example prompts:
+```
+/release
+/release minor
+/release major
+```
+
+How it works:
+1. **Detect** — reads git status, last tag, existing commits since the tag, version file, `CHANGELOG.md`, `README.md`, and `gh` availability.
+2. **Group the working tree** — reads each modified/untracked file's diff, infers intent, and groups files into N proposed semantic commits (`feat`, `fix`, `refactor`, `chore`, `docs`, `test`, `build`, `ci`). Excludes screenshots in repo root, scratch files, suspicious binaries — and lists them so you can override.
+3. **Infer bump** — across the union of (existing commits since tag) + (proposed semantic commits): `BREAKING CHANGE` / `!:` → major, any `feat:` → minor, otherwise patch. An argument overrides.
+4. **Compose CHANGELOG** — promotes `[Unreleased]` if present, or generates a Keep-a-Changelog entry from the union of all commits being shipped.
+5. **Show one compact plan and stop** — header line, optional warnings, the N proposed commits with their files, the CHANGELOG entry, the release commit summary, the push/tag/release lines. If the current branch is not main/master, also offers to fast-forward merge or open a PR. **Waits for explicit confirmation.** You can ask it to merge, split, or skip any of the N commits before confirming.
+6. **Execute** — lands each semantic commit (one at a time, with explicit `git add <files>` per commit, never `git add -A`), then the release commit (bump + CHANGELOG + README), pushes the branch, tags, and creates the GitHub release via `gh`. Optionally fast-forward merges to main or opens a PR if you confirmed that mode.
+
+Confirmations:
+- `proceed` / `sí` / `commitea` → release on current branch only.
+- `merge` → release + fast-forward merge to main + push main, and leaves you on `main`. Aborts cleanly if main has diverged.
+- `PR` → release + open pull request to main via `gh`.
+
+Language policy (two independent axes):
+- **Axis 1 — Interaction with you** — always in your language. The command detects the language from your messages and locks it before printing anything; if you switch, it switches with you.
+- **Axis 2 — Project artifacts** (CHANGELOG entry, README edits, commit message, tag annotation, GitHub release title **and** body) — all share **one** language, detected from `README.md`. A Spanish README means everything in Spanish (typical for private / local projects); an English README means everything in English (typical for open source). No mixed-language releases. Tie-breaks fall back to `CHANGELOG.md` then `git log`; you can override before confirming.
+
+Hard restrictions:
+- Never `--force-push`, `--amend` published commits, or `--no-verify`.
+- Aborts on merge conflicts or rebase-in-progress.
+- Asks before creating the **first** tag on `main` / `master`.
+- Skips push / tag / release gracefully when the repo has no remote or `gh` is not installed.
+
+Distribution note:
+- Available via the plugin install (Option A above). Slash commands are not distributed by the npm CLI (Option B) because they are a Claude Code feature.
+
+---
+
 ## How skills work
 
 Skills activate based on what you ask. You can write prompts normally:

package/lib/cleanup.js

@@ -1,11 +1,14 @@
 /**
- * Cleanup helpers for skills and symlinks
+ * Cleanup helpers for skills, commands, and symlinks
  */
 
 import {
   SKILLS,
   LEGACY_SKILLS,
+  COMMANDS,
+  LEGACY_COMMANDS,
   getAgentsSkillsDir,
+  getClaudeCommandsDir,
 } from './config.js';
 import { detectPlatforms } from './platform.js';
 import { existsSync, lstatSync, rmSync } from 'fs';
@@ -16,6 +19,11 @@ export function getSkillList({ includeLegacy = true, legacyOnly = false } = {})
   return includeLegacy ? [...SKILLS, ...LEGACY_SKILLS] : [...SKILLS];
 }
 
+export function getCommandList({ includeLegacy = true, legacyOnly = false } = {}) {
+  if (legacyOnly) return [...LEGACY_COMMANDS];
+  return includeLegacy ? [...COMMANDS, ...LEGACY_COMMANDS] : [...COMMANDS];
+}
+
 function removeEntriesAtDir(dir, names, { suffix = '', recursive = true } = {}) {
   const results = { removed: [], failed: [] };
   if (!dir || !existsSync(dir)) return results;
@@ -51,8 +59,15 @@ export function removeSkills(baseDir, options = {}) {
   return removeEntriesAtDir(skillsDir, skillList, { recursive: true });
 }
 
+export function removeCommands(baseDir, options = {}) {
+  const commandsDir = getClaudeCommandsDir(baseDir);
+  const commandList = getCommandList(options);
+  return removeEntriesAtDir(commandsDir, commandList, { suffix: '.md', recursive: false });
+}
+
 export function cleanupLegacyArtifacts(baseDir) {
   removeSkills(baseDir, { legacyOnly: true });
+  removeCommands(baseDir, { legacyOnly: true });
 
   const platforms = detectPlatforms(baseDir);
   for (const platform of platforms) {
@@ -61,6 +76,7 @@ export function cleanupLegacyArtifacts(baseDir) {
 
   if (baseDir) {
     removeSkills(undefined, { legacyOnly: true });
+    removeCommands(undefined, { legacyOnly: true });
     const globalPlatforms = detectPlatforms();
     for (const platform of globalPlatforms) {
       removeLegacySkillSymlinks(platform.skillsDir);
@@ -70,8 +86,10 @@ export function cleanupLegacyArtifacts(baseDir) {
 
 export default {
   getSkillList,
+  getCommandList,
   removeSkillSymlinks,
   removeLegacySkillSymlinks,
   removeSkills,
+  removeCommands,
   cleanupLegacyArtifacts,
 };

package/lib/commands/list.js

@@ -1,76 +1,101 @@
 /**
  * List command
- * Shows available skills with their descriptions
+ * Enumerates available skills with a short description.
+ * Reads each skill's SKILL.md frontmatter — no hardcoded list.
  */
 
 import chalk from 'chalk';
-import { SKILLS } from '../config.js';
-import { readFileSync } from 'fs';
-import { join, dirname } from 'path';
-import { fileURLToPath } from 'url';
+import { existsSync, readFileSync } from 'fs';
+import { join } from 'path';
+import {
+  SKILLS,
+  PACKAGE_VERSION,
+  getAgentsSkillsDir,
+} from '../config.js';
 
-const __dirname = dirname(fileURLToPath(import.meta.url));
+const CHECK = chalk.green('✓');
+const CROSS = chalk.red('✗');
+
+/**
+ * Extract the skill's human-readable name and short description from SKILL.md.
+ * Returns { description, installed } where description is the first sentence of
+ * the frontmatter description, trimmed for terminal display.
+ */
+function readSkillMetadata(skillDir) {
+  const skillMd = join(skillDir, 'SKILL.md');
+  if (!existsSync(skillMd)) {
+    return { description: null, installed: false };
+  }
 
-function parseSkillDescription(skillName) {
   try {
-    const skillPath = join(__dirname, '..', '..', 'skills', skillName, 'SKILL.md');
-    const content = readFileSync(skillPath, 'utf8');
-    const match = content.match(/^---\n([\s\S]*?)\n---/);
-    if (!match) return null;
-
-    const frontmatter = match[1];
-
-    // Extract name
-    const nameMatch = frontmatter.match(/^name:\s*(.+)$/m);
-    const name = nameMatch ? nameMatch[1].trim() : skillName;
-
-    // Extract description (handles multi-line YAML >)
-    let description = '';
-    const descMatch = frontmatter.match(/description:\s*>\s*\n([\s\S]*?)(?=\n\w+:|$)/);
-    if (descMatch) {
-      description = descMatch[1]
-        .split('\n')
-        .map(line => line.trim())
-        .filter(Boolean)
-        .join(' ');
-    } else {
-      const singleMatch = frontmatter.match(/^description:\s*(.+)$/m);
-      if (singleMatch) {
-        description = singleMatch[1].trim();
-      }
-    }
+    const content = readFileSync(skillMd, 'utf8');
+    const frontmatter = content.match(/^---\n([\s\S]*?)\n---/);
+    if (!frontmatter) return { description: null, installed: true };
 
-    // Trim long descriptions
-    const maxLen = 80;
-    if (description.length > maxLen) {
-      description = description.substring(0, maxLen - 1).trimEnd() + '…';
-    }
+    const descMatch = frontmatter[1].match(/description:\s*"([^"]+)"|description:\s*(.+)/);
+    if (!descMatch) return { description: null, installed: true };
 
-    return { name, description };
+    const full = descMatch[1] || descMatch[2] || '';
+    let short;
+    const firstSentence = full.match(/^([^]*?\.)\s/);
+    if (firstSentence) {
+      short = firstSentence[1];
+    } else if (full.length > 80) {
+      const cut = full.slice(0, 80);
+      short = cut.slice(0, cut.lastIndexOf(' ')) + '…';
+    } else {
+      short = full;
+    }
+    return { description: short.trim(), installed: true };
   } catch {
-    return null;
+    return { description: null, installed: true };
   }
 }
 
-/**
- * List command handler
- */
 export async function listCommand() {
   console.log('');
-  console.log(chalk.bold.blue('Available Skills'));
+  console.log(chalk.bold.blue(`AI Skills (v${PACKAGE_VERSION})`));
   console.log('');
 
-  const maxNameLen = Math.max(...SKILLS.map(s => s.length));
+  const skillsDir = getAgentsSkillsDir();
+
+  if (!existsSync(skillsDir)) {
+    console.log(chalk.yellow('No skills installed yet.'));
+    console.log('Install with:');
+    console.log(chalk.cyan('  aiskills install'));
+    console.log('');
+    return;
+  }
+
+  const rows = [];
+  let installedCount = 0;
+  let maxNameLen = 0;
+
+  for (const name of SKILLS) {
+    const skillDir = join(skillsDir, name);
+    const { description, installed } = readSkillMetadata(skillDir);
 
-  for (const skill of SKILLS) {
-    const info = parseSkillDescription(skill);
-    const name = chalk.cyan(skill.padEnd(maxNameLen));
-    const desc = info?.description ? chalk.gray(info.description) : chalk.gray('(no description)');
-    console.log(`  ${name}  ${desc}`);
+    if (installed) installedCount++;
+    if (name.length > maxNameLen) maxNameLen = name.length;
+
+    rows.push({ name, description, installed });
   }
 
+  for (const row of rows) {
+    const mark = row.installed ? CHECK : CROSS;
+    const paddedName = row.name.padEnd(maxNameLen + 2);
+    const desc = row.description
+      ? chalk.gray(row.description)
+      : chalk.gray(row.installed ? '(no description)' : 'not installed');
+
+    console.log(`  ${mark} ${chalk.cyan(paddedName)} ${desc}`);
+  }
+
+  console.log('');
+  console.log(chalk.gray(`${installedCount}/${SKILLS.length} installed at ${skillsDir}`));
   console.log('');
-  console.log(chalk.gray(`${SKILLS.length} skill${SKILLS.length !== 1 ? 's' : ''} available`));
+  console.log(chalk.gray('Run `aiskills status` for installation health.'));
+  console.log(chalk.gray('Run `aiskills doctor` to diagnose issues.'));
   console.log('');
 }
 

package/lib/commands/skills.js

@@ -21,9 +21,11 @@ import {
   removeSkillSymlinks,
   removeLegacySkillSymlinks,
   removeSkills,
+  removeCommands,
 } from '../cleanup.js';
 import {
   installSkills,
+  installCommands,
   getLocalRepoDir,
 } from '../installer.js';
 import { downloadRepoArchive } from '../downloader.js';
@@ -179,6 +181,24 @@ export async function skillsCommand(options) {
       const skillsResult = await installSkills(repoDir, baseDir);
       spinner.succeed(`${SKILLS.length} skill${SKILLS.length !== 1 ? 's' : ''} installed`);
 
+      // Install or remove slash commands based on Claude Code selection
+      if (selectedPlatformNames.has('claude')) {
+        spinner.start('Installing slash commands...');
+        const commandsResult = await installCommands(repoDir, baseDir);
+        if (commandsResult.installed.length > 0) {
+          spinner.succeed(
+            `${commandsResult.installed.length} slash command${commandsResult.installed.length !== 1 ? 's' : ''} installed`
+          );
+        } else {
+          spinner.info('No slash commands to install');
+        }
+      } else {
+        const removed = removeCommands(baseDir);
+        if (removed.removed.length > 0) {
+          console.log(chalk.green('✓'), `${removed.removed.length} slash commands removed`);
+        }
+      }
+
       // Create symlinks for selected platforms
       for (const platform of selectedPlatforms) {
         removeLegacySkillSymlinks(platform.skillsDir);
@@ -198,6 +218,7 @@ export async function skillsCommand(options) {
       }
     } else {
       const skillsResult = removeSkills(baseDir);
+      const commandsResult = removeCommands(baseDir);
       const platformResults = detectedPlatforms.map((platform) => {
         const symlinkResult = removeSkillSymlinks(platform.skillsDir);
         return {
@@ -212,6 +233,10 @@ export async function skillsCommand(options) {
         console.log(chalk.gray('ℹ'), 'No skills to remove');
       }
 
+      if (commandsResult.removed.length > 0) {
+        console.log(chalk.green('✓'), `${commandsResult.removed.length} slash commands removed`);
+      }
+
       for (const result of platformResults) {
         if (result.removedCount > 0) {
           console.log(chalk.green('✓'), `${result.displayName}: Skills unlinked`);

package/lib/commands/status.js

@@ -73,7 +73,7 @@ export async function statusCommand() {
   console.log(`  Version:    v${PACKAGE_VERSION}`);
   console.log(`  Skills:     ${installedCount}/${totalCount} installed`);
   console.log(`  Hook:       Claude Code SessionStart ${hookExists ? CHECK : CROSS}`);
-  console.log(`  Last check: ${formatLastCheck(lastCheck)}`);
+  console.log(`  Last npm check: ${formatLastCheck(lastCheck)}`);
 
   // Platforms
   console.log('');

package/lib/commands/uninstall.js

@@ -13,14 +13,15 @@ import {
 import {
   removeSkillSymlinks,
   removeSkills,
+  removeCommands,
 } from '../cleanup.js';
 import { removeHook } from '../hooks.js';
 import checkbox, { Separator } from '../prompts/checkboxCancel.js';
 import { existsSync } from 'fs';
 import { rm } from 'fs/promises';
 import { join, resolve } from 'path';
-import { getAgentsSkillsDir } from '../config.js';
-import { getSkillList } from '../cleanup.js';
+import { getAgentsSkillsDir, getClaudeCommandsDir } from '../config.js';
+import { getSkillList, getCommandList } from '../cleanup.js';
 
 /**
  * Uninstall command handler
@@ -40,14 +41,19 @@ export async function uninstallCommand(options) {
   const detectedPlatforms = detectPlatforms(baseDir);
 
   const skillList = getSkillList();
+  const commandList = getCommandList().map((cmd) => `${cmd}.md`);
   const homeSkillsDir = getAgentsSkillsDir();
   const projectSkillsDir = getAgentsSkillsDir(projectDir);
+  const homeCommandsDir = getClaudeCommandsDir();
+  const projectCommandsDir = getClaudeCommandsDir(projectDir);
 
   const hasAnyInDir = (dir, names) =>
     !!dir && existsSync(dir) && names.some((name) => existsSync(join(dir, name)));
 
   const hasHomeSkills = hasAnyInDir(homeSkillsDir, skillList);
   const hasProjectSkills = options.local && hasAnyInDir(projectSkillsDir, skillList);
+  const hasHomeCommands = hasAnyInDir(homeCommandsDir, commandList);
+  const hasProjectCommands = options.local && hasAnyInDir(projectCommandsDir, commandList);
 
   const hasHomeSymlinks = detectedPlatforms.some((platform) =>
     hasAnyInDir(platform.skillsDir, skillList)
@@ -63,6 +69,12 @@ export async function uninstallCommand(options) {
   if (hasProjectSkills) {
     choices.push({ name: 'Skills from the `project` directory', value: 'skills-project', checked: false });
   }
+  if (hasHomeCommands) {
+    choices.push({ name: 'Slash commands from `home` directory', value: 'commands-home', checked: true });
+  }
+  if (hasProjectCommands) {
+    choices.push({ name: 'Slash commands from `project` directory', value: 'commands-project', checked: false });
+  }
   if (hasHomeSymlinks) {
     choices.push({ name: 'Skill symlinks from `home` directory', value: 'symlinks-home', checked: true });
   }
@@ -71,7 +83,7 @@ export async function uninstallCommand(options) {
   }
 
   if (choices.length === 0) {
-    console.log(chalk.yellow('No skills or symlinks found.'));
+    console.log(chalk.yellow('No skills, commands, or symlinks found.'));
     console.log('');
     return;
   }
@@ -158,6 +170,28 @@ export async function uninstallCommand(options) {
     }
   }
 
+  if (targets.includes('commands-home')) {
+    spinner.start('Removing slash commands...');
+    const result = removeCommands(undefined);
+    if (result.removed.length > 0) {
+      spinner.succeed(`${result.removed.length} slash commands removed`);
+      actionTaken = true;
+    } else {
+      spinner.info('No slash commands to remove');
+    }
+  }
+
+  if (targets.includes('commands-project')) {
+    spinner.start('Removing slash commands...');
+    const result = removeCommands(projectDir);
+    if (result.removed.length > 0) {
+      spinner.succeed(`${result.removed.length} slash commands removed`);
+      actionTaken = true;
+    } else {
+      spinner.info('No slash commands to remove');
+    }
+  }
+
   // Remove Claude Code SessionStart hook
   const claudeDir = join(os.homedir(), '.claude');
   removeHook(claudeDir);

package/lib/commands/update.js

@@ -10,12 +10,14 @@ import {
   REPO_URL,
   SKILLS,
 } from '../config.js';
+import select from '../prompts/selectCancel.js';
 import {
   detectPlatforms,
 } from '../platform.js';
 import { cleanupLegacyArtifacts, getSkillList } from '../cleanup.js';
 import {
   installSkills,
+  installCommands,
   getLocalRepoDir,
 } from '../installer.js';
 import {
@@ -26,9 +28,12 @@ import { createSkillSymlinks } from '../symlink.js';
 import { getAgentsSkillsDir } from '../config.js';
 import { existsSync } from 'fs';
 import { join } from 'path';
+import os from 'os';
 
 /**
  * Check if a platform has any skill symlinks installed
+ * @param {string} platformSkillsDir - Platform skills directory
+ * @returns {boolean} True if any skill symlink exists
  */
 function hasAnySkillSymlink(platformSkillsDir) {
   if (!platformSkillsDir || !existsSync(platformSkillsDir)) return false;
@@ -38,6 +43,10 @@ function hasAnySkillSymlink(platformSkillsDir) {
 
 /**
  * Perform the actual update for a specific scope
+ * @param {string|undefined} baseDir - Base directory (undefined = global, path = local)
+ * @param {string} repoDir - Repository directory
+ * @param {Object} spinner - Ora spinner instance
+ * @returns {Promise<void>}
  */
 async function performUpdate(baseDir, repoDir, spinner) {
   const detectedPlatforms = detectPlatforms(baseDir);
@@ -49,6 +58,20 @@ async function performUpdate(baseDir, repoDir, spinner) {
   const skillsResult = await installSkills(repoDir, baseDir);
   spinner.succeed(`${skillsResult.installed.length} skills updated`);
 
+  // Sync slash commands when Claude Code has skill symlinks installed
+  const claudePlatform = platformsWithSymlinks.find((p) => p.name === 'claude');
+  if (claudePlatform) {
+    spinner.start('Syncing slash commands...');
+    const commandsResult = await installCommands(repoDir, baseDir);
+    if (commandsResult.installed.length > 0) {
+      spinner.succeed(
+        `${commandsResult.installed.length} slash command${commandsResult.installed.length !== 1 ? 's' : ''} synced`
+      );
+    } else {
+      spinner.info('No slash commands to sync');
+    }
+  }
+
   cleanupLegacyArtifacts(baseDir);
 
   for (const platform of platformsWithSymlinks) {
@@ -62,6 +85,7 @@ async function performUpdate(baseDir, repoDir, spinner) {
 
 /**
  * Update command handler
+ * @param {Object} options - Command options
  */
 export async function updateCommand(options) {
   console.log('');
@@ -70,27 +94,74 @@ export async function updateCommand(options) {
 
   const spinner = ora();
 
-  const baseDir = options.local ? process.cwd() : undefined;
+  let baseDir = options.local ? process.cwd() : undefined;
+  const hasSkillsAt = (dir) =>
+    SKILLS.some((skill) => existsSync(join(getAgentsSkillsDir(dir), skill)));
+
+  if (!options.local) {
+    const projectDir = process.cwd();
+    // When cwd === home, "local" and "global" point to the same .agents/skills dir
+    const isHomeDir = projectDir === os.homedir();
+    const hasLocalSkills = !isHomeDir && hasSkillsAt(projectDir);
+    const hasGlobalSkills = hasSkillsAt(undefined);
+
+    if (hasLocalSkills && hasGlobalSkills) {
+      try {
+        const scope = await select({
+          message: 'Both local and global skills detected. What do you want to update:',
+          choices: [
+            { name: 'Global skills (user home)', value: 'global' },
+            { name: 'Local skills (current project)', value: 'local' },
+            { name: 'Both locations', value: 'both' },
+          ],
+          theme: {
+            style: {
+              answer: () => '',
+              prefix: () => chalk.cyan('?'),
+            },
+          },
+        });
+        if (scope === 'cancel') {
+          console.log('Cancelled.');
+          process.exit(0);
+        }
+        if (scope === 'local') {
+          baseDir = projectDir;
+        } else if (scope === 'both') {
+          baseDir = 'both';
+        }
+      } catch (error) {
+        console.log('\nCancelled.');
+        process.exit(0);
+      }
+    } else if (hasLocalSkills && !hasGlobalSkills) {
+      baseDir = projectDir;
+    }
+  }
 
-  if (baseDir) {
+  if (baseDir === 'both') {
+    console.log(chalk.cyan('Mode: Updating both global and local skills'));
+  } else if (baseDir) {
     console.log(chalk.cyan('Mode: Local update (current project)'));
   } else {
     console.log(chalk.cyan('Mode: Global update (user home)'));
   }
   console.log('');
 
-  // Verify skills are installed
-  const skillsDir = getAgentsSkillsDir(baseDir);
-  const hasSkillsInstalled = skillsDir && SKILLS.some((skill) => existsSync(join(skillsDir, skill)));
-  if (!hasSkillsInstalled) {
-    console.log(chalk.yellow('No skills installed at this location.'));
-    console.log('Install them first with:');
-    console.log('  aiskills install');
-    console.log('');
-    return;
+  if (baseDir !== 'both') {
+    const skillsDir = getAgentsSkillsDir(baseDir);
+    const hasSkillsInstalled = skillsDir && SKILLS.some((skill) => existsSync(join(skillsDir, skill)));
+    if (!hasSkillsInstalled) {
+      console.log(chalk.yellow('No skills installed at this location.'));
+      console.log('Install them first with:');
+      console.log('  aiskills install');
+      console.log('');
+      console.log('Looked for skills in:');
+      console.log(`  ${baseDir ? 'Local' : 'Global'}: ${skillsDir}`);
+      return;
+    }
   }
 
-  // Check for updates
   spinner.start('Checking for updates...');
 
   try {
@@ -101,7 +172,7 @@ export async function updateCommand(options) {
       try {
         latestVersion = await fetchLatestNpmVersion();
       } catch {
-        // Ignore
+        // Ignore error, we already know there's an update
       }
 
       spinner.warn('New version available');
@@ -130,7 +201,16 @@ export async function updateCommand(options) {
       return;
     }
 
-    await performUpdate(baseDir, repoDir, spinner);
+    if (baseDir === 'both') {
+      console.log(chalk.bold('Updating global skills...'));
+      await performUpdate(undefined, repoDir, spinner);
+      console.log('');
+
+      console.log(chalk.bold('Updating local skills...'));
+      await performUpdate(process.cwd(), repoDir, spinner);
+    } else {
+      await performUpdate(baseDir, repoDir, spinner);
+    }
 
     console.log('');
     console.log(chalk.green('✓ Update complete!'));

package/lib/config.js

@@ -36,12 +36,21 @@ export const SKILLS = [
 // Legacy skills to remove during updates/uninstall
 export const LEGACY_SKILLS = [];
 
+// Slash commands to install (Claude Code only — copied to ~/.claude/commands/)
+export const COMMANDS = [
+  'release',
+];
+
+// Legacy commands to remove during updates/uninstall
+export const LEGACY_COMMANDS = [];
+
 // Cache/config directory
 export const getConfigDir = () => path.join(os.homedir(), '.aiskills');
 
 // Directory paths
 export const getAgentsSkillsDir = (baseDir = os.homedir()) => path.join(baseDir, '.agents', 'skills');
 export const getClaudeSkillsDir = (baseDir = os.homedir()) => path.join(baseDir, '.claude', 'skills');
+export const getClaudeCommandsDir = (baseDir = os.homedir()) => path.join(baseDir, '.claude', 'commands');
 export const getGeminiSkillsDir = (baseDir = os.homedir()) => path.join(baseDir, '.gemini', 'skills');
 export const getCodexSkillsDir = (baseDir = os.homedir()) => path.join(baseDir, '.codex', 'skills');
 
@@ -80,9 +89,12 @@ export default {
   REPO_API_URL,
   SKILLS,
   LEGACY_SKILLS,
+  COMMANDS,
+  LEGACY_COMMANDS,
   getConfigDir,
   getAgentsSkillsDir,
   getClaudeSkillsDir,
+  getClaudeCommandsDir,
   getGeminiSkillsDir,
   getCodexSkillsDir,
   getPlatforms,

package/lib/downloader.js

@@ -11,6 +11,39 @@ import { unlink } from 'fs/promises';
 import { extract } from 'tar';
 import { REPO_API_URL, REPO_RAW_URL, GITHUB_API_HEADERS } from './config.js';
 
+function getTestLatestNpmVersion() {
+  const value = process.env.AISKILLS_TEST_NPM_LATEST_VERSION;
+  return value && value.trim() ? value.trim() : null;
+}
+
+/**
+ * Fetch latest release info from GitHub API
+ * @returns {Promise<Object>} Release information
+ */
+export async function fetchLatestRelease() {
+  const response = await fetch(
+    `${REPO_API_URL}/releases/latest`,
+    {
+      headers: GITHUB_API_HEADERS,
+    }
+  );
+
+  if (!response.ok) {
+    throw new Error(`Failed to fetch release info: ${response.statusText}`);
+  }
+
+  return response.json();
+}
+
+/**
+ * Fetch latest version from GitHub
+ * @returns {Promise<string>} Latest version tag
+ */
+export async function fetchLatestVersion() {
+  const release = await fetchLatestRelease();
+  return release.tag_name;
+}
+
 /**
  * Download a file from URL to local path
  * @param {string} url - URL to download
@@ -59,11 +92,34 @@ export async function downloadRepoArchive(destDir, ref = 'main') {
   }
 }
 
+/**
+ * Download a single file from GitHub raw content
+ * @param {string} filePath - Path in repository
+ * @param {string} destPath - Local destination path
+ * @param {string} ref - Git ref (branch, tag, commit)
+ * @returns {Promise<void>}
+ */
+export async function downloadRawFile(filePath, destPath, ref = 'main') {
+  const url = `${REPO_RAW_URL}/${ref}/${filePath}`;
+
+  const dir = dirname(destPath);
+  if (!existsSync(dir)) {
+    mkdirSync(dir, { recursive: true });
+  }
+
+  await downloadFile(url, destPath);
+}
+
 /**
  * Fetch latest version from npm registry
  * @returns {Promise<string>} Latest version number
  */
 export async function fetchLatestNpmVersion() {
+  const testVersion = getTestLatestNpmVersion();
+  if (testVersion) {
+    return testVersion;
+  }
+
   const response = await fetch('https://registry.npmjs.org/@maccesar/aiskills');
 
   if (!response.ok) {
@@ -103,8 +159,11 @@ export async function checkForUpdate(currentVersion) {
 }
 
 export default {
+  fetchLatestRelease,
+  fetchLatestVersion,
   downloadFile,
   downloadRepoArchive,
+  downloadRawFile,
   fetchLatestNpmVersion,
   checkForUpdate,
 };

package/lib/installer.js

@@ -1,9 +1,10 @@
 /**
  * File installation utilities
- * Installs skills to their respective directories
+ * Installs skills and slash commands to their respective directories
  */
 
 import {
+  copyFileSync,
   existsSync,
   mkdirSync,
 } from 'fs';
@@ -12,9 +13,11 @@ import { remove, copy } from 'fs-extra';
 import os from 'os';
 import {
   SKILLS,
+  COMMANDS,
   getAgentsSkillsDir,
+  getClaudeCommandsDir,
 } from './config.js';
-import { removeSkills } from './cleanup.js';
+import { removeSkills, removeCommands } from './cleanup.js';
 
 /**
  * Recursively copy a directory
@@ -91,6 +94,68 @@ export async function installSkills(repoDir, baseDir = os.homedir()) {
   return results;
 }
 
+/**
+ * Install a single slash command to the Claude commands directory
+ * @param {string} repoDir - Repository directory
+ * @param {string} commandName - Name of the command (without .md)
+ * @param {string} baseDir - Base directory for installation
+ * @returns {Promise<boolean>} True if installed successfully
+ */
+export async function installCommand(repoDir, commandName, baseDir = os.homedir()) {
+  const commandsDir = getClaudeCommandsDir(baseDir);
+  const src = join(repoDir, 'commands', `${commandName}.md`);
+  const dest = join(commandsDir, `${commandName}.md`);
+
+  if (!existsSync(commandsDir)) {
+    mkdirSync(commandsDir, { recursive: true });
+  }
+
+  if (!existsSync(src)) {
+    return false;
+  }
+
+  if (existsSync(dest)) {
+    await remove(dest);
+  }
+
+  copyFileSync(src, dest);
+  return true;
+}
+
+/**
+ * Install all slash commands to the Claude commands directory
+ * @param {string} repoDir - Repository directory
+ * @param {string} baseDir - Base directory for installation
+ * @returns {Promise<Object>} Results object with success/failure counts
+ */
+export async function installCommands(repoDir, baseDir = os.homedir()) {
+  const results = {
+    installed: [],
+    failed: [],
+    removed: [],
+  };
+
+  const legacyLocal = removeCommands(baseDir, { legacyOnly: true });
+  results.removed.push(...legacyLocal.removed);
+  results.failed.push(...legacyLocal.failed);
+
+  if (baseDir && baseDir !== os.homedir()) {
+    const legacyGlobal = removeCommands(undefined, { legacyOnly: true });
+    results.removed.push(...legacyGlobal.removed);
+    results.failed.push(...legacyGlobal.failed);
+  }
+
+  for (const cmd of COMMANDS) {
+    if (await installCommand(repoDir, cmd, baseDir)) {
+      results.installed.push(cmd);
+    } else {
+      results.failed.push(cmd);
+    }
+  }
+
+  return results;
+}
+
 /**
  * Get the local repository directory if running from source
  * @returns {string|null} Local repo directory or null
@@ -110,5 +175,7 @@ export default {
   copyDirectory,
   installSkill,
   installSkills,
+  installCommand,
+  installCommands,
   getLocalRepoDir,
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@maccesar/aiskills",
-  "version": "1.7.0",
+  "version": "1.9.2",
   "description": "AI coding assistant skills for Claude Code, Gemini CLI, and Codex CLI",
   "type": "module",
   "bin": {

package/skills/refactoring-ui/SKILL.md

@@ -1,10 +1,6 @@
 ---
 name: refactoring-ui
-description: >
-  Design advisor based exclusively on "Refactoring UI" by Adam Wathan & Steve Schoger.
-  Use when the user asks for UI/UX design advice, design reviews, visual hierarchy
-  improvements, color system help, typography guidance, spacing decisions, depth/shadow
-  usage, image handling, or finishing touches on any interface.
+description: Design advisor based exclusively on "Refactoring UI" by Adam Wathan & Steve Schoger. Use when the user asks for UI/UX design advice, design reviews, visual hierarchy improvements, color system help, typography guidance, spacing decisions, depth/shadow usage, image handling, or finishing touches on any interface.
 when_to_use: >
   - User asks "how do I make this look better?"
   - User asks about color palettes, type scales, or spacing systems

package/skills/stitch-showcase/SKILL.md

@@ -1,15 +1,6 @@
 ---
 name: stitch-showcase
-description: >
-  Use this skill whenever the user has Google Stitch design exports and wants to do anything with them —
-  build a gallery, organize screens, generate a navigable showcase, process zip files, or browse designs.
-  Triggers on: "organiza mis diseños de Stitch", "arma el muestrario", "organize my Stitch designs",
-  "build the showcase", "I have the Stitch zips in X", "process this design folder",
-  "generate the index for my Stitch screens", "tengo los zips de Stitch", "quiero ver mis pantallas",
-  or any mention of Stitch exports, screen.png + code.html pairs, or design zip files.
-  Even if the user just says "I have a zip from Stitch" or "mis exports de Stitch" — use this skill.
-  Also triggers on: "optimiza el showcase", "mejora las descripciones", "enrich the showcase",
-  "optimize titles", "optimiza", or any request to improve an existing showcase's content.
+description: Use this skill whenever the user has Google Stitch design exports and wants to do anything with them — build a gallery, organize screens, generate a navigable showcase, process zip files, or browse designs. Triggers on "organiza mis diseños de Stitch", "arma el muestrario", "organize my Stitch designs", "build the showcase", "I have the Stitch zips in X", "process this design folder", "generate the index for my Stitch screens", "tengo los zips de Stitch", "quiero ver mis pantallas", or any mention of Stitch exports, screen.png + code.html pairs, or design zip files. Even if the user just says "I have a zip from Stitch" or "mis exports de Stitch" — use this skill. Also triggers on "optimiza el showcase", "mejora las descripciones", "enrich the showcase", "optimize titles", "optimiza", or any request to improve an existing showcase's content.
 ---
 
 # stitch-showcase

package/skills/vscode-extension-dev/SKILL.md

@@ -1,10 +1,6 @@
 ---
 name: vscode-extension-dev
-description: >
-  Guide for building VS Code extensions from scratch. Use when the user is creating,
-  scaffolding, designing, debugging, testing, bundling, or publishing a VS Code extension.
-  Covers all major API patterns: TreeView, QuickPick, Webview, StatusBar, commands,
-  configuration, SecretStorage, progress indicators, and esbuild bundling.
+description: Guide for building VS Code extensions from scratch. Use when the user is creating, scaffolding, designing, debugging, testing, bundling, or publishing a VS Code extension. Covers all major API patterns — TreeView, QuickPick, Webview, StatusBar, commands, configuration, SecretStorage, progress indicators, and esbuild bundling.
 when_to_use: >
   - User wants to create a new VS Code extension
   - User asks about VS Code extension APIs (TreeView, Webview, QuickPick, etc.)