@biggora/claude-plugins 1.0.0 → 1.1.0

package/registry/registry.json

@@ -1,7 +1,7 @@
 {
   "$schema": "./schema.json",
   "version": "1.0.0",
-  "updated": "2026-02-08",
+  "updated": "2026-03-06",
   "plugins": [
     {
       "name": "code-optimizer",
@@ -44,6 +44,171 @@
       "license": "MIT",
       "commands": ["/fix-typescript-eslint"],
       "category": "code-quality"
+    },
+    {
+      "name": "screen-recording",
+      "version": "1.0.0",
+      "description": "Autonomous video creation skill — product demos, presentation videos, UI walkthroughs, and narrated screencasts via Pillow, MoviePy, and pyttsx3",
+      "author": {
+        "name": "biggora",
+        "url": "https://github.com/biggora"
+      },
+      "repository": "https://github.com/biggora/screen-recording",
+      "keywords": ["video", "screencast", "demo", "recording", "narration", "moviepy"],
+      "license": "MIT",
+      "commands": [],
+      "category": "other",
+      "type": "skill"
+    },
+    {
+      "name": "text-to-speech",
+      "version": "1.0.0",
+      "description": "Converts text to speech audio files autonomously using pyttsx3, espeak-ng, Kokoro ONNX, or cloud TTS engines with multilingual support",
+      "author": {
+        "name": "biggora",
+        "url": "https://github.com/biggora"
+      },
+      "repository": "https://github.com/biggora/text-to-speech",
+      "keywords": ["tts", "audio", "narration", "speech", "espeak", "voiceover"],
+      "license": "MIT",
+      "commands": [],
+      "category": "other",
+      "type": "skill"
+    },
+    {
+      "name": "youtube-thumbnail",
+      "version": "1.0.0",
+      "description": "Generates professional YouTube thumbnails in 11 strategic styles with auto-detection of AI image backends and Pillow compositing",
+      "author": {
+        "name": "biggora",
+        "url": "https://github.com/biggora"
+      },
+      "repository": "https://github.com/biggora/youtube-thumbnail",
+      "keywords": ["youtube", "thumbnail", "image", "design", "pillow", "ai-image"],
+      "license": "MIT",
+      "commands": [],
+      "category": "other",
+      "type": "skill"
+    },
+    {
+      "name": "youtube-search",
+      "version": "1.0.0",
+      "description": "Search YouTube for videos, channels, playlists and extract metadata, transcripts, and analytics via multiple API methods",
+      "author": {
+        "name": "biggora",
+        "url": "https://github.com/biggora"
+      },
+      "repository": "https://github.com/biggora/youtube-search",
+      "keywords": ["youtube", "search", "video", "metadata", "transcript", "analytics"],
+      "license": "MIT",
+      "commands": [],
+      "category": "workflow",
+      "type": "skill"
+    },
+    {
+      "name": "wp-rest-api",
+      "version": "1.0.0",
+      "description": "Build, extend, and debug WordPress REST API endpoints — routes, controllers, schema validation, authentication, and custom fields",
+      "author": {
+        "name": "biggora",
+        "url": "https://github.com/biggora"
+      },
+      "repository": "https://github.com/biggora/wp-rest-api",
+      "keywords": ["wordpress", "rest-api", "php", "endpoints", "wp-cli", "custom-post-types"],
+      "license": "MIT",
+      "commands": [],
+      "category": "workflow",
+      "type": "skill"
+    },
+    {
+      "name": "notebook-lm",
+      "version": "1.0.0",
+      "description": "Automate Google NotebookLM — create notebooks, add sources, chat, generate audio/video overviews, quizzes, reports, and mind maps",
+      "author": {
+        "name": "biggora",
+        "url": "https://github.com/biggora"
+      },
+      "repository": "https://github.com/biggora/notebook-lm",
+      "keywords": ["notebooklm", "google", "research", "podcast", "audio", "automation"],
+      "license": "MIT",
+      "commands": [],
+      "category": "workflow",
+      "type": "skill"
+    },
+    {
+      "name": "codex-cli",
+      "version": "1.0.0",
+      "description": "Install, configure, and automate tasks using OpenAI Codex CLI — approval modes, sandbox policies, MCP servers, and CI integration",
+      "author": {
+        "name": "biggora",
+        "url": "https://github.com/biggora"
+      },
+      "repository": "https://github.com/biggora/codex-cli",
+      "keywords": ["openai", "codex", "cli", "automation", "ci-cd", "agent"],
+      "license": "MIT",
+      "commands": [],
+      "category": "devops",
+      "type": "skill"
+    },
+    {
+      "name": "gemini-cli",
+      "version": "1.0.0",
+      "description": "Install, configure, and script with Gemini CLI — headless prompts, MCP servers, custom slash commands, extensions, and CI automation",
+      "author": {
+        "name": "biggora",
+        "url": "https://github.com/biggora"
+      },
+      "repository": "https://github.com/biggora/gemini-cli",
+      "keywords": ["gemini", "google", "cli", "automation", "mcp", "scripting"],
+      "license": "MIT",
+      "commands": [],
+      "category": "devops",
+      "type": "skill"
+    },
+    {
+      "name": "tm-search",
+      "version": "1.0.0",
+      "description": "Search, validate, and check availability of US trademarks via USPTO APIs — keyword search, batch validation, and status lookup",
+      "author": {
+        "name": "biggora",
+        "url": "https://github.com/biggora"
+      },
+      "repository": "https://github.com/biggora/tm-search",
+      "keywords": ["trademark", "uspto", "brand", "search", "validation", "legal"],
+      "license": "MIT",
+      "commands": [],
+      "category": "workflow",
+      "type": "skill"
+    },
+    {
+      "name": "test-web-ui",
+      "version": "1.0.0",
+      "description": "Automated web QA — discovers site structure, generates use cases and test plans, runs Playwright tests, and produces HTML reports",
+      "author": {
+        "name": "biggora",
+        "url": "https://github.com/biggora"
+      },
+      "repository": "https://github.com/biggora/test-web-ui",
+      "keywords": ["qa", "playwright", "web-testing", "automation", "test-report", "e2e"],
+      "license": "MIT",
+      "commands": [],
+      "category": "testing",
+      "type": "skill"
+    },
+    {
+      "name": "test-mobile-app",
+      "version": "1.0.0",
+      "description": "Automated mobile app testing — analyzes APK/source, generates use cases, runs Appium tests on emulator, and produces QA reports",
+      "author": {
+        "name": "biggora",
+        "url": "https://github.com/biggora"
+      },
+      "repository": "https://github.com/biggora/test-mobile-app",
+      "keywords": ["mobile", "appium", "android", "qa", "testing", "automation"],
+      "license": "MIT",
+      "commands": [],
+      "category": "testing",
+      "type": "skill"
     }
   ]
 }

