Update README and code to reflect new skill directory structure for Codex

- Changed references from `.codex/skills/` to `.agents/skills/` in README and code files.
- Updated skill discovery paths in `src/utils.js`, `src/commands/claude-code/setup.js`, and `src/commands/claude-code/skills.js` to align with the new structure.
- Enhanced user guidance in CLI regarding skill installation locations.

Author: sambharia

README.md

@@ -53,7 +53,7 @@ npx portkey mcp add
 1. Run `npx portkey` → choose **Setup Codex**.
 2. Paste your Portkey API key when asked.
 3. Pick routing (**provider** or **config**). The CLI updates `.codex/config.toml` with `base_url`, `PORTKEY_API_KEY`, and `wire_api` (`chat` = Chat Completions, `responses` = Responses API — same as [Portkey's Codex guide](https://portkey.ai/docs)).
-4. Optionally add **MCP** (same Portkey registry) and sync **skills** into `.codex/skills/`.
+4. Optionally add **MCP** (same Portkey registry) and sync **skills** into `.agents/skills/` (Codex's skill discovery location).
 
 If you have **several Model Catalog providers**, the wizard can append extra `[model_providers.portkey-<slug>]` tables (each with its own `wire_api`). Switch the active route by editing `model_provider` and `model` (`@<slug>/<model-id>`) at the top of the file.
 
@@ -83,7 +83,7 @@ npx portkey skills sync --yes --agent codex
 | `npx portkey mcp add`              | Pick **Claude Code** or **Codex**, then servers from Portkey |
 
 
-**Skills:** list comes from the **Portkey API** for your workspace. You choose **where files are written** (`.claude/skills`, `.codex/skills`, `.cursor/skills`, project vs `--global`).
+**Skills:** list comes from the **Portkey API** for your workspace. You choose **where files are written** (`.claude/skills`, `.agents/skills` for Codex, `.cursor/skills`, project vs `--global`).
 
 **MCP:** same registry on Portkey; Claude uses `~/.claude.json` / `.mcp.json`, Codex `[mcp_servers.*]` in `.codex/config.toml`.
 

src/commands/claude-code/setup.js

@@ -1225,14 +1225,15 @@ async function runSkillsSelection(args, portkeyKey, gateway, projectRoot, defaul
   let useGlobal = args.global || !projectRoot;
   if (!args.yes && !args.global && projectRoot) {
     // Show paths specific to the chosen agent (or generic if unknown)
+    // Codex reads skills from `.agents/skills`, not `.codex/skills`.
     const agentDir = defaultAgent
-      ? { claude: ".claude", cursor: ".cursor", codex: ".codex" }[defaultAgent] || ".claude"
+      ? { claude: ".claude", cursor: ".cursor", codex: ".agents" }[defaultAgent] || ".claude"
       : null;
 
-    const projectHint  = agentDir ? `.${agentDir}/skills/` : ".claude/skills/  .cursor/skills/  .codex/skills/";
+    const projectHint  = agentDir ? `${agentDir}/skills/` : ".claude/skills/  .cursor/skills/  .agents/skills/";
     const personalHint = agentDir
       ? `~/${agentDir}/skills/`
-      : "~/.claude/skills/  ~/.cursor/skills/  ~/.codex/skills/";
+      : "~/.claude/skills/  ~/.cursor/skills/  ~/.agents/skills/";
 
     const scopePick = await p.select({
       message: "Where should skills be installed?",
@@ -1270,7 +1271,7 @@ async function runSkillsSelection(args, portkeyKey, gateway, projectRoot, defaul
     const agentOptions = [
       { value: "claude", label: "Claude Code", hint: (useGlobal ? "~/.claude/skills/" : ".claude/skills/") + (installed.includes("claude") ? "  ✓" : "") },
       { value: "cursor", label: "Cursor",       hint: (useGlobal ? "~/.cursor/skills/" : ".cursor/skills/") + (installed.includes("cursor") ? "  ✓" : "") },
-      { value: "codex",  label: "Codex",        hint: (useGlobal ? "~/.codex/skills/"  : ".codex/skills/")  + (installed.includes("codex")  ? "  ✓" : "") },
+      { value: "codex",  label: "Codex",        hint: (useGlobal ? "~/.agents/skills/" : ".agents/skills/") + (installed.includes("codex")  ? "  ✓" : "") },
     ];
     p.note(
       `${c.dim}${MULTISELECT_HINT}${c.reset}\n` +

src/commands/claude-code/skills.js

@@ -64,7 +64,7 @@ export async function doSkillsSync(args) {
   p.note(
     `${c.bold}Source:${c.reset} every skill is fetched from your ${c.bold}Portkey workspace${c.reset} (Prompt Partials API). ` +
       `Nothing is “synced” from random local folders — the CLI downloads the latest content from Portkey.\n` +
-      `${c.bold}Destination:${c.reset} you choose which agent(s) get folders like ${c.dim}.claude/skills/<slug>/SKILL.md${c.reset} or ${c.dim}.codex/skills/...${c.reset}, ` +
+      `${c.bold}Destination:${c.reset} you choose which agent(s) get folders like ${c.dim}.claude/skills/<slug>/SKILL.md${c.reset} or ${c.dim}.agents/skills/...${c.reset} (Codex), ` +
       `and whether that is ${c.bold}this repo${c.reset} or ${c.bold}--global${c.reset} (${c.dim}~/...${c.reset}).`,
     "What skills sync does"
   );

src/utils.js

@@ -278,9 +278,11 @@ export const AGENT_SKILLS_DIRS = {
   cursor: (root, global) => global
     ? path.join(os.homedir(), ".cursor", "skills")
     : path.join(root || process.cwd(), ".cursor", "skills"),
+  // Codex discovers skills at `~/.agents/skills` (USER) and `<repo>/.agents/skills` (REPO),
+  // walking up to the repo root. See https://developers.openai.com/codex/skills
   codex:  (root, global) => global
-    ? path.join(os.homedir(), ".codex", "skills")
-    : path.join(root || process.cwd(), ".codex", "skills"),
+    ? path.join(os.homedir(), ".agents", "skills")
+    : path.join(root || process.cwd(), ".agents", "skills"),
 };
 
 /** Detect which of the supported agents are already configured. */