@biggora/claude-plugins 1.2.2 → 1.3.1

package/README.md

@@ -67,6 +67,7 @@ claude-plugins skills remove commafeed-api
 | `vite-best-practices` | frontend | Vite 8 build tool best practices — configuration, Rolldown/Oxc migration, plugin API, SSR, library mode, and virtual modules |
 | `google-merchant-api` | workflow | Work with Google Merchant Center APIs — Merchant API (v1) and Content API for Shopping (v2.1) for products, inventory, promotions, and reports |
 | `lv-aggregators-api` | workflow | Generate and manage XML product feeds for Latvian price comparison platforms — Salidzini.lv and KurPirkt.lv integration |
+| `typescript-expert` | code-quality | TypeScript type system, generics, utility types, advanced patterns, tsconfig, and TS 5.x features — includes `/typescript-fix` slash command |
 | `youtube-thumbnail` | other | Generates professional YouTube thumbnails in 11 strategic styles with auto-detection of AI image backends and Pillow compositing |
 
 #### Install Examples
@@ -90,6 +91,7 @@ npx skills add https://github.com/biggora/claude-plugins-registry --skill tailwi
 npx skills add https://github.com/biggora/claude-plugins-registry --skill vite-best-practices
 npx skills add https://github.com/biggora/claude-plugins-registry --skill google-merchant-api
 npx skills add https://github.com/biggora/claude-plugins-registry --skill lv-aggregators-api
+npx skills add https://github.com/biggora/claude-plugins-registry --skill typescript-expert
 ```
 
 ## Plugins
@@ -224,6 +226,7 @@ Skills are simpler than plugins — just a SKILL.md file with optional supportin
 ```
 my-skill/
   SKILL.md            # Required: skill instructions with YAML frontmatter