package/registry/schema.json

@@ -41,6 +41,16 @@
           "category": {
             "type": "string",
             "enum": ["code-quality", "workflow", "testing", "documentation", "security", "devops", "other"]
+          },
+          "type": {
+            "type": "string",
+            "enum": ["plugin", "skill"],
+            "default": "plugin",
+            "description": "Whether this entry is a full plugin or a standalone skill"
+          },
+          "skillsDir": {
+            "type": "string",
+            "description": "Subdirectory path for multi-skill repos"
           }
         }
       }

package/src/commands/skills/add.js

@@ -0,0 +1,194 @@
+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 { tmpdir } from 'node:os';
+import { getSkillsDir } from '../../config.js';
+import { fetchRegistry, findPlugin } from '../../registry.js';
+import { log, spinner } from '../../utils.js';
+
+export function parseFrontmatter(content) {
+  const match = content.match(/^---\r?\n([\s\S]*?)\r?\n---/);
+  if (!match) return {};
+  const meta = {};
+  for (const line of match[1].split(/\r?\n/)) {
+    const idx = line.indexOf(':');
+    if (idx > 0) {
+      const key = line.slice(0, idx).trim();
+      const val = line.slice(idx + 1).trim();
+      meta[key] = val;
+    }
+  }
+  return meta;
+}
+
+export function findSkillDirs(dir, depth = 0, maxDepth = 3) {
+  const results = [];
+  if (depth > maxDepth) return results;
+
+  if (existsSync(join(dir, 'SKILL.md'))) {
+    results.push(dir);
+  }
+
+  let entries;
+  try {
+    entries = readdirSync(dir, { withFileTypes: true });
+  } catch {
+    return results;
+  }
+
+  for (const entry of entries) {
+    if (!entry.isDirectory() || entry.name.startsWith('.') || entry.name === 'node_modules') continue;
+    results.push(...findSkillDirs(join(dir, entry.name), depth + 1, maxDepth));
+  }
+
+  return results;
+}
+
+function isUrl(str) {
+  return str.startsWith('http://') || str.startsWith('https://') || str.startsWith('git@');
+}
+
+function makeTempDir() {
+  const dir = join(tmpdir(), `claude-skill-${Date.now()}`);
+  mkdirSync(dir, { recursive: true });
+  return dir;
+}
+
+export async function add(source, options = {}) {
+  let repoUrl = source;
+
+  // If not a URL, look up in registry
+  if (!isUrl(source)) {
+    const registry = await fetchRegistry();
+    const entry = findPlugin(registry, source);
+    if (!entry) {
+      log.error(`Skill "${source}" not found in registry`);
+      log.dim('Run "claude-plugins search <query>" to find plugins and skills');
+      process.exit(1);
+    }
+    repoUrl = entry.repository;
+    log.info(`Resolved "${source}" to ${repoUrl}`);
+  }
+
+  const 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);
+  }
+
+  // Find all skill directories
+  const skillDirs = findSkillDirs(tmpDir);
+
+  if (!skillDirs.length) {
+    log.error('No SKILL.md found in repository');
+    rmSync(tmpDir, { recursive: true, force: true });
+    process.exit(1);
+  }
+
+  let targetDir;
+
+  if (options.skill) {
+    // Find the skill matching --skill name
+    targetDir = skillDirs.find((d) => {
+      const fm = parseFrontmatter(readFileSync(join(d, 'SKILL.md'), 'utf-8'));
+      return (fm.name || basename(d)).toLowerCase() === options.skill.toLowerCase();
+    });
+
+    if (!targetDir) {
+      // Also try matching by directory name
+      targetDir = skillDirs.find((d) => basename(d).toLowerCase() === options.skill.toLowerCase());
+    }
+
+    if (!targetDir) {
+      log.error(`Skill "${options.skill}" not found in repository`);
+      log.info('Available skills:');
+      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 });
+      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;
+    } 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 });
+      process.exit(1);
+    }
+  }
+
+  // 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 skillsDir = getSkillsDir();
+  const dest = join(skillsDir, skillName);
+
+  if (existsSync(dest)) {
+    log.warn(`Skill "${skillName}" is already installed at ${dest}`);
+    log.dim(`Run "claude-plugins skills update ${skillName}" to update it`);
+    rmSync(tmpDir, { recursive: true, force: true });
+    return;
+  }
+
+  // Copy skill files
+  const spin2 = spinner(`Installing skill "${skillName}"...`);
+  spin2.start();
+
+  try {
+    cpSync(targetDir, dest, { recursive: true });
+
+    // Remove .git directory if copied from root
+    const gitInDest = join(dest, '.git');
+    if (existsSync(gitInDest)) {
+      rmSync(gitInDest, { recursive: true, force: true });
+    }
+
+    // Write origin metadata
+    writeFileSync(
+      join(dest, '.origin.json'),
+      JSON.stringify(
+        {
+          repository: repoUrl,
+          skill: options.skill || null,
+          installedAt: new Date().toISOString(),
+        },
+        null,
+        2
+      )
+    );
+
+    spin2.succeed(`Installed skill "${skillName}"`);
+    log.dim(`  ${dest}`);
+    if (frontmatter.description) {
+      log.dim(`  ${frontmatter.description}`);
+    }
+    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 });
+  }
+}

