fix(core): share .agents skills dir across codex, cursor, gemini (#34882)

MaxKless · claude · web-flow · commit 26790290771d · 2026-03-18T22:04:51.000+09:00
## Summary
- The upstream config repo (nx-ai-agents-config) now generates skills
into a shared `.agents/skills/` directory instead of separate per-agent
skills directories for codex, cursor, and gemini.
- Updated the `agentDirs` mapping so `.agents` is copied when any of
codex, cursor, or gemini are enabled, not just codex.
- Widened the `agent` field type from `Agent` to `Agent | Agent[]` to
support mapping a single directory to multiple agents.

## Key decisions
- Used `Agent | Agent[]` union type rather than always-array to minimize
changes to existing single-agent entries. The loop normalizes with
`Array.isArray` before checking.

---------

Co-authored-by: Claude Opus 4.6 (1M context) &lt;noreply@anthropic.com&gt;
diff --git a/packages/nx/src/ai/set-up-ai-agents/set-up-ai-agents.ts b/packages/nx/src/ai/set-up-ai-agents/set-up-ai-agents.ts
@@ -276,11 +276,24 @@ export async function setupAiAgentsGeneratorImpl(
   if (aiConfigRepoPath) {
     const repoPath = aiConfigRepoPath;
 
+    // Shared skills directory used by codex, cursor, and gemini
+    if (hasAgent('codex') || hasAgent('cursor') || hasAgent('gemini')) {
+      const sharedSkillsSrc = join(repoPath, 'generated/.agents');
+      if (existsSync(sharedSkillsSrc)) {
+        generateFiles(
+          tree,
+          sharedSkillsSrc,
+          join(options.directory, '.agents'),
+          {}
+        );
+      }
+    }
+
+    // Agent-specific directories (commands, agents, config)
     const agentDirs: { agent: Agent; src: string; dest: string }[] = [
       { agent: 'opencode', src: 'generated/.opencode', dest: '.opencode' },
       { agent: 'copilot', src: 'generated/.github', dest: '.github' },
       { agent: 'cursor', src: 'generated/.cursor', dest: '.cursor' },
-      { agent: 'codex', src: 'generated/.agents', dest: '.agents' },
       {
         agent: 'codex',
         src: 'generated/.codex/agents',