+  commands/           # Slash commands (optional, copied to ~/.claude/commands/ on install)
   references/         # Reference docs (optional)
   scripts/            # Helper scripts (optional)
 ```
@@ -260,8 +263,9 @@ The plugin registry is a GitHub-hosted JSON file at [biggora/claude-plugins-regi
 
 - **Plugins** are installed via `git clone` to `~/.claude/plugins/<name>`
 - **Skills** are installed via `git clone` + copy to `~/.claude/skills/<name>`
+- **Slash commands** bundled with skills are automatically copied to `~/.claude/commands/`
 - Updates use `git pull --ff-only` to safely fast-forward
-- Claude Code automatically discovers plugins and skills in `~/.claude/`
+- Claude Code automatically discovers plugins in `~/.claude/plugins/`, skills in `~/.claude/skills/`, and commands in `~/.claude/commands/`
 - Restart Claude Code after installing or removing plugins/skills
 
 ## Requirements

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@biggora/claude-plugins",
-  "version": "1.2.2",
+  "version": "1.3.1",
   "description": "CLI marketplace for discovering, installing, and managing Claude Code plugins",
   "keywords": [
     "claude",

package/registry/registry.json

@@ -314,6 +314,21 @@
       "commands": [],
       "category": "workflow",
       "type": "skill"
+    },
+    {
+      "name": "typescript-expert",
+      "version": "1.0.0",
+      "description": "TypeScript language expertise — type system, generics, utility types, advanced type patterns, tsconfig configuration, and TS 5.x features with /typescript-fix slash command for auto-resolving type errors",
+      "author": {
+        "name": "biggora",
+        "url": "https://github.com/biggora"
+      },
+      "repository": "https://github.com/biggora/claude-plugins-registry",
+      "keywords": ["typescript", "types", "generics", "tsconfig", "type-checking", "code-quality"],
+      "license": "MIT",
+      "commands": ["/typescript-fix"],
+      "category": "code-quality",
+      "type": "skill"
     }
   ]
 }

package/specs/coding.md

@@ -13,6 +13,7 @@ salidzini + kurpirkt
 https://www.salidzini.lv/shops_info.php
 https://www.kurpirkt.lv/veikaliem.php
 
+nest--best-practices
 
 add vite-best-practices, tailwindcss-best-practices skills to registry/registry.json and README.md
 
@@ -20,5 +21,15 @@ create skill google-merchant-api in src/skills/google-merchant-api. The skill sh
 
 create skill lv-aggregators-api in src/skills/lv-aggregators-api. The skill should include knowledge of how to work with Aggregators APIs, how to integrate them into projects, formats and data types, etc. Aggregators Docs: https://www.salidzini.lv/shops_info.php, https://www.kurpirkt.lv/veikaliem.php
 
+create skill typescript-expert src/skills/typescript-expert. The skill should include knowledge of TypeScript language features, best practices, type system, advanced types, generics, utility types, and how to use TypeScript effectively in projects.
 
+create skill eslint-expert src/skills/eslint-expert. The skill should include knowledge of ESLint configuration, rules, plugins, and how to use ESLint effectively in projects for code quality and consistency.
 
+create slash command typescript-fix for the TypeScript expert (typescript-expert) skill. with some content like this:
+"You are a TypeScript expert with deep knowledge of complex typing patterns, modern JavaScript (ES6+), ESLint configuration, and enterprise-grade development practices. You specialize in building reliable, maintainable, and performant TypeScript solutions for complex business problems, with a solid understanding of JavaScript fundamentals and code quality tools. Read package.json to identify the command to run the linter. Use the `typescript-expert` skill to run `npm run typecheck`, `pnpm run typecheck`, or `tsc --noEmit` in the project directory and resolve TypeScript errors."
+
+the slash command is copied to the same skill subfolder ~/.claude/skills/typescript-expert/commands/typescript-fix.md, but must be copied to ~/.claude/commands/typescript-fix.md
+
+
+try this command  npx skills add ./ --skill typescript-expert and check C:\Users\biggora\.claude\commands. Looks
+like it does not work

package/src/commands/skills/add.js

@@ -1,10 +1,11 @@
 import { execFileSync } from 'node:child_process';
-import { existsSync, readFileSync, readdirSync, cpSync, rmSync, mkdirSync, writeFileSync, statSync } from 'node:fs';
-import { join, basename } from 'node:path';
+import { existsSync, readFileSync, readdirSync, cpSync, rmSync, mkdirSync, writeFileSync, statSync, copyFileSync } from 'node:fs';
+import { join, basename, resolve } from 'node:path';
 import { tmpdir } from 'node:os';
-import { getSkillsDir } from '../../config.js';
+import { getSkillsDir, getCommandsDir } from '../../config.js';
 import { fetchRegistry, findPlugin } from '../../registry.js';
 import { log, spinner } from '../../utils.js';
+import { detectComponents, findInstalledSkill } from './resolve.js';
 
 export function parseFrontmatter(content) {
   const match = content.match(/^---\r?\n([\s\S]*?)\r?\n---/);
@@ -48,6 +49,15 @@ function isUrl(str) {
   return str.startsWith('http://') || str.startsWith('https://') || str.startsWith('git@');
 }
 
+function isLocalPath(str) {
+  if (str.startsWith('./') || str.startsWith('../') || str.startsWith('/')) return true;
+  // Windows absolute paths like C:\ or E:\
+  if (/^[a-zA-Z]:[/\\]/.test(str)) return true;
+  // Explicit . for current directory
+  if (str === '.') return true;
+  return false;
+}
+
 function makeTempDir() {
   const dir = join(tmpdir(), `claude-skill-${Date.now()}`);
   mkdirSync(dir, { recursive: true });
@@ -56,9 +66,19 @@ function makeTempDir() {
 
 export async function add(source, options = {}) {
   let repoUrl = source;
+  let sourceDir = null;
 
-  // If not a URL, look up in registry
-  if (!isUrl(source)) {
+  if (isLocalPath(source)) {
+    // Local directory — use directly, no git clone
+    sourceDir = resolve(source);
+    if (!existsSync(sourceDir)) {
+      log.error(`Local path "${sourceDir}" does not exist`);
+      process.exit(1);
+    }
+    repoUrl = sourceDir;
+    log.info(`Using local path: ${sourceDir}`);
+  } else if (!isUrl(source)) {
+    // Not a URL and not a local path — look up in registry
     const registry = await fetchRegistry();
     const entry = findPlugin(registry, source);
     if (!entry) {
@@ -70,29 +90,36 @@ export async function add(source, options = {}) {
     log.info(`Resolved "${source}" to ${repoUrl}`);
   }
 
-  const tmpDir = makeTempDir();
-  const spin = spinner(`Cloning ${repoUrl}...`);
-  spin.start();
+  let tmpDir = null;
 
-  try {
-    const gitUrl = repoUrl.endsWith('.git') ? repoUrl : `${repoUrl}.git`;
-    execFileSync('git', ['clone', '--depth', '1', gitUrl, tmpDir], {
-      stdio: 'pipe',
-    });
-    spin.succeed('Repository cloned');
-  } catch (err) {
-    spin.fail('Failed to clone repository');
-    log.error(err.message);
-    rmSync(tmpDir, { recursive: true, force: true });
-    process.exit(1);
+  // Clone if remote URL, otherwise use local path directly
+  if (!sourceDir) {
+    tmpDir = makeTempDir();
+    const spin = spinner(`Cloning ${repoUrl}...`);
+    spin.start();
+
+    try {
+      const gitUrl = repoUrl.endsWith('.git') ? repoUrl : `${repoUrl}.git`;
+      execFileSync('git', ['clone', '--depth', '1', gitUrl, tmpDir], {
+        stdio: 'pipe',
+      });
+      spin.succeed('Repository cloned');
+    } catch (err) {
+      spin.fail('Failed to clone repository');
+      log.error(err.message);
+      rmSync(tmpDir, { recursive: true, force: true });
+      process.exit(1);
+    }
   }
 
+  const searchRoot = sourceDir || tmpDir;
+
   // Find all skill directories
-  const skillDirs = findSkillDirs(tmpDir);
+  const skillDirs = findSkillDirs(searchRoot);
 
   if (!skillDirs.length) {
     log.error('No SKILL.md found in repository');
-    rmSync(tmpDir, { recursive: true, force: true });
+    if (tmpDir) rmSync(tmpDir, { recursive: true, force: true });
     process.exit(1);
   }
 
@@ -117,22 +144,22 @@ export async function add(source, options = {}) {
         const fm = parseFrontmatter(readFileSync(join(d, 'SKILL.md'), 'utf-8'));
         log.dim(`  - ${fm.name || basename(d)}`);
       }
-      rmSync(tmpDir, { recursive: true, force: true });
+      if (tmpDir) rmSync(tmpDir, { recursive: true, force: true });
       process.exit(1);
     }
   } else if (skillDirs.length === 1) {
     targetDir = skillDirs[0];
   } else {
     // Check if root has SKILL.md
-    if (existsSync(join(tmpDir, 'SKILL.md'))) {
-      targetDir = tmpDir;
+    if (existsSync(join(searchRoot, 'SKILL.md'))) {
+      targetDir = searchRoot;
     } else {
       log.warn('Multiple skills found. Use --skill <name> to select one:');
       for (const d of skillDirs) {
         const fm = parseFrontmatter(readFileSync(join(d, 'SKILL.md'), 'utf-8'));
         log.dim(`  - ${fm.name || basename(d)}`);
       }
-      rmSync(tmpDir, { recursive: true, force: true });
+      if (tmpDir) rmSync(tmpDir, { recursive: true, force: true });
       process.exit(1);
     }
   }
@@ -140,19 +167,29 @@ export async function add(source, options = {}) {
   // Parse skill metadata
   const skillMd = readFileSync(join(targetDir, 'SKILL.md'), 'utf-8');
   const frontmatter = parseFrontmatter(skillMd);
-  const skillName = frontmatter.name || options.skill || basename(targetDir === tmpDir ? repoUrl.replace(/\.git$/, '').split('/').pop() : targetDir);
+  const skillName = frontmatter.name || options.skill || basename(targetDir === searchRoot ? repoUrl.replace(/\.git$/, '').split('/').pop() : targetDir);
+
+  // Detect components alongside SKILL.md
+  const components = detectComponents(targetDir);
 
   const skillsDir = getSkillsDir();
   const dest = join(skillsDir, skillName);
 
-  if (existsSync(dest)) {
-    log.warn(`Skill "${skillName}" is already installed at ${dest}`);
+  // Check both locations for existing installation
+  const existing = findInstalledSkill(skillName);
+  if (existing) {
+    log.warn(`Skill "${skillName}" is already installed at ${existing.dir}`);
     log.dim(`Run "claude-plugins skills update ${skillName}" to update it`);
-    rmSync(tmpDir, { recursive: true, force: true });
+    if (tmpDir) rmSync(tmpDir, { recursive: true, force: true });
+    return;
+  }
+
+  if (existsSync(dest)) {
+    log.warn(`"${skillName}" already exists at ${dest}`);
+    if (tmpDir) rmSync(tmpDir, { recursive: true, force: true });
     return;
   }
 
-  // Copy skill files
   const spin2 = spinner(`Installing skill "${skillName}"...`);
   spin2.start();
 
@@ -165,6 +202,9 @@ export async function add(source, options = {}) {
       rmSync(gitInDest, { recursive: true, force: true });
     }
 
+    // Copy slash commands to ~/.claude/commands/ so Claude Code discovers them
+    const installedCommands = installCommands(dest, skillName);
+
     // Write origin metadata
     writeFileSync(
       join(dest, '.origin.json'),
@@ -172,6 +212,8 @@ export async function add(source, options = {}) {
         {
           repository: repoUrl,
           skill: options.skill || null,
+          components,
+          installedCommands,
           installedAt: new Date().toISOString(),
         },
         null,
@@ -184,11 +226,53 @@ export async function add(source, options = {}) {
     if (frontmatter.description) {
       log.dim(`  ${frontmatter.description}`);
     }
+
+    if (installedCommands.length) {
+      log.info(`Commands: ${installedCommands.map((c) => `/${c}`).join(', ')}`);
+      log.dim(`  Copied to ${getCommandsDir()}`);
+    }
+
+    if (components.length > 1) {
+      log.info(`Detected: ${components.join(', ')}`);
+    }
+
     log.dim('\nRestart Claude Code to load the skill.');
   } catch (err) {
     spin2.fail(`Failed to install skill "${skillName}"`);
     log.error(err.message);
   } finally {
-    rmSync(tmpDir, { recursive: true, force: true });
+    if (tmpDir) rmSync(tmpDir, { recursive: true, force: true });
+  }
+}
+
+/**
+ * Copy command .md files from skill's commands/ dir to ~/.claude/commands/.
+ * Returns array of installed command names (without extension).
+ */
+function installCommands(skillDir, skillName) {
+  const cmdsDir = join(skillDir, 'commands');
+  if (!existsSync(cmdsDir)) return [];
+
+  const commandsDir = getCommandsDir();
+  const installed = [];
+
+  try {
+    const files = readdirSync(cmdsDir).filter((f) => f.endsWith('.md'));
+    for (const file of files) {
+      const src = join(cmdsDir, file);
+      const destFile = join(commandsDir, file);
+
+      if (existsSync(destFile)) {
+        log.warn(`Command "${file}" already exists in ${commandsDir}, skipping`);
+        continue;
+      }
+
+      copyFileSync(src, destFile);
+      installed.push(file.replace(/\.md$/, ''));
+    }
+  } catch {
+    // ignore errors reading commands dir
   }
+
+  return installed;
 }

package/src/commands/skills/list.js

@@ -1,52 +1,25 @@
-import { readdirSync, existsSync, readFileSync } from 'node:fs';
-import { join } from 'node:path';
-import chalk from 'chalk';
-import { getSkillsDir } from '../../config.js';
-import { log, formatTable, truncate } from '../../utils.js';
-import { parseFrontmatter } from './add.js';
-
-export async function list() {
-  const skillsDir = getSkillsDir();
-  const entries = readdirSync(skillsDir, { withFileTypes: true }).filter(
-    (e) => e.isDirectory()
-  );
-
-  if (!entries.length) {
-    log.info('No skills installed');
-    log.dim('Run "claude-plugins skills add <source>" to install a skill');
-    return;
-  }
-
-  console.log(chalk.bold(`\n  ${entries.length} skill${entries.length === 1 ? '' : 's'} installed\n`));
-
-  const rows = entries.map((entry) => {
-    const dir = join(skillsDir, entry.name);
-    const skillMdPath = join(dir, 'SKILL.md');
-    const originPath = join(dir, '.origin.json');
-    let description = '';
-    let repo = '-';
-
-    if (existsSync(skillMdPath)) {
-      try {
-        const fm = parseFrontmatter(readFileSync(skillMdPath, 'utf-8'));
-        description = fm.description || '';
-      } catch {
-        // ignore
-      }
-    }
-
-    if (existsSync(originPath)) {
-      try {
-        const origin = JSON.parse(readFileSync(originPath, 'utf-8'));
-        repo = origin.repository || '-';
-      } catch {
-        // ignore
-      }
-    }
-
-    return [entry.name, truncate(description, 50), truncate(repo, 40)];
-  });
-
-  formatTable(rows, ['Name', 'Description', 'Repository']);
-  console.log();
-}
+import chalk from 'chalk';
+import { log, formatTable, truncate } from '../../utils.js';
+import { listAllSkills } from './resolve.js';
+
+export async function list() {
+  const skills = listAllSkills();
+
+  if (!skills.length) {
+    log.info('No skills installed');
+    log.dim('Run "claude-plugins skills add <source>" to install a skill');
+    return;
+  }
+
+  console.log(chalk.bold(`\n  ${skills.length} skill${skills.length === 1 ? '' : 's'} installed\n`));
+
+  const rows = skills.map(({ name, meta }) => {
+    const cmds = meta.commands.length
+      ? meta.commands.map((c) => `/${c}`).join(', ')
+      : '';
+    return [name, truncate(meta.description, 45), cmds, truncate(meta.repository, 35)];
+  });
+
+  formatTable(rows, ['Name', 'Description', 'Commands', 'Repository']);
+  console.log();
+}

package/src/commands/skills/remove.js

@@ -1,27 +1,45 @@
-import { existsSync, rmSync } from 'node:fs';
-import { join } from 'node:path';
-import { getSkillsDir } from '../../config.js';
-import { log, spinner } from '../../utils.js';
-
-export async function remove(name) {
-  const dest = join(getSkillsDir(), name);
-
-  if (!existsSync(dest)) {
-    log.error(`Skill "${name}" is not installed`);
-    log.dim('Run "claude-plugins skills list" to see installed skills');
-    process.exit(1);
-  }
-
-  const spin = spinner(`Removing skill "${name}"...`);
-  spin.start();
-
-  try {
-    rmSync(dest, { recursive: true, force: true });
-    spin.succeed(`Removed skill "${name}"`);
-    log.dim('Restart Claude Code to apply changes.');
-  } catch (err) {
-    spin.fail(`Failed to remove skill "${name}"`);
-    log.error(err.message);
-    process.exit(1);
-  }
-}
+import { existsSync, rmSync } from 'node:fs';
+import { join } from 'node:path';
+import { getCommandsDir } from '../../config.js';
+import { log, spinner } from '../../utils.js';
+import { findInstalledSkill, readOrigin } from './resolve.js';
+
+export async function remove(name) {
+  const found = findInstalledSkill(name);
+
+  if (!found) {
+    log.error(`Skill "${name}" is not installed`);
+    log.dim('Run "claude-plugins skills list" to see installed skills');
+    process.exit(1);
+  }
+
+  const spin = spinner(`Removing skill "${name}"...`);
+  spin.start();
+
+  try {
+    // Clean up commands that were copied to ~/.claude/commands/
+    const origin = readOrigin(found.dir);
+    if (origin && origin.installedCommands?.length) {
+      const commandsDir = getCommandsDir();
+      for (const cmd of origin.installedCommands) {
+        const cmdFile = join(commandsDir, `${cmd}.md`);
+        if (existsSync(cmdFile)) {
+          rmSync(cmdFile);
+        }
+      }
+    }
+
+    rmSync(found.dir, { recursive: true, force: true });
+    spin.succeed(`Removed skill "${name}"`);
+
+    if (origin?.installedCommands?.length) {
+      log.dim(`  Also removed commands: ${origin.installedCommands.map((c) => `/${c}`).join(', ')}`);
+    }
+
+    log.dim('Restart Claude Code to apply changes.');
+  } catch (err) {
+    spin.fail(`Failed to remove skill "${name}"`);
+    log.error(err.message);
+    process.exit(1);
+  }
+}

package/src/commands/skills/resolve.js

@@ -0,0 +1,104 @@
+import { existsSync, readFileSync, readdirSync } from 'node:fs';
+import { join } from 'node:path';
+import { getSkillsDir } from '../../config.js';
+import { parseFrontmatter } from './add.js';
+
+/**
+ * Component directories that can accompany a SKILL.md.
+ */
+export const COMPONENT_DIRS = ['commands', 'hooks', 'agents'];
+
+/**
+ * Detect which components exist in a directory.
+ * Returns an array of found component names.
+ */
+export function detectComponents(dir) {
+  const found = [];
+  if (existsSync(join(dir, 'SKILL.md'))) found.push('skill');
+  for (const name of COMPONENT_DIRS) {
+    if (existsSync(join(dir, name))) found.push(name);
+  }
+  return found;
+}
+
+/**
+ * Read .origin.json from a skill directory.
+ */
+export function readOrigin(dir) {
+  const originPath = join(dir, '.origin.json');
+  if (!existsSync(originPath)) return null;
+  try {
+    return JSON.parse(readFileSync(originPath, 'utf-8'));
+  } catch {
+    return null;
+  }
+}
+
+/**
+ * Read skill metadata from a directory (SKILL.md frontmatter + .origin.json).
+ */
+export function readSkillMeta(dir, dirName) {
+  const skillMdPath = join(dir, 'SKILL.md');
+  const meta = { name: dirName, description: '', repository: '-', commands: [] };
+
+  if (existsSync(skillMdPath)) {
+    try {
+      const fm = parseFrontmatter(readFileSync(skillMdPath, 'utf-8'));
+      meta.name = fm.name || dirName;
+      meta.description = fm.description || '';
+    } catch {
+      // ignore
+    }
+  }
+
+  const origin = readOrigin(dir);
+  if (origin) {
+    meta.repository = origin.repository || '-';
+    meta.skill = origin.skill || null;
+    meta.commands = origin.installedCommands || [];
+  }
+
+  return meta;
+}
+
+/**
+ * Find a skill by name in ~/.claude/skills/.
+ * Returns { dir, location } or null.
+ */
+export function findInstalledSkill(name) {
+  const skillsDir = getSkillsDir();
+  const skillPath = join(skillsDir, name);
+
+  if (existsSync(skillPath) && existsSync(join(skillPath, 'SKILL.md'))) {
+    return { dir: skillPath, location: 'skills' };
+  }
+
+  return null;
+}
+
+/**
+ * List all installed skills from ~/.claude/skills/.
+ * Returns array of { name, dir, meta }.
+ */
+export function listAllSkills() {
+  const skillsDir = getSkillsDir();
+  const results = [];
+
+  try {
+    const entries = readdirSync(skillsDir, { withFileTypes: true });
+    for (const entry of entries) {
+      if (!entry.isDirectory()) continue;
+      const dir = join(skillsDir, entry.name);
+      if (!existsSync(join(dir, 'SKILL.md'))) continue;
+      results.push({
+        name: entry.name,
+        dir,
+        meta: readSkillMeta(dir, entry.name),
+      });
+    }
+  } catch {
+    // directory might not exist yet
+  }
+
+  return results;
+}