package/src/commands/skills/list.js

@@ -0,0 +1,52 @@
+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();
+}

package/src/commands/skills/remove.js

@@ -0,0 +1,27 @@
+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);
+  }
+}

package/src/commands/skills/update.js

@@ -0,0 +1,74 @@
+import { existsSync, readFileSync, readdirSync } from 'node:fs';
+import { join } from 'node:path';
+import { getSkillsDir } from '../../config.js';
+import { log, spinner } from '../../utils.js';
+import { add } from './add.js';
+import { remove } from './remove.js';
+
+function readOrigin(skillDir) {
+  const originPath = join(skillDir, '.origin.json');
+  if (!existsSync(originPath)) return null;
+  try {
+    return JSON.parse(readFileSync(originPath, 'utf-8'));
+  } catch {
+    return null;
+  }
+}
+
+async function updateOne(name) {
+  const skillsDir = getSkillsDir();
+  const dest = join(skillsDir, name);
+
+  if (!existsSync(dest)) {
+    log.error(`Skill "${name}" is not installed`);
+    return false;
+  }
+
+  const origin = readOrigin(dest);
+  if (!origin || !origin.repository) {
+    log.warn(`Skill "${name}" has no origin metadata, skipping`);
+    return false;
+  }
+
+  const spin = spinner(`Updating skill "${name}"...`);
+  spin.start();
+  spin.stop();
+
+  try {
+    // Remove and re-add
+    await remove(name);
+    await add(origin.repository, { skill: origin.skill || undefined });
+    return true;
+  } catch (err) {
+    log.error(`Failed to update skill "${name}": ${err.message}`);
+    return false;
+  }
+}
+
+export async function update(name) {
+  if (name) {
+    await updateOne(name);
+    return;
+  }
+
+  const skillsDir = getSkillsDir();
+  const entries = readdirSync(skillsDir, { withFileTypes: true }).filter(
+    (e) => e.isDirectory()
+  );
+
+  if (!entries.length) {
+    log.info('No skills installed');
+    return;
+  }
+
+  log.info(`Updating ${entries.length} skill${entries.length === 1 ? '' : 's'}...\n`);
+
+  let updated = 0;
+  for (const entry of entries) {
+    if (await updateOne(entry.name)) updated++;
+  }
+
+  console.log();
+  log.success(`${updated}/${entries.length} skills updated`);
+  log.dim('Restart Claude Code to apply changes.');
+}

package/src/config.js

@@ -6,6 +6,7 @@ const home = homedir();
 const isWindows = process.platform === 'win32';
 
 export const PLUGINS_DIR = join(home, '.claude', 'plugins');
+export const SKILLS_DIR = join(home, '.claude', 'skills');
 export const CACHE_DIR = join(home, '.claude', '.cache', 'claude-plugins');
 export const CACHE_TTL = 1000 * 60 * 15; // 15 minutes
 export const REGISTRY_URL =
@@ -22,6 +23,10 @@ export function getPluginsDir() {
   return ensureDir(PLUGINS_DIR);
 }
 
+export function getSkillsDir() {
+  return ensureDir(SKILLS_DIR);
+}
+
 export function getCacheDir() {
   return ensureDir(CACHE_DIR);
 }