feat: add project-level team skills (.dex/skills/)

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: 2 people

src/acp/__tests__/server.test.ts

@@ -45,7 +45,7 @@ function makeSkill(name: string): LoadedSkill {
     },
     handler: async () => {},
     path: `/skills/${name}`,
-    builtIn: true,
+    source: "built-in",
   };
 }
 

src/cli/commands/skill.ts

@@ -51,9 +51,12 @@ export function createSkillCommand(
 
       console.log(chalk.bold("\nAvailable Skills:\n"));
       for (const skill of skills) {
-        const tag = skill.builtIn
-          ? chalk.gray(" [built-in]")
-          : chalk.cyan(" [user]");
+        const tagMap = {
+          "built-in": chalk.gray(" [built-in]"),
+          user: chalk.cyan(" [user]"),
+          project: chalk.magenta(" [project]"),
+        };
+        const tag = tagMap[skill.source];
         const aliases = skill.manifest.aliases?.length
           ? chalk.gray(` (aliases: ${skill.manifest.aliases.join(", ")})`)
           : "";
@@ -76,7 +79,7 @@ export function createSkillCommand(
       console.log(chalk.bold(`\n${m.name} v${m.version}`));
       console.log(`${m.description}\n`);
       console.log(`  Path: ${skill.path}`);
-      console.log(`  Built-in: ${skill.builtIn}`);
+      console.log(`  Source: ${skill.source}`);
       if (m.aliases?.length) {
         console.log(`  Aliases: ${m.aliases.join(", ")}`);
       }

src/cli/program.ts

@@ -6,7 +6,7 @@ import chalk from "chalk";
 import { loadConfig, getGlobalConfigDir } from "../core/config.js";
 import { createLogger } from "../core/logger.js";
 import { SkillRegistry } from "../skills/registry.js";
-import { loadBuiltInSkills, loadUserSkills } from "../skills/loader.js";
+import { loadBuiltInSkills, loadUserSkills, loadProjectSkills } from "../skills/loader.js";
 import { registerSkillShortcuts } from "./shortcuts.js";
 import { createRunCommand } from "./commands/run.js";
 import { createServeCommand } from "./commands/serve.js";
@@ -40,6 +40,9 @@ export async function createProgram(): Promise<Command> {
   ];
   await loadUserSkills(registry, userSkillDirs, logger);
 
+  // Load project-level skills from .dex/skills/
+  await loadProjectSkills(registry, process.cwd(), logger);
+
   logger.debug(`Loaded ${registry.list().length} skills`);
 
   // Build CLI program
@@ -89,12 +92,18 @@ export async function createProgram(): Promise<Command> {
         return;
       }
       await mkdir(dir, { recursive: true });
+      await mkdir(join(dir, "skills"), { recursive: true });
       const { writeFile } = await import("node:fs/promises");
       await writeFile(
         join(dir, "config.json"),
         JSON.stringify({}, null, 2) + "\n",
       );
       console.log(chalk.green("Initialized .dex/ in current directory."));
+      console.log(
+        chalk.gray(
+          "Add skills to .dex/skills/ to share with your team.",
+        ),
+      );
 
       // Show setup hint if API key is not configured
       if (!config.apiKey && !process.env.ANTHROPIC_API_KEY) {

src/skills/__tests__/executor-acp.test.ts

@@ -32,7 +32,7 @@ function makeSkill(handler: (ctx: SkillContext) => Promise<void>): LoadedSkill {
     },
     handler,
     path: "/test",
-    builtIn: false,
+    source: "user",
   };
 }
 

src/skills/__tests__/executor.test.ts

@@ -27,7 +27,7 @@ function makeTestSkill(
     },
     handler,
     path: "/test",
-    builtIn: false,
+    source: "user",
   };
 }
 

src/skills/__tests__/loader.test.ts

@@ -1,5 +1,5 @@
 import { describe, it, expect } from "vitest";
-import { loadBuiltInSkills, loadUserSkills } from "../loader.js";
+import { loadBuiltInSkills, loadUserSkills, loadProjectSkills } from "../loader.js";
 import { SkillRegistry } from "../registry.js";
 import { createLogger } from "../../core/logger.js";
 import { mkdtemp, mkdir, writeFile, rm } from "node:fs/promises";
