ai-agent-skills 1.6.2 → 1.8.0

package/README.md

@@ -11,7 +11,7 @@
 
 <p align="center">
   <img src="https://img.shields.io/badge/skills-40-blue?style=flat-square" alt="Skills" />
-  <img src="https://img.shields.io/badge/agents-10+-green?style=flat-square" alt="Compatible Agents" />
+  <img src="https://img.shields.io/badge/agents-11+-green?style=flat-square" alt="Compatible Agents" />
   <img src="https://img.shields.io/badge/license-MIT-brightgreen?style=flat-square" alt="License" />
   <img src="https://img.shields.io/npm/v/ai-agent-skills?style=flat-square&color=red" alt="npm" />
   <img src="https://img.shields.io/npm/dt/ai-agent-skills?style=flat-square&color=orange" alt="Downloads" />
@@ -46,17 +46,17 @@ npx ai-agent-skills install anthropics/skills/pdf    # specific skill
 npx ai-agent-skills install ./my-custom-skill
 ```
 
-**One command. Every agent.** By default, skills install to Claude Code, Cursor, Codex, Amp, VS Code, Copilot, Goose, Letta, and OpenCode simultaneously.
+**One command. Every agent.** By default, skills install to Claude Code, Cursor, Codex, Amp, VS Code, Copilot, Gemini CLI, Goose, Letta, and OpenCode simultaneously.
 
 ## Why This Exists
 
 Every major AI coding agent now supports skills. But they're scattered everywhere.
 
-This repo curates the best in one place. Quality over quantity. All skills follow the [Agent Skills spec](https://agentskills.io).
+We also created our own repo to cureate the best in one place. Quality over quantity https://www.skillcreator.ai/explore  All skills follow the [Agent Skills spec](https://agentskills.io).
 
 ## Compatible Agents
 
-Works with **Claude Code**, **Cursor**, **Codex**, **Amp**, **VS Code**, **GitHub Copilot**, **Goose**, **Letta**, and **OpenCode**.
+Works with **Claude Code**, **Cursor**, **Codex**, **Amp**, **VS Code**, **GitHub Copilot**, **Gemini CLI**, **Goose**, **Letta**, and **OpenCode**.
 
 ## Available Skills
 
@@ -162,6 +162,7 @@ By default, `install` targets **all agents**. Use `--agent <name>` to install to
 | Codex | `--agent codex` | `~/.codex/skills/` |
 | Amp | `--agent amp` | `~/.amp/skills/` |
 | VS Code / Copilot | `--agent vscode` | `.github/skills/` |
+| Gemini CLI | `--agent gemini` | `~/.gemini/skills/` |
 | Goose | `--agent goose` | `~/.config/goose/skills/` |
 | OpenCode | `--agent opencode` | `~/.opencode/skill/` |
 | Letta | `--agent letta` | `~/.letta/skills/` |

package/cli.js

@@ -24,9 +24,10 @@ const AGENT_PATHS = {
   copilot: path.join(process.cwd(), '.github', 'skills'),
   project: path.join(process.cwd(), '.skills'),
   goose: path.join(os.homedir(), '.config', 'goose', 'skills'),
-  opencode: path.join(os.homedir(), '.opencode', 'skill'),
+  opencode: path.join(os.homedir(), '.config', 'opencode', 'skill'),
   codex: path.join(os.homedir(), '.codex', 'skills'),
   letta: path.join(os.homedir(), '.letta', 'skills'),
+  gemini: path.join(os.homedir(), '.gemini', 'skills'),
 };
 
 const colors = {
@@ -70,6 +71,41 @@ function saveConfig(config) {
   }
 }
 
+// ============ SKILL METADATA SUPPORT ============
+
+const SKILL_META_FILE = '.skill-meta.json';
+
+function writeSkillMeta(skillPath, meta) {
+  try {
+    const metaPath = path.join(skillPath, SKILL_META_FILE);
+    const now = new Date().toISOString();
+    const metadata = {
+      ...meta,
+      // Preserve original installedAt if it exists, otherwise set it
+      installedAt: meta.installedAt || now,
+      // Always update the updatedAt timestamp
+      updatedAt: now
+    };
+    fs.writeFileSync(metaPath, JSON.stringify(metadata, null, 2));
+    return true;
+  } catch (e) {
+    // Non-fatal - skill still works without metadata
+    return false;
+  }
+}
+
+function readSkillMeta(skillPath) {
+  try {
+    const metaPath = path.join(skillPath, SKILL_META_FILE);
+    if (fs.existsSync(metaPath)) {
+      return JSON.parse(fs.readFileSync(metaPath, 'utf8'));
+    }
+  } catch (e) {
+    // Ignore - treat as legacy skill
+  }
+  return null;
+}
+
 // ============ SECURITY VALIDATION ============
 
 function validateSkillName(name) {
@@ -367,6 +403,12 @@ function installSkill(skillName, agent = 'claude', dryRun = false) {
 
     copyDir(sourcePath, destPath);
 
+    // Write metadata for update tracking
+    writeSkillMeta(destPath, {
+      source: 'registry',
+      name: skillName
+    });
+
     success(`\nInstalled: ${skillName}`);
     info(`Agent: ${agent}`);
     info(`Location: ${destPath}`);
@@ -393,7 +435,8 @@ function showAgentInstructions(agent, skillName, destPath) {
     project: `The skill is installed in .skills/ in your current directory.\nThis makes it portable across all compatible agents.`,
     letta: `The skill is now available in Letta.`,
     goose: `The skill is now available in Goose.`,
-    opencode: `The skill is now available in OpenCode.`
+    opencode: `The skill is now available in OpenCode.`,
+    gemini: `The skill is now available in Gemini CLI.\nMake sure Agent Skills is enabled in your Gemini CLI settings.`
   };
 
   log(`${colors.dim}${instructions[agent] || `The skill is ready to use with ${agent}.`}${colors.reset}`);
@@ -474,32 +517,133 @@ function listInstalledSkills(agent = 'claude') {
   log(`${colors.dim}Uninstall: npx ai-agent-skills uninstall <name> --agent ${agent}${colors.reset}`);
 }
 
-function updateSkill(skillName, agent = 'claude', dryRun = false) {
+// Update from bundled registry
+function updateFromRegistry(skillName, agent, destPath, dryRun) {
+  const sourcePath = path.join(SKILLS_DIR, skillName);
+
+  if (!fs.existsSync(sourcePath)) {
+    error(`Skill "${skillName}" not found in repository.`);
+    return false;
+  }
+
+  if (dryRun) {
+    log(`\n${colors.bold}Dry Run${colors.reset} (no changes made)\n`);
+    info(`Would update: ${skillName} (from registry)`);
+    info(`Agent: ${agent}`);
+    info(`Path: ${destPath}`);
+    return true;
+  }
+
   try {
-    validateSkillName(skillName);
+    fs.rmSync(destPath, { recursive: true });
+    copyDir(sourcePath, destPath);
+
+    // Write metadata
+    writeSkillMeta(destPath, {
+      source: 'registry',
+      name: skillName
+    });
+
+    success(`\nUpdated: ${skillName}`);
+    info(`Agent: ${agent}`);
+    info(`Location: ${destPath}`);
+    return true;
   } catch (e) {
-    error(e.message);
+    error(`Failed to update skill: ${e.message}`);
     return false;
   }
+}
 
-  const sourcePath = path.join(SKILLS_DIR, skillName);
-  const destDir = AGENT_PATHS[agent] || AGENT_PATHS.claude;
-  const destPath = path.join(destDir, skillName);
+// Update from GitHub repository
+function updateFromGitHub(meta, skillName, agent, destPath, dryRun) {
+  const { execFileSync } = require('child_process');
+  const repo = meta.repo;
+
+  // Validate repo format
+  if (!repo || typeof repo !== 'string' || !repo.includes('/')) {
+    error(`Invalid repository in metadata: ${repo}`);
+    error(`Try reinstalling the skill from GitHub.`);
+    return false;
+  }
+
+  if (dryRun) {
+    log(`\n${colors.bold}Dry Run${colors.reset} (no changes made)\n`);
+    info(`Would update: ${skillName} (from github:${repo})`);
+    info(`Agent: ${agent}`);
+    info(`Path: ${destPath}`);
+    return true;
+  }
+
+  const tempDir = path.join(os.tmpdir(), `ai-skills-update-${Date.now()}`);
+
+  try {
+    info(`Updating ${skillName} from ${repo}...`);
+    const repoUrl = `https://github.com/${repo}.git`;
+    execFileSync('git', ['clone', '--depth', '1', repoUrl, tempDir], { stdio: 'pipe' });
+
+    // Determine source path in cloned repo
+    let sourcePath;
+    if (meta.isRootSkill) {
+      sourcePath = tempDir;
+    } else if (meta.skillPath) {
+      // Check if skills/ subdirectory exists
+      const skillsSubdir = path.join(tempDir, 'skills', meta.skillPath);
+      const directPath = path.join(tempDir, meta.skillPath);
+      sourcePath = fs.existsSync(skillsSubdir) ? skillsSubdir : directPath;
+    } else {
+      sourcePath = tempDir;
+    }
+
+    if (!fs.existsSync(sourcePath) || !fs.existsSync(path.join(sourcePath, 'SKILL.md'))) {
+      error(`Skill not found in repository ${repo}`);
+      fs.rmSync(tempDir, { recursive: true });
+      return false;
+    }
+
+    fs.rmSync(destPath, { recursive: true });
+    copyDir(sourcePath, destPath);
+
+    // Preserve metadata
+    writeSkillMeta(destPath, meta);
+
+    fs.rmSync(tempDir, { recursive: true });
+
+    success(`\nUpdated: ${skillName}`);
+    info(`Source: github:${repo}`);
+    info(`Agent: ${agent}`);
+    info(`Location: ${destPath}`);
+    return true;
+  } catch (e) {
+    error(`Failed to update from GitHub: ${e.message}`);
+    try { fs.rmSync(tempDir, { recursive: true }); } catch {}
+    return false;
+  }
+}
+
+// Update from local path
+function updateFromLocalPath(meta, skillName, agent, destPath, dryRun) {
+  const sourcePath = meta.path;
+
+  if (!sourcePath || typeof sourcePath !== 'string') {
+    error(`Invalid path in metadata.`);
+    error(`Try reinstalling the skill from the local path.`);
+    return false;
+  }
 
   if (!fs.existsSync(sourcePath)) {
-    error(`Skill "${skillName}" not found in repository.`);
+    error(`Source path no longer exists: ${sourcePath}`);
     return false;
   }
 
-  if (!fs.existsSync(destPath)) {
-    error(`Skill "${skillName}" is not installed for ${agent}.`);
-    log(`\nUse 'install' to add it first.`);
+  // Verify it's still a valid skill directory
+  if (!fs.existsSync(path.join(sourcePath, 'SKILL.md'))) {
+    error(`Source is no longer a valid skill (missing SKILL.md): ${sourcePath}`);
     return false;
   }
 
   if (dryRun) {
     log(`\n${colors.bold}Dry Run${colors.reset} (no changes made)\n`);
-    info(`Would update: ${skillName}`);
+    info(`Would update: ${skillName} (from local:${sourcePath})`);
     info(`Agent: ${agent}`);
     info(`Path: ${destPath}`);
     return true;
@@ -509,16 +653,57 @@ function updateSkill(skillName, agent = 'claude', dryRun = false) {
     fs.rmSync(destPath, { recursive: true });
     copyDir(sourcePath, destPath);
 
+    // Preserve metadata
+    writeSkillMeta(destPath, meta);
+
     success(`\nUpdated: ${skillName}`);
+    info(`Source: local:${sourcePath}`);
     info(`Agent: ${agent}`);
     info(`Location: ${destPath}`);
     return true;
   } catch (e) {
-    error(`Failed to update skill: ${e.message}`);
+    error(`Failed to update from local path: ${e.message}`);
     return false;
   }
 }
 
+function updateSkill(skillName, agent = 'claude', dryRun = false) {
+  try {
+    validateSkillName(skillName);
+  } catch (e) {
+    error(e.message);
+    return false;
+  }
+
+  const destDir = AGENT_PATHS[agent] || AGENT_PATHS.claude;
+  const destPath = path.join(destDir, skillName);
+
+  if (!fs.existsSync(destPath)) {
+    error(`Skill "${skillName}" is not installed for ${agent}.`);
+    log(`\nUse 'install' to add it first.`);
+    return false;
+  }
+
+  // Read metadata to determine source
+  const meta = readSkillMeta(destPath);
+
+  if (!meta) {
+    // Legacy skill without metadata - try registry
+    return updateFromRegistry(skillName, agent, destPath, dryRun);
+  }
+
+  // Route to correct update method based on source
+  switch (meta.source) {
+    case 'github':
+      return updateFromGitHub(meta, skillName, agent, destPath, dryRun);
+    case 'local':
+      return updateFromLocalPath(meta, skillName, agent, destPath, dryRun);
+    case 'registry':
+    default:
+      return updateFromRegistry(skillName, agent, destPath, dryRun);
+  }
+}
+
 function updateAllSkills(agent = 'claude', dryRun = false) {
   const installed = getInstalledSkills(agent);
 
@@ -910,6 +1095,14 @@ async function installFromGitHub(source, agent = 'claude', dryRun = false) {
       }
 
       copyDir(skillPath, destPath);
+
+      // Write metadata for update tracking
+      writeSkillMeta(destPath, {
+        source: 'github',
+        repo: `${owner}/${repo}`,
+        skillPath: skillName
+      });
+
       success(`\nInstalled: ${skillName} from ${owner}/${repo}`);
       info(`Location: ${destPath}`);
     } else if (isRootSkill) {
@@ -933,6 +1126,14 @@ async function installFromGitHub(source, agent = 'claude', dryRun = false) {
       }
 
       copyDir(tempDir, destPath);
+
+      // Write metadata for update tracking
+      writeSkillMeta(destPath, {
+        source: 'github',
+        repo: `${owner}/${repo}`,
+        isRootSkill: true
+      });
+
       success(`\nInstalled: ${skillName} from ${owner}/${repo}`);
       info(`Location: ${destPath}`);
     } else {
@@ -952,6 +1153,14 @@ async function installFromGitHub(source, agent = 'claude', dryRun = false) {
             }
 
             copyDir(skillPath, destPath);
+
+            // Write metadata for update tracking
+            writeSkillMeta(destPath, {
+              source: 'github',
+              repo: `${owner}/${repo}`,
+              skillPath: entry.name
+            });
+
             log(`  ${colors.green}✓${colors.reset} ${entry.name}`);
             installed++;
           }
@@ -1010,6 +1219,13 @@ function installFromLocalPath(source, agent = 'claude', dryRun = false) {
     }
 
     copyDir(sourcePath, destPath);
+
+    // Write metadata for update tracking
+    writeSkillMeta(destPath, {
+      source: 'local',
+      path: sourcePath
+    });
+
     success(`\nInstalled: ${skillName} from local path`);
     info(`Location: ${destPath}`);
   } else {
@@ -1029,6 +1245,13 @@ function installFromLocalPath(source, agent = 'claude', dryRun = false) {
           }
 
           copyDir(skillPath, destPath);
+
+          // Write metadata for update tracking
+          writeSkillMeta(destPath, {
+            source: 'local',
+            path: skillPath
+          });
+
           log(`  ${colors.green}✓${colors.reset} ${entry.name}`);
           installed++;
         }
@@ -1090,6 +1313,7 @@ ${colors.bold}Agents:${colors.reset} (install targets ALL by default)
   ${colors.cyan}amp${colors.reset}      ~/.amp/skills/
   ${colors.cyan}vscode${colors.reset}   .github/skills/ (project)
   ${colors.cyan}copilot${colors.reset}  .github/skills/ (alias for vscode)
+  ${colors.cyan}gemini${colors.reset}   ~/.gemini/skills/
   ${colors.cyan}goose${colors.reset}    ~/.config/goose/skills/
   ${colors.cyan}opencode${colors.reset} ~/.opencode/skill/
   ${colors.cyan}letta${colors.reset}    ~/.letta/skills/

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "ai-agent-skills",
-  "version": "1.6.2",
-  "description": "Install curated AI agent skills with one command. Works with Claude Code, Cursor, Amp, VS Code, and all Agent Skills compatible tools.",
+  "version": "1.8.0",
+  "description": "Install curated AI agent skills with one command. Works with Claude Code, Cursor, Codex, Gemini CLI, VS Code, Copilot, and 11+ agents.",
   "main": "cli.js",
   "bin": {
     "ai-agent-skills": "./cli.js",
@@ -24,6 +24,9 @@
     "skills",
     "claude",
     "cursor",
+    "codex",
+    "gemini",
+    "copilot",
     "amp",
     "vscode",
     "mcp"