codex-skills-registry 0.1.0 → 0.1.1

package/README.md

@@ -7,11 +7,18 @@ Install Codex skills from `vadimcomanescu/codex-skills`.
 Install one or more skills (recommended):
 
 ```bash
-npx codex-skills-registry@latest --skill=development/webapp-testing --yes
+npx codex-skills-registry@latest --skill=quality/code-reviewer --yes
+```
+
+List available skills (category/slug):
+
+```bash
+npx codex-skills-registry@latest --list
 ```
 
 ### Options
 
+- `--list`: List available skills (category/slug).
 - `--skill=<category>/<slug>`: Skill to install. Repeatable.
 - `--yes`: Skip prompts.
 - `--local`: Install into `<repo>/.codex/skills` instead of `$CODEX_HOME/skills`.
@@ -19,6 +26,10 @@ npx codex-skills-registry@latest --skill=development/webapp-testing --yes
 - `--ref=<git-ref>`: Git ref (default: `main`).
 - `--owner=<owner>` / `--repo=<repo>`: Override GitHub repo (default: `vadimcomanescu/codex-skills`).
 
+## Updating an installed skill
+
+Re-run the same install command. If the destination already exists, `--yes` overwrites it without prompting.
+
 ## Install location
 
 By default this installs into `$CODEX_HOME/skills`. If `CODEX_HOME` is not set, it uses `~/.codex/skills`.

package/bin/cli.js

@@ -10,6 +10,12 @@ const DEFAULT_OWNER = "vadimcomanescu";
 const DEFAULT_REPO = "codex-skills";
 const DEFAULT_REF = "main";
 
+process.stdout.on("error", (err) => {
+  if (err && err.code === "EPIPE") {
+    process.exit(0);
+  }
+});
+
 function formatVersion() {
   try {
     const __dirname = path.dirname(fileURLToPath(import.meta.url));
@@ -37,6 +43,7 @@ function printHeader() {
 function parseArgs(argv) {
   const out = {
     skills: [],
+    list: false,
     yes: false,
     local: false,
     dest: null,
@@ -48,6 +55,7 @@ function parseArgs(argv) {
 
   for (const raw of argv) {
     if (raw === "--help" || raw === "-h") out.help = true;
+    else if (raw === "--list") out.list = true;
     else if (raw === "--yes" || raw === "-y") out.yes = true;
     else if (raw === "--local") out.local = true;
     else if (raw.startsWith("--dest=")) out.dest = raw.slice("--dest=".length);
@@ -67,8 +75,10 @@ function printHelp() {
       "",
       "Usage:",
       "  npx codex-skills-registry@latest --skill=<category>/<slug> [--skill=...] --yes",
+      "  npx codex-skills-registry@latest --list",
       "",
       "Options:",
+      "  --list                      List available skills (category/slug).",
       "  --skill=<category>/<slug>   Skill to install (repeatable).",
       "  --yes, -y                   Skip prompts.",
       "  --local                     Install into <repo>/.codex/skills.",
@@ -135,6 +145,24 @@ async function listRepoTree(owner, repo, ref) {
   return Array.isArray(data.tree) ? data.tree : [];
 }
 
+function listSkillsFromTree(tree) {
+  const prefixes = ["skills/.curated/", "skills/.experimental/"];
+  const skillRefs = new Set();
+
+  for (const item of tree) {
+    if (item.type !== "blob" || typeof item.path !== "string") continue;
+    for (const prefix of prefixes) {
+      if (!item.path.startsWith(prefix)) continue;
+      const rest = item.path.slice(prefix.length);
+      const parts = rest.split("/").filter(Boolean);
+      if (parts.length < 2) continue;
+      skillRefs.add(`${parts[0]}/${parts[1]}`);
+    }
+  }
+
+  return Array.from(skillRefs).sort((a, b) => a.localeCompare(b));
+}
+
 function findSkillPrefix(tree, skillRef) {
   const curatedPrefix = `skills/.curated/${skillRef}/`;
   const experimentalPrefix = `skills/.experimental/${skillRef}/`;
@@ -156,10 +184,14 @@ async function installSkill({ owner, repo, ref, tree, skillRef, installRoot, yes
   }
 
   const destDir = path.join(installRoot, skillRef);
-  if (!yes && fs.existsSync(destDir)) {
-    const ok = await confirm(`⚠️  ${destDir} already exists. Overwrite? (y/N) `);
-    if (!ok) return { installed: false };
-    fs.rmSync(destDir, { recursive: true, force: true });
+  if (fs.existsSync(destDir)) {
+    if (yes) {
+      fs.rmSync(destDir, { recursive: true, force: true });
+    } else {
+      const ok = await confirm(`⚠️  ${destDir} already exists. Overwrite? (y/N) `);
+      if (!ok) return { installed: false };
+      fs.rmSync(destDir, { recursive: true, force: true });
+    }
   }
 
   fs.mkdirSync(destDir, { recursive: true });
@@ -199,12 +231,21 @@ async function main() {
     return;
   }
 
-  if (args.skills.length === 0) {
+  if (!args.list && args.skills.length === 0) {
     printHelp();
     process.exitCode = 1;
     return;
   }
 
+  if (args.list) {
+    const tree = await listRepoTree(args.owner, args.repo, args.ref);
+    const skills = listSkillsFromTree(tree);
+    for (const skillRef of skills) {
+      process.stdout.write(`${skillRef}\n`);
+    }
+    return;
+  }
+
   printHeader();
 
   const installRoot = getInstallRoot({ dest: args.dest, local: args.local });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "codex-skills-registry",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Install Codex skills from GitHub into your local Codex setup.",
   "private": false,
   "type": "module",
@@ -8,11 +8,11 @@
   "homepage": "https://skillregistry.dev",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/vadimcomanescu/codex-tmpl.git",
+    "url": "git+https://github.com/vadimcomanescu/codex-skills-registry.git",
     "directory": "packages/codex-skills-registry"
   },
   "bugs": {
-    "url": "https://github.com/vadimcomanescu/codex-tmpl/issues"
+    "url": "https://github.com/vadimcomanescu/codex-skills-registry/issues"
   },
   "keywords": ["codex", "openai", "cli", "skills", "installer"],
   "funding": {