feat(skills): plugin manifests for Codex/Cursor + positional platform CLI (#507)

.agents/plugins/marketplace.json

@@ -0,0 +1,25 @@
+{
+  "name": "datadog-pup",
+  "owner": {
+    "name": "Datadog",
+    "email": "support@datadoghq.com"
+  },
+  "metadata": {
+    "description": "Datadog API CLI with skills and domain agents for AI coding assistants"
+  },
+  "plugins": [
+    {
+      "name": "pup",
+      "source": "./",
+      "description": "Datadog API CLI with 49 command groups, 300+ subcommands. Skills and domain agents for monitoring, logs, APM, security, and infrastructure.",
+      "version": "0.62.0",
+      "author": {
+        "name": "Datadog",
+        "email": "support@datadoghq.com"
+      },
+      "license": "Apache-2.0",
+      "keywords": ["datadog", "monitoring", "logs", "apm", "metrics", "security", "infrastructure"],
+      "category": "observability"
+    }
+  ]
+}

.codex-plugin/plugin.json

@@ -0,0 +1,13 @@
+{
+  "name": "pup",
+  "version": "0.62.0",
+  "description": "Datadog API CLI with 49 command groups, 300+ subcommands. Skills and domain agents for monitoring, logs, APM, security, and infrastructure.",
+  "author": {
+    "name": "Datadog",
+    "email": "support@datadoghq.com"
+  },
+  "repository": "https://github.com/DataDog/pup",
+  "license": "Apache-2.0",
+  "keywords": ["datadog", "monitoring", "logs", "apm", "metrics", "security", "infrastructure"],
+  "skills": "./skills/"
+}

README.md

@@ -499,28 +499,40 @@ See `docs/examples/runbooks/` for ready-to-use examples and [docs/EXAMPLES.md](d
 Pup ships a set of skills and domain agents embedded in the binary, installable to any AI coding assistant. Run `pup skills list` to see what's available in the version you have installed.
 
 ```bash
-# Install all skills and agents for your AI assistant
+# Install all skills and agents for the auto-detected platform
 pup skills install
 
-# Install for a specific tool
-pup skills install --target-agent=claude-code
-pup skills install --target-agent=cursor
+# Install for a specific platform (positional arg)
+pup skills install claude
+pup skills install cursor
+pup skills install codex
+pup skills install opencode
+pup skills install pi
+
+# Install for every supported platform at once
+pup skills install all
+
+# By default installs go to the user-global directory; --project keeps them local
+pup skills install claude --project
 
 # List available skills and agents
 pup skills list
 pup skills list --type=skill
 pup skills list --type=agent
 
-# Install a specific skill
-pup skills install dd-monitors
+# Install a specific skill by name
+pup skills install claude --name dd-monitors
 ```
 
-For Claude Code, skills install to `.claude/skills/` and agents install to `.claude/agents/` (native subagent format). For other tools, everything installs as `SKILL.md` in the tool's skills directory.
+For Claude Code, skills install to `~/.claude/skills/` (or `.claude/skills/` with `--project`) and agents install to `~/.claude/agents/` (native subagent format). For Cursor, Codex, and opencode, everything installs as `SKILL.md` under that tool's skills directory (e.g. `~/.cursor/skills/`, `~/.codex/skills/`, `~/.config/opencode/skills/`).
 
-Pup is also available as a **Claude Code plugin marketplace**:
+Pup ships plugin manifest files for several AI coding assistants:
 
 ```
+# Claude Code
 /plugin marketplace add DataDog/pup
+
+# Codex (reads .codex-plugin/plugin.json from the repo, or marketplace.json from ~/.agents/plugins/)
 ```
 
 ## ACP Server

SKILL.md

@@ -17,13 +17,22 @@ Rust-based CLI for Datadog APIs. 49 command groups, 300+ subcommands across 53 c
 ## Install Skills
 
 ```bash
-# Install all skills and agents for your AI coding assistant
+# Install all skills and agents for the auto-detected AI assistant
 pup skills install
 
-# Or install specific skills
-pup skills install dd-pup
-pup skills install dd-monitors
-pup skills install dd-logs
+# Or install for a specific platform (claude, cursor, codex, opencode, pi)
+pup skills install claude
+pup skills install codex
+pup skills install cursor
+
+# Install for every supported platform at once
+pup skills install all
+
+# Install a single skill by name
+pup skills install claude --name dd-pup
+
+# Default scope is user-global; pass --project to install into the repo
+pup skills install claude --project
 
 # List all available skills
 pup skills list

docs/COMMANDS.md

@@ -77,7 +77,7 @@ pup <domain> <subgroup> <action> [options] # Nested commands
 | code-coverage | branch-summary, commit-summary | src/commands/code_coverage.rs | ✅ |
 | hamr | connections (get, create) | src/commands/hamr.rs | ✅ |
 | fleet | agents (list, get, versions, tracers), deployments (list, get, configure, upgrade, cancel), schedules (list, get, create, update, delete, trigger), tracers (list), clusters (list), instrumented-pods (list) | src/commands/fleet.rs | ✅ |
-| skills | list, install, path (entry types: skill, agent, extension; `--platform`/`--user` for extensions) | src/commands/skills.rs | ✅ |
+| skills | list, install, path (positional `<platform>`: claude/cursor/codex/opencode/windsurf/gemini/pi/all; `--name`, `--type`, `--project` for project-local scope) | src/commands/skills.rs | ✅ |
 | runbooks | list, describe, run, import, validate | src/commands/runbooks.rs | ✅ |
 | workflows | get, create, update, delete, run, instances (list, get, cancel), connections (get, create, update, delete) | src/commands/workflows.rs | ✅ |
 | investigations | list, get, trigger | src/commands/investigations.rs | ✅ |

skills/extensions/dd-pup-pi/README.md

@@ -12,14 +12,11 @@ brew tap datadog-labs/pack
 brew install pup
 pup auth login
 
-# 2. install the extension
-#    Default: project-local when run inside a git repo
-#    (<repo>/.pi/extensions/dd-pup-pi/), user-global otherwise
-#    (~/.pi/agent/extensions/dd-pup-pi/).
-pup skills install --platform=pi
-
-# Force user-global install regardless of cwd:
-pup skills install --platform=pi --user
+# 2. install the extension (defaults to user-global ~/.pi/agent/extensions)
+pup skills install pi
+
+# Install project-local instead (<repo>/.pi/extensions/dd-pup-pi):
+pup skills install pi --project
 ```
 
 pi auto-discovers the extension on next launch (or via `/reload`).