@kbediako/codex-orchestrator 0.1.20 → 0.1.21

package/README.md

@@ -137,14 +137,17 @@ codex-orchestrator skills install
 
 Options:
 - `--force` overwrites existing files.
+- `--only <skills>` installs only selected skills (comma-separated). Combine with `--force` to overwrite only those.
 - `--codex-home <path>` targets a different Codex home directory.
 
 Bundled skills (may vary by release):
+- `collab-subagents-first`
 - `delegation-usage`
 - `standalone-review`
 - `docs-first`
 - `collab-evals`
 - `collab-deliberation`
+- `release`
 - `delegate-early` (compatibility alias; use `delegation-usage`)
 
 ## DevTools readiness

package/dist/bin/codex-orchestrator.js

@@ -605,7 +605,15 @@ async function handleSkills(rawArgs) {
             const format = flags['format'] === 'json' ? 'json' : 'text';
             const force = flags['force'] === true;
             const codexHome = readStringFlag(flags, 'codex-home');
-            const result = await installSkills({ force, codexHome });
+            const onlyRaw = flags['only'];
+            let only;
+            if (onlyRaw !== undefined) {
+                if (typeof onlyRaw !== 'string') {
+                    throw new Error('--only requires a comma-separated list of skill names.');
+                }
+                only = onlyRaw.split(',').map((entry) => entry.trim()).filter(Boolean);
+            }
+            const result = await installSkills({ force, codexHome, only });
             if (format === 'json') {
                 console.log(JSON.stringify(result, null, 2));
             }
@@ -946,6 +954,7 @@ Commands:
     --format json         Emit machine-readable output (dry-run only).
   skills install          Install bundled skills into $CODEX_HOME/skills.
     --force               Overwrite existing skill files.
+    --only <skills>       Install only selected skills (comma-separated).
     --codex-home <path>   Override the target Codex home directory.
     --format json         Emit machine-readable output.
   mcp serve [--repo <path>] [--dry-run] [-- <extra args>]
@@ -972,6 +981,7 @@ function printSkillsHelp() {
 Commands:
   install                   Install bundled skills into $CODEX_HOME/skills.
     --force                 Overwrite existing skill files.
+    --only <skills>         Install only selected skills (comma-separated).
     --codex-home <path>     Override the target Codex home directory.
     --format json           Emit machine-readable output.
 `);

package/dist/orchestrator/src/cli/skills.js

@@ -12,18 +12,28 @@ export async function installSkills(options = {}) {
     const targetRoot = join(codexHome, 'skills');
     const written = [];
     const skipped = [];
-    const skillNames = await listSkillNames(sourceRoot);
-    await copyDir(sourceRoot, targetRoot, {
+    const availableSkills = await listSkillNames(sourceRoot);
+    const selectedSkills = resolveSelectedSkills(availableSkills, options.only);
+    const copyOptions = {
         force: options.force ?? false,
         written,
         skipped
-    });
+    };
+    if (selectedSkills.length === availableSkills.length) {
+        await copyDir(sourceRoot, targetRoot, copyOptions);
+    }
+    else {
+        await mkdir(targetRoot, { recursive: true });
+        for (const skill of selectedSkills) {
+            await copyDir(join(sourceRoot, skill), join(targetRoot, skill), copyOptions);
+        }
+    }
     return {
         written,
         skipped,
         sourceRoot,
         targetRoot,
-        skills: skillNames
+        skills: selectedSkills
     };
 }
 export function formatSkillsInstallSummary(result, cwd = process.cwd()) {
@@ -61,6 +71,22 @@ async function listSkillNames(sourceRoot) {
     const entries = await readdir(sourceRoot, { withFileTypes: true });
     return entries.filter((entry) => entry.isDirectory()).map((entry) => entry.name);
 }
+function resolveSelectedSkills(availableSkills, only) {
+    if (!only) {
+        return availableSkills;
+    }
+    const trimmed = only.map((entry) => entry.trim()).filter(Boolean);
+    if (trimmed.length === 0) {
+        throw new Error('No skills specified for --only.');
+    }
+    const requested = Array.from(new Set(trimmed));
+    const available = new Set(availableSkills);
+    const unknown = requested.filter((skill) => !available.has(skill));
+    if (unknown.length > 0) {
+        throw new Error(`Unknown skill(s): ${unknown.join(', ')}. Available skills: ${availableSkills.join(', ')}`);
+    }
+    return requested;
+}
 async function assertDirectory(path) {
     const info = await stat(path).catch(() => null);
     if (!info || !info.isDirectory()) {

package/docs/README.md

@@ -103,7 +103,7 @@ Use `npx @kbediako/codex-orchestrator resume --run <run-id>` to continue interru
 - `codex-orchestrator init codex [--cwd <path>] [--force]`: copy starter templates into a repo (includes `mcp-client.json` and `AGENTS.md`; no overwrite unless `--force`).
 - `codex-orchestrator doctor [--format json]`: check optional tooling dependencies and print install commands.
 - `codex-orchestrator devtools setup [--yes]`: print DevTools MCP setup instructions (`--yes` applies `codex mcp add ...`).
-- `codex-orchestrator skills install [--force] [--codex-home <path>]`: install bundled skills into `$CODEX_HOME/skills` (global skills remain the primary reference when installed).
+- `codex-orchestrator skills install [--force] [--only <skills>] [--codex-home <path>]`: install bundled skills into `$CODEX_HOME/skills` (global skills remain the primary reference when installed).
 - `codex-orchestrator self-check --format json`: emit a safe JSON health payload for smoke tests.
 - `codex-orchestrator --version`: print the package version.
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kbediako/codex-orchestrator",
-  "version": "0.1.20",
+  "version": "0.1.21",
   "license": "MIT",
   "repository": {
     "type": "git",