@lifeaitools/rdc-skills 0.9.26 → 0.9.27

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lifeaitools/rdc-skills",
-  "version": "0.9.26",
+  "version": "0.9.27",
   "description": "RDC typed-agent dispatch skill suite for Claude Code — plan, build, review, overnight builds",
   "keywords": [
     "claude-code",

package/scripts/install-rdc-skills.js

@@ -7,13 +7,14 @@
  *   node scripts/install-rdc-skills.js --skip-hooks         ← skip hook wiring
  *   node scripts/install-rdc-skills.js --claude-home <path> ← custom CLI home
  *   node scripts/install-rdc-skills.js --codex-root <path>  ← also install to .agents/skills/user/
+ *   node scripts/install-rdc-skills.js --codex-skill-dir <path> ← also install to a Codex skill dir
  *   node scripts/install-rdc-skills.js --migrate <path>     ← migrate docs/ → .rdc/
  *
  * What it does:
  *   1. git pull (latest commands + guides)
  *   2. CLI plugin  — registers in ~/.claude/plugins/ + settings.json
  *   3. Cowork      — registers in Desktop cowork_plugins/ + cowork_settings.json
- *   3.5 Codex      — copies skills to <project>/.agents/skills/user/rdc-<name>/
+ *   3.5 Codex      — copies skills to detected Codex skill dirs
  *   4. Hook files  — copies hooks/*.js → ~/.claude/hooks/
  *   5. Hook wiring — wires hooks into ~/.claude/settings.json
  *   6. Zip         — builds dist/rdc-skills-plugin.zip for claude.ai / distribution
@@ -46,6 +47,10 @@ const codexRoot  = codexIdx >= 0
       const sibling = path.resolve(repoRoot, '..', 'regen-root');
       return fs.existsSync(path.join(sibling, '.agents')) ? sibling : null;
     })();
+const codexSkillDirIdx = args.indexOf('--codex-skill-dir');
+const explicitCodexSkillDir = codexSkillDirIdx >= 0
+  ? path.resolve(args[codexSkillDirIdx + 1])
+  : null;
 const hooksSrc     = path.join(repoRoot, 'hooks');
 const hooksDst     = path.join(claudeHome, 'hooks');
 const settingsPath = path.join(claudeHome, 'settings.json');
@@ -352,9 +357,37 @@ function registerCowork(version, gitSha) {
   return bases.length;
 }
 
-// ── Codex registration (→ <project>/.agents/skills/user/rdc-*/) ─────────────
-function registerCodex(codexProjectRoot) {
-  const targetDir = path.join(codexProjectRoot, '.agents', 'skills', 'user');
+// ── Codex registration (→ Codex skill dirs/rdc-*/) ───────────────────────────
+function addCodexTarget(targets, label, targetDir) {
+  if (!targetDir) return;
+  const resolved = path.resolve(targetDir);
+  if (targets.some(t => t.targetDir.toLowerCase() === resolved.toLowerCase())) return;
+  targets.push({ label, targetDir: resolved });
+}
+
+function findCodexTargets() {
+  const targets = [];
+  if (codexRoot) {
+    addCodexTarget(targets, 'project .agents', path.join(codexRoot, '.agents', 'skills', 'user'));
+  }
+  if (explicitCodexSkillDir) {
+    addCodexTarget(targets, 'explicit', explicitCodexSkillDir);
+  }
+
+  const codexHomeSkills = path.join(os.homedir(), '.codex', 'skills');
+  if (fs.existsSync(codexHomeSkills)) {
+    addCodexTarget(targets, 'global .codex', codexHomeSkills);
+  }
+
+  const globalAgentSkills = path.join(os.homedir(), '.agents', 'skills');
+  if (fs.existsSync(globalAgentSkills)) {
+    addCodexTarget(targets, 'global .agents', globalAgentSkills);
+  }
+
+  return targets;
+}
+
+function registerCodexTarget(targetDir) {
   fs.mkdirSync(targetDir, { recursive: true });
 
   // Clean: remove dirs that are rdc skills — by prefix OR by frontmatter name
@@ -630,13 +663,19 @@ async function main() {
   }
 
   // 2.5. Codex registration
-  if (codexRoot) {
-    const { removed, copied } = registerCodex(codexRoot);
-    const codexTarget = path.join(codexRoot, '.agents', 'skills', 'user');
-    ok(`[2.5] Codex      — ${copied} skill(s) installed, ${removed} stale removed`);
-    info(`       target   : ${codexTarget}`);
+  const codexTargets = findCodexTargets();
+  if (codexTargets.length > 0) {
+    let copiedTotal = 0;
+    let removedTotal = 0;
+    for (const target of codexTargets) {
+      const { removed, copied } = registerCodexTarget(target.targetDir);
+      copiedTotal += copied;
+      removedTotal += removed;
+      info(`       ${target.label.padEnd(15)}: ${target.targetDir} (${copied} installed, ${removed} stale removed)`);
+    }
+    ok(`[2.5] Codex      — ${copiedTotal} skill install(s), ${removedTotal} stale removed across ${codexTargets.length} target(s)`);
   } else {
-    info('[2.5] Codex      — skipped (no .agents/ found; use --codex-root <path>)');
+    info('[2.5] Codex      — skipped (no Codex skill dirs found; use --codex-root or --codex-skill-dir)');
   }
 
   // 2.7. Symlinks in regen-root/.claude/skills/ (FS MCP + claude.ai access)

package/skills/build/SKILL.md

@@ -1,7 +1,6 @@
 ---
 name: rdc:build
-description: >-
-  Usage `rdc:build <epic-id|topic> [--unattended]` — dispatch typed agents from an epic, commit, push, update work items. The build engine. Use after rdc:plan or when the project lead says "build it".
+description: "You have a planned epic with tasks ready to execute. Dispatches parallel typed agents, each commits atomically to develop, closes work items, and runs the validator gate. Call after rdc:plan or when told "build it"."
 ---
 
 > **⚠️ OUTPUT CONTRACT (READ FIRST):** `guides/output-contract.md`

package/skills/collab/SKILL.md

@@ -1,7 +1,6 @@
 ---
 name: rdc:collab
-description: >-
-  Usage `rdc:collab --session <id>` — bidirectional relay with claude.ai. Read inbox, do work, write outbox, loop. Dave watches terminal and can interject.
+description: "Bidirectional relay with a claude.ai session — read inbox, do work, write outbox, loop. Use when coordinating with a parallel claude.ai conversation."
 ---
 
 > **⚠️ OUTPUT CONTRACT (READ FIRST):** `guides/output-contract.md`

package/skills/deploy/SKILL.md

@@ -1,7 +1,6 @@
 ---
 name: rdc:deploy
-description: >-
-  Coolify ops. Usage `rdc:deploy <slug> [build-id]` or `rdc:deploy new <slug>` or `rdc:deploy diagnose <slug>` or `rdc:deploy audit [--fix]` — type checklists, DNS decision tree, mandatory post-deploy gate. Checklist-only output.
+description: "Deploy an app to Coolify (production) or PM2 (staging), add a new Coolify app, diagnose a failed deploy, or audit watch paths. Handles DNS, health checks, and post-deploy verification."
 ---
 
 > **⚠️ OUTPUT CONTRACT (READ FIRST):** `guides/output-contract.md`

package/skills/design/SKILL.md

@@ -1,7 +1,6 @@
 ---
 name: rdc:design
-description: >-
-  Usage `rdc:design <command|brief>` — RDC-owned design skill for Studio, Palette Library, token-aware UI work, and Rampa CLI-assisted color systems.
+description: "RDC-owned design work for Studio, Palette Library, and token-aware UI systems. Use for Rampant color work or design-system-first builds owned by the design cell. Not for general UI polish — use impeccable for that."
 ---
 
 > **⚠️ OUTPUT CONTRACT (READ FIRST):** `guides/output-contract.md`

package/skills/fixit/SKILL.md

@@ -1,7 +1,6 @@
 ---
 name: rdc:fixit
-description: >-
-  Usage `rdc:fixit <description>` — sanctioned bypass for quick fixes under 5 files / 30 min. Creates minimal work item, makes fix, commits, closes. The ONLY alternative to rdc:build. For typos, config patches, hotfixes, dep bumps.
+description: "Quick fix under 5 files / 30 min that does not warrant a full plan→build cycle. Creates a minimal work item, makes the change, commits, closes. The only sanctioned bypass of rdc:build."
 ---
 
 > **⚠️ OUTPUT CONTRACT (READ FIRST):** `guides/output-contract.md`

package/skills/handoff/SKILL.md

@@ -1,7 +1,6 @@
 ---
 name: rdc:handoff
-description: >-
-  Usage `rdc:handoff <topic>` — structured handoff from planning session to CLI agents. Produces plan doc in .rdc/plans/, work items in DB, prototype registry entry if applicable. Use when plan/prototype is finalized and ready for implementation.
+description: "Convert a finalized plan or prototype into CLI-ready artifacts: writes .rdc/plans/, creates Supabase work items with DoD checklists, registers prototype if present. Bridge between planning session and rdc:build."
 ---
 
 > **⚠️ OUTPUT CONTRACT (READ FIRST):** `guides/output-contract.md`

package/skills/help/SKILL.md

@@ -1,7 +1,6 @@
 ---
 name: rdc:help
-description: >-
-  Usage `rdc:help` or `rdc` — selection menu of all rdc:* skills with their full argument syntax. Use when unsure which command to invoke or what args it takes.
+description: "Show all rdc:* skills with full argument syntax. Call when unsure which skill to use or what args it takes."
 ---
 
 > **⚠️ OUTPUT CONTRACT (READ FIRST):** `guides/output-contract.md`

package/skills/overnight/SKILL.md

@@ -1,7 +1,6 @@
 ---
 name: rdc:overnight
-description: >-
-  Usage `rdc:overnight [epic-id|label=X]` — unattended overnight supervisor, chains preplan → plan → build → review → report across all high-priority epics in --unattended mode. Use for "run overnight", "build while I sleep".
+description: "Unattended end-to-end: drain the entire work queue autonomously (preplan → plan → build → review → report). Use when leaving Claude to run unsupervised for an extended session."
 ---
 
 > **⚠️ OUTPUT CONTRACT (READ FIRST):** `guides/output-contract.md`

package/skills/plan/SKILL.md

@@ -1,7 +1,6 @@
 ---
 name: rdc:plan
-description: >-
-  Usage `rdc:plan <topic> [--unattended]` — architecture doc with design decisions, tradeoffs, work packages. Creates Supabase epics/tasks. Use after rdc:preplan or when given clear architectural direction.
+description: "No epic exists and you need architecture + task breakdown. Produces design decisions, tradeoffs, and Supabase epics/tasks with DoD checklists that feed rdc:build. Use after rdc:preplan or when given clear architectural direction."
 ---
 
 > **⚠️ OUTPUT CONTRACT (READ FIRST):** `guides/output-contract.md`

package/skills/preplan/SKILL.md

@@ -1,7 +1,6 @@
 ---
 name: rdc:preplan
-description: >-
-  Usage `rdc:preplan <topic> [--unattended]` — research best practices, analyze codebase, compare approaches, surface unknowns before committing to a plan. Produces a research doc. No decisions, no code.
+description: "Before committing to an architecture, research unknowns first. Codebase scan + web search, no code written, no work items created. Output feeds rdc:plan. Use for "how should we approach X" questions."
 ---
 
 > **⚠️ OUTPUT CONTRACT (READ FIRST):** `guides/output-contract.md`

package/skills/prototype/SKILL.md

@@ -1,7 +1,6 @@
 ---
 name: rdc:prototype
-description: >-
-  Usage `rdc:prototype <description>` — build JSX/TSX prototype for review before CLI handoff. Saves to docs/source/, registers in prototype_registry. Use for "mock this up", "show me what it looks like". Reference material only, not production.
+description: "Build a JSX/TSX mockup for visual review before implementation. Saves to docs/source/, registers in prototype_registry. Use when told "mock this up" or "show me what it looks like". Not production code."
 ---
 
 > **⚠️ OUTPUT CONTRACT (READ FIRST):** `guides/output-contract.md`

package/skills/release/SKILL.md

@@ -1,7 +1,6 @@
 ---
 name: rdc:release
-description: >-
-  Atomic release for ANY LIFEAI repo. Usage `rdc:release <repo> [version]` — one skill, all repos. Known repos: clauth, rdc-skills, regen-root, regen-media, gws. Also promotes individual deployed apps from staging to production: `rdc:release promote <slug>`. Handles npm publish, monorepo develop→main promotion, per-app Coolify gate checks, and MCP server restarts. No user handoff.
+description: "Promote develop→main and deploy to production for any LIFEAI repo (clauth, rdc-skills, regen-root, etc.), or promote a staged app with rdc:release promote <slug>. Requires dev verification first."
 ---
 
 > **⚠️ OUTPUT CONTRACT (READ FIRST):** `guides/output-contract.md`

package/skills/report/SKILL.md

@@ -1,7 +1,6 @@
 ---
 name: rdc:report
-description: >-
-  Usage `rdc:report [--unattended]` — nightly markdown report, writes to .rdc/reports/YYYY-MM-DD.md. Covers completed/open work items, per-project progress, infra status, git stats, test counts.
+description: "Write the nightly session summary to .rdc/reports/YYYY-MM-DD.md covering completed work, open items, per-project progress, and infra status. Call at session end."
 ---
 
 > **⚠️ OUTPUT CONTRACT (READ FIRST):** `guides/output-contract.md`

package/skills/review/SKILL.md

@@ -1,7 +1,6 @@
 ---
 name: rdc:review
-description: >-
-  Usage `rdc:review [--unattended]` — tests, typecheck, stale docs, export conflicts across modified packages. Fixes issues found. Use after a build session or before merging to main.
+description: "Post-build quality gate: tsc, tests, stale docs, export conflicts across modified packages. Fixes what it can automatically, escalates the rest. Call after rdc:build and before merging to main."
 ---
 
 > **⚠️ OUTPUT CONTRACT (READ FIRST):** `guides/output-contract.md`

package/skills/self-test/SKILL.md

@@ -1,7 +1,6 @@
 ---
 name: rdc:self-test
-description: >-
-  Usage `rdc:self-test [--strict] [--skill <name>] [--json] [--fix] [--tier2] [--parallel <n>] [--quick]` — validates every rdc-*.md skill: frontmatter, Usage marker, name↔filename match, referenced guides/rules/hooks exist, output contract banner, plugin manifest, duplicate-name + collision checks. Tier 1 static lint; Tier 2 behavioral runs via headless claude in isolated worktrees + Supabase branch. Run before every release.
+description: "Validate all rdc:* skills, plugin manifest, and tooling consistency. Use after editing skills, upgrading the plugin, or when a skill behaves unexpectedly."
 ---
 
 > **⚠️ OUTPUT CONTRACT (READ FIRST):** `guides/output-contract.md`

package/skills/status/SKILL.md

@@ -1,7 +1,6 @@
 ---
 name: rdc:status
-description: >-
-  Usage `rdc:status` — open epics, work items by project, Coolify health, blockers, next recommended action. Read-only situational awareness.
+description: "Read-only snapshot of open epics, work items, Coolify health, blockers, and next recommended action. Safe to call anytime. Start here when disoriented or resuming a session."
 ---
 
 > **⚠️ OUTPUT CONTRACT (READ FIRST):** `guides/output-contract.md`

package/skills/watch/SKILL.md

@@ -1,7 +1,6 @@
 ---
 name: rdc:watch
-description: >-
-  Usage `rdc:watch` — initialize a session log and open a browser viewer that tails Claude activity live. Zero infra, pure filesystem + static HTML.
+description: "Open a live browser viewer tailing this session's activity. Zero infrastructure — pure filesystem + static HTML."
 ---
 
 > **⚠️ OUTPUT CONTRACT (READ FIRST):** `guides/output-contract.md`

package/skills/workitems/SKILL.md

@@ -1,7 +1,6 @@
 ---
 name: rdc:workitems
-description: >-
-  Usage `rdc:workitems <action> [args]` — create, update, query work items via Supabase RPCs. Actions: add, update, done, list, epics. Use for "add to backlog", "mark done", "show open epics", any work item CRUD.
+description: "Manual work item CRUD outside the normal build flow: add to backlog, mark done, update status, list open epics, query by label."
 ---
 
 > **⚠️ OUTPUT CONTRACT (READ FIRST):** `guides/output-contract.md`