@unbrained/pm-cli 2026.5.6 → 2026.5.11

package/plugins/pm-cli-codex/skills/pm-native/SKILL.md

@@ -0,0 +1,57 @@
+---
+name: pm-native
+description: Use pm-cli natively in Codex through bundled MCP tools for planning, tracking, mutation, validation, and reporting without invoking the pm shell command.
+license: MIT
+---
+
+# pm Native Workflow
+
+Use this skill whenever a Codex task should be tracked through pm.
+
+## Tool Preference
+
+Use MCP tools before shell commands:
+
+- Orient: `pm_context`, `pm_search`, `pm_list`, `pm_get`
+- Mutate: `pm_create`, `pm_update`, `pm_claim`, `pm_release`, `pm_close`
+- Evidence: `pm_comments`, `pm_files`, `pm_docs`, `pm_test`
+- Verify: `pm_validate`, `pm_health`, `pm_contracts`
+- Everything else: `pm_run` with an explicit `action`
+
+Do not pass `path` during real repository work. For tests, pass a sandbox `cwd` or `path`.
+
+## Required Loop
+
+1. Run `pm_context`, `pm_search`, and `pm_list` before creating work.
+2. Reuse an existing item when one matches.
+3. Claim the item with `pm_claim`.
+4. Link changed files/docs/tests as work proceeds.
+5. Add concise evidence with `pm_comments`.
+6. Run linked and project verification.
+7. Close with `pm_close` and release with `pm_release`.
+
+## Native Argument Shape
+
+Most tools accept:
+
+```json
+{
+  "cwd": "/repo/root",
+  "author": "codex-agent",
+  "options": {
+    "limit": "10"
+  }
+}
+```
+
+`pm_run` accepts an `action` plus `options`:
+
+```json
+{
+  "action": "calendar",
+  "options": {
+    "view": "week",
+    "format": "markdown"
+  }
+}
+```

package/plugins/pm-cli-codex/skills/pm-native/agents/openai.yaml

@@ -0,0 +1,6 @@
+interface:
+  display_name: "pm Native"
+  short_description: "Track Codex work through native pm MCP tools"
+  icon_small: "./assets/pm-cli-small.svg"
+  icon_large: "./assets/pm-cli-small.svg"
+  default_prompt: "Use native pm tools to orient, claim, implement, verify, and close this task without shelling out to pm."

package/plugins/pm-cli-codex/skills/pm-release/SKILL.md

@@ -0,0 +1,19 @@
+---
+name: pm-release
+description: Run compatibility-gated pm-cli release workflows with native pm tools, linked evidence, and public-surface verification.
+license: MIT
+---
+
+# pm Release
+
+Use for release prep, compatibility gates, publication checks, and post-release verification.
+
+## Release Loop
+
+1. Find or create the release item after duplicate checks.
+2. Claim it and link release docs, changelog, compatibility scripts, and tests.
+3. Run sandboxed compatibility checks before changing release assets.
+4. Run full local gates before tagging or publishing.
+5. Verify public surfaces after publish and record results through `pm_comments`.
+
+Use `pm_run` for release-adjacent pm actions not exposed as narrow tools.

package/plugins/pm-cli-codex/skills/pm-release/agents/openai.yaml

@@ -0,0 +1,6 @@
+interface:
+  display_name: "pm Release"
+  short_description: "Run pm release workflows with linked evidence"
+  icon_small: "./assets/pm-cli-small.svg"
+  icon_large: "./assets/pm-cli-small.svg"
+  default_prompt: "Use native pm tools to prepare, gate, publish-check, and document this pm-cli release."