@@ -42,7 +42,7 @@ describe("loadBuiltInSkills", () => {
 
       expect(registry.has("test-skill")).toBe(true);
       expect(registry.has("ts")).toBe(true);
-      expect(registry.get("test-skill").builtIn).toBe(false);
+      expect(registry.get("test-skill").source).toBe("user");
     } finally {
       await rm(tmpDir, { recursive: true });
     }
@@ -83,7 +83,7 @@ describe("loadUserSkills", () => {
       await loadUserSkills(registry, [tmpDir], logger);
 
       expect(registry.has("my-skill")).toBe(true);
-      expect(registry.get("my-skill").builtIn).toBe(false);
+      expect(registry.get("my-skill").source).toBe("user");
     } finally {
       await rm(tmpDir, { recursive: true });
     }
@@ -149,3 +149,40 @@ describe("loadUserSkills", () => {
     }
   });
 });
+
+describe("loadProjectSkills", () => {
+  it("should skip when .dex/skills/ does not exist", async () => {
+    const registry = new SkillRegistry();
+    await loadProjectSkills(registry, "/tmp/nonexistent-project-xxx", logger);
+    expect(registry.list()).toHaveLength(0);
+  });
+
+  it("should load a valid project skill", async () => {
+    const tmpDir = await mkdtemp(join(tmpdir(), "dex-project-"));
+    const skillDir = join(tmpDir, ".dex", "skills", "team-skill");
+    try {
+      await mkdir(skillDir, { recursive: true });
+      await writeFile(
+        join(skillDir, "manifest.json"),
+        JSON.stringify({
+          name: "team-skill",
+          version: "0.1.0",
+          description: "A project team skill",
+          inputs: {},
+        }),
+      );
+      await writeFile(
+        join(skillDir, "handler.ts"),
+        "export default async function() {}",
+      );
+
+      const registry = new SkillRegistry();
+      await loadProjectSkills(registry, tmpDir, logger);
+
+      expect(registry.has("team-skill")).toBe(true);
+      expect(registry.get("team-skill").source).toBe("project");
+    } finally {
+      await rm(tmpDir, { recursive: true });
+    }
+  });
+});

src/skills/__tests__/registry.test.ts

@@ -17,7 +17,7 @@ function makeSkill(
     },
     handler: async () => {},
     path: `/skills/${name}`,
-    builtIn: true,
+    source: "built-in",
   };
 }
 

src/skills/loader.ts

@@ -39,7 +39,7 @@ function getBuiltInPath(logger: Logger): string | null {
 
 async function loadSkillFromDir(
   dir: string,
-  builtIn: boolean,
+  source: "built-in" | "user" | "project",
   logger: Logger,
 ): Promise<LoadedSkill | null> {
   const manifestPath = join(dir, "manifest.json");
@@ -71,7 +71,7 @@ async function loadSkillFromDir(
       return null;
     }
 
-    return { manifest, handler, path: dir, builtIn };
+    return { manifest, handler, path: dir, source };
   } catch (err) {
     logger.warn(
       `Failed to load skill from ${dir}: ${err instanceof Error ? err.message : err}`,
@@ -92,7 +92,7 @@ export async function loadBuiltInSkills(
     if (!entry.isDirectory()) continue;
     const skill = await loadSkillFromDir(
       join(builtInPath, entry.name),
-      true,
+      "built-in",
       logger,
     );
     if (skill) {
@@ -115,7 +115,7 @@ export async function loadUserSkills(
       if (!entry.isDirectory()) continue;
       const skill = await loadSkillFromDir(
         join(dir, entry.name),
-        false,
+        "user",
         logger,
       );
       if (skill) {
@@ -125,3 +125,26 @@ export async function loadUserSkills(
     }
   }
 }
+
+export async function loadProjectSkills(
+  registry: SkillRegistry,
+  cwd: string,
+  logger: Logger,
+): Promise<void> {
+  const projectSkillsDir = join(cwd, ".dex", "skills");
+  if (!existsSync(projectSkillsDir)) return;
+
+  const entries = await readdir(projectSkillsDir, { withFileTypes: true });
+  for (const entry of entries) {
+    if (!entry.isDirectory()) continue;
+    const skill = await loadSkillFromDir(
+      join(projectSkillsDir, entry.name),
+      "project",
+      logger,
+    );
+    if (skill) {
+      registry.register(skill);
+      logger.debug(`Loaded project skill: ${skill.manifest.name}`);
+    }
+  }
+}

src/skills/types.ts

@@ -88,5 +88,5 @@ export interface LoadedSkill {
   manifest: SkillManifest;
   handler: SkillHandler;
   path: string;
-  builtIn: boolean;
+  source: "built-in" | "user" | "project";
 }