@modootoday/pmcp 0.18.2 → 0.18.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (99) hide show
  1. package/.agents/plugins/marketplace.json +1 -1
  2. package/.claude-plugin/marketplace.json +1 -1
  3. package/.claude-plugin/plugin.json +1 -1
  4. package/.mcp.json +1 -1
  5. package/CONTRIBUTING.md +10 -1
  6. package/README.md +22 -20
  7. package/dist/{apply-JUTGS5WZ.js → apply-S2QI72W3.js} +11 -11
  8. package/dist/{available-DBSIVVJ6.js → available-GFMTJW4E.js} +3 -3
  9. package/dist/{chunk-DMZHQZ7P.js → chunk-2RTRY45B.js} +2 -2
  10. package/dist/{chunk-TXQ7L33K.js → chunk-3MEYKFFO.js} +3 -3
  11. package/dist/{chunk-KMXRRSKT.js → chunk-4CRRLDDS.js} +1 -1
  12. package/dist/{chunk-PKODFR5F.js → chunk-4GSGT55G.js} +2 -2
  13. package/dist/{chunk-3IDXEV5E.js → chunk-6BN35BHI.js} +3 -3
  14. package/dist/{chunk-T3LKX23M.js → chunk-7B6IC3F7.js} +3 -3
  15. package/dist/{chunk-D77IRGHO.js → chunk-7DEYLLIE.js} +5 -5
  16. package/dist/{chunk-2FIV63WC.js → chunk-7PTG42QU.js} +5 -5
  17. package/dist/chunk-AF2IBMWN.js +7 -0
  18. package/dist/{chunk-QEF7EK3T.js → chunk-CKTN6LKP.js} +2 -2
  19. package/dist/{chunk-F5QYZK7E.js → chunk-E5XVSMBR.js} +2 -2
  20. package/dist/{chunk-FENOGX3U.js → chunk-F5LEGPGP.js} +2 -2
  21. package/dist/{chunk-BBTBJCFA.js → chunk-F5WBMUOT.js} +2 -2
  22. package/dist/{chunk-7UCZAN4J.js → chunk-FX3LTTMB.js} +2 -2
  23. package/dist/{chunk-5QQWS4US.js → chunk-HEBCQTOD.js} +2 -2
  24. package/dist/{chunk-AJ4VXM2U.js → chunk-HEWZ6INU.js} +2 -2
  25. package/dist/{chunk-LW4TG7EL.js → chunk-HFE4QDJQ.js} +2 -2
  26. package/dist/{chunk-I2ZP2PSA.js → chunk-HQWVGU3W.js} +5 -5
  27. package/dist/{chunk-IG33DXLT.js → chunk-IIBB37JE.js} +18 -18
  28. package/dist/{chunk-MPSQXSC6.js → chunk-ISZOLR3D.js} +5 -3
  29. package/dist/{chunk-A7VF7A35.js → chunk-JM2KR2WJ.js} +5 -5
  30. package/dist/{chunk-CJTKR6K6.js → chunk-JZK7ZO7K.js} +2 -2
  31. package/dist/{chunk-RPQOBHVU.js → chunk-M455QSCW.js} +3 -3
  32. package/dist/{chunk-7GBYECSK.js → chunk-NLHLA2N5.js} +3 -3
  33. package/dist/{chunk-HDMBVLCZ.js → chunk-NWOV2E26.js} +2 -2
  34. package/dist/{chunk-VMHUEOT5.js → chunk-QK4G7FCU.js} +7 -7
  35. package/dist/{chunk-47O3X4VS.js → chunk-QRCAGKC6.js} +1 -1
  36. package/dist/{chunk-7HFIGCSL.js → chunk-TAOOPXBV.js} +2 -2
  37. package/dist/{chunk-3FCFAQDG.js → chunk-TZORR6GZ.js} +2 -2
  38. package/dist/{chunk-NLEXKE7U.js → chunk-WM2RF2MI.js} +3 -3
  39. package/dist/{chunk-VRPMYPZU.js → chunk-XJUNAVU2.js} +2 -2
  40. package/dist/{chunk-TNCZ6444.js → chunk-Y2XASHVY.js} +2 -2
  41. package/dist/cli.js +3 -3
  42. package/dist/{completion-ILSRB3LW.js → completion-GYN7PX3T.js} +2 -2
  43. package/dist/{diagnostics-XKXVVQWH.js → diagnostics-WACXQ33W.js} +6 -6
  44. package/dist/{doctor-O2E63YGO.js → doctor-VSQ72A6X.js} +11 -11
  45. package/dist/{entry-X6CSYQRQ.js → entry-VFEZC2XB.js} +10 -10
  46. package/dist/{exec-mcp-2PMWBPD7.js → exec-mcp-TOQEJFK3.js} +6 -6
  47. package/dist/{harness-L2KSI2ZB.js → harness-XCEWFGCG.js} +3 -3
  48. package/dist/harness-launch-gate.js +4 -4
  49. package/dist/harness-worker.js +6 -6
  50. package/dist/{hooks-BHTA44X7.js → hooks-32AFBC3Z.js} +3 -3
  51. package/dist/{host-UWK754BW.js → host-72OLHUX7.js} +8 -8
  52. package/dist/{host-UIZAXXQH.js → host-TE5PNDHJ.js} +7 -7
  53. package/dist/{host-run-BI2OTZDZ.js → host-run-MXCH26ZD.js} +5 -5
  54. package/dist/http.js +5 -5
  55. package/dist/{import-mcp-GPKJI7DI.js → import-mcp-QWGZSIZR.js} +4 -4
  56. package/dist/index.d.ts +1 -1
  57. package/dist/index.js +16 -16
  58. package/dist/{init-3C2Y7BNJ.js → init-5M3XWOTJ.js} +2 -2
  59. package/dist/{install-GG7HHZK2.js → install-MQ7QSJQ7.js} +3 -3
  60. package/dist/{invoke-44CJRVMK.js → invoke-SFSN4XT7.js} +8 -8
  61. package/dist/{list-MCP2FXUF.js → list-FB6RNYYB.js} +3 -3
  62. package/dist/{list-WL6L4J5H.js → list-FGDUU5DL.js} +6 -6
  63. package/dist/{logout-F5EJ5MOU.js → logout-KM5N5GOC.js} +5 -5
  64. package/dist/mailbox/index.js +4 -4
  65. package/dist/{mailbox-GDJ7BWQN.js → mailbox-5DWLH4W2.js} +3 -3
  66. package/dist/{mcp-235QZN2A.js → mcp-ND6ZQWJE.js} +2 -2
  67. package/dist/{project-5YV5CUEG.js → project-LZKQUV2W.js} +4 -4
  68. package/dist/{reindex-Y27QJFDB.js → reindex-ZULHSQWY.js} +5 -5
  69. package/dist/{run-3SOVRQIA.js → run-X4663F4M.js} +4 -4
  70. package/dist/{run-3AXTZSR7.js → run-YEVGHGTN.js} +4 -4
  71. package/dist/{serve-DQMKTFIV.js → serve-S7MF42SS.js} +12 -12
  72. package/dist/{start-login-YTZV6KMF.js → start-login-GKFGTE2A.js} +5 -5
  73. package/dist/{status-MROQ7WR7.js → status-FYG6XYQ6.js} +5 -5
  74. package/dist/{status-UME2L33L.js → status-XG5GRWVU.js} +8 -8
  75. package/dist/stdio.js +7 -7
  76. package/dist/{test-AGZOJLRZ.js → test-KFDO6ROC.js} +5 -5
  77. package/dist/{tui-G5LLWCSV.js → tui-2MP7DRIX.js} +4 -4
  78. package/dist/{validate-IU52H2IC.js → validate-AVM2VHMM.js} +4 -4
  79. package/dist/{worker-QZ5T6LJD.js → worker-3VS6RQEL.js} +8 -8
  80. package/docs/compatibility.md +2 -1
  81. package/docs/known-issues.md +17 -0
  82. package/docs/upgrading.md +23 -0
  83. package/gemini-extension.json +2 -2
  84. package/mcp.json +1 -1
  85. package/package.json +5 -6
  86. package/plugin.json +1 -1
  87. package/plugins/pmcp/.claude-plugin/plugin.json +1 -1
  88. package/plugins/pmcp/.mcp.json +1 -1
  89. package/plugins/pmcp/gemini-extension.json +2 -2
  90. package/plugins/pmcp/mcp.json +1 -1
  91. package/plugins/pmcp/plugin.json +1 -1
  92. package/plugins/pmcp/skills/agent-assets-migrate/SKILL.md +8 -8
  93. package/plugins/pmcp/skills/marketplace-plugin-scaffold/SKILL.md +10 -8
  94. package/plugins/pmcp/skills/skill-package-scaffold/SKILL.md +12 -12
  95. package/skills/agent-assets-migrate/SKILL.md +8 -8
  96. package/skills/marketplace-plugin-scaffold/SKILL.md +10 -8
  97. package/skills/skill-package-scaffold/SKILL.md +12 -12
  98. package/CHANGELOG.md +0 -152
  99. package/dist/chunk-65KAQSJP.js +0 -7
package/dist/stdio.js CHANGED
@@ -4,15 +4,15 @@ import {
4
4
  resolveRoots,
5
5
  serve,
6
6
  serveWithMailbox
7
- } from "./chunk-RPQOBHVU.js";
8
- import "./chunk-D77IRGHO.js";
7
+ } from "./chunk-M455QSCW.js";
8
+ import "./chunk-7DEYLLIE.js";
9
9
  import "./chunk-6WXMJOMI.js";
10
- import "./chunk-KMXRRSKT.js";
10
+ import "./chunk-4CRRLDDS.js";
11
11
  import "./chunk-YSAWTGNA.js";
12
- import "./chunk-HDMBVLCZ.js";
13
- import "./chunk-CJTKR6K6.js";
14
- import "./chunk-TNCZ6444.js";
15
- import "./chunk-47O3X4VS.js";
12
+ import "./chunk-NWOV2E26.js";
13
+ import "./chunk-JZK7ZO7K.js";
14
+ import "./chunk-Y2XASHVY.js";
15
+ import "./chunk-QRCAGKC6.js";
16
16
  import "./chunk-6STKGOCW.js";
17
17
  import "./chunk-QPL7E2HW.js";
18
18
  import "./chunk-PMJG2CXF.js";
@@ -1,6 +1,6 @@
1
1
  import {
2
2
  specFrom
3
- } from "./chunk-FENOGX3U.js";
3
+ } from "./chunk-F5LEGPGP.js";
4
4
  import {
5
5
  sourceFor
6
6
  } from "./chunk-7TD53M7L.js";
@@ -12,7 +12,7 @@ import {
12
12
  RUNTIME_IDS,
13
13
  commandsOf,
14
14
  customPolicy
15
- } from "./chunk-VRPMYPZU.js";
15
+ } from "./chunk-XJUNAVU2.js";
16
16
  import {
17
17
  DEFAULT_LOG_SETTINGS,
18
18
  LEVEL_RANK
@@ -47,7 +47,7 @@ import {
47
47
  one
48
48
  } from "./chunk-A4PKLESO.js";
49
49
  import "./chunk-V4NPDK6X.js";
50
- import "./chunk-7HFIGCSL.js";
50
+ import "./chunk-TAOOPXBV.js";
51
51
  import {
52
52
  expandPath
53
53
  } from "./chunk-OEH47H6A.js";
@@ -55,7 +55,7 @@ import {
55
55
  checkoutOf,
56
56
  worktreesOf
57
57
  } from "./chunk-IJBSOWHK.js";
58
- import "./chunk-65KAQSJP.js";
58
+ import "./chunk-AF2IBMWN.js";
59
59
  import "./chunk-QPL7E2HW.js";
60
60
  import "./chunk-PMJG2CXF.js";
61
61
 
@@ -558,4 +558,4 @@ async function run(context) {
558
558
  export {
559
559
  run
560
560
  };
561
- //# sourceMappingURL=test-AGZOJLRZ.js.map
561
+ //# sourceMappingURL=test-KFDO6ROC.js.map
@@ -112,10 +112,10 @@ var tuiCommand = {
112
112
  try {
113
113
  let receipt;
114
114
  if (invocation.action === "doctor") {
115
- const { inspectTerminalHost } = await import("./diagnostics-XKXVVQWH.js");
115
+ const { inspectTerminalHost } = await import("./diagnostics-WACXQ33W.js");
116
116
  receipt = inspectTerminalHost();
117
117
  } else if (invocation.action === "start-worker") {
118
- const { startWorkspaceWorker } = await import("./worker-QZ5T6LJD.js");
118
+ const { startWorkspaceWorker } = await import("./worker-3VS6RQEL.js");
119
119
  receipt = await startWorkspaceWorker(
120
120
  { config: invocation.startup?.config, cwd: context.cwd },
121
121
  invocation.startup.runtime,
@@ -128,7 +128,7 @@ var tuiCommand = {
128
128
  cwd: context.cwd
129
129
  });
130
130
  } else {
131
- const { launchStartup, planStartup } = await import("./entry-X6CSYQRQ.js");
131
+ const { launchStartup, planStartup } = await import("./entry-VFEZC2XB.js");
132
132
  const request = { ...invocation.startup, cwd: context.cwd };
133
133
  receipt = invocation.action === "plan" ? planStartup(request) : await launchStartup(
134
134
  request,
@@ -150,4 +150,4 @@ var tuiCommand = {
150
150
  export {
151
151
  tuiCommand
152
152
  };
153
- //# sourceMappingURL=tui-G5LLWCSV.js.map
153
+ //# sourceMappingURL=tui-2MP7DRIX.js.map
@@ -1,20 +1,20 @@
1
1
  import {
2
2
  catalogOptionsFrom
3
- } from "./chunk-5QQWS4US.js";
3
+ } from "./chunk-HEBCQTOD.js";
4
4
  import {
5
5
  configFrom
6
6
  } from "./chunk-7DLZC73N.js";
7
7
  import {
8
8
  validateCatalog,
9
9
  validateSkillDir
10
- } from "./chunk-AJ4VXM2U.js";
10
+ } from "./chunk-HEWZ6INU.js";
11
11
  import "./chunk-73AKO4UL.js";
12
12
  import {
13
13
  validateSpec
14
14
  } from "./chunk-INT7QLEU.js";
15
15
  import "./chunk-JEL35P7S.js";
16
16
  import "./chunk-A4PKLESO.js";
17
- import "./chunk-KMXRRSKT.js";
17
+ import "./chunk-4CRRLDDS.js";
18
18
  import "./chunk-YSAWTGNA.js";
19
19
  import "./chunk-QPL7E2HW.js";
20
20
  import "./chunk-PMJG2CXF.js";
@@ -43,4 +43,4 @@ var validateCommand = {
43
43
  export {
44
44
  validateCommand
45
45
  };
46
- //# sourceMappingURL=validate-IU52H2IC.js.map
46
+ //# sourceMappingURL=validate-AVM2VHMM.js.map
@@ -1,24 +1,24 @@
1
1
  import {
2
2
  invoke
3
- } from "./chunk-2FIV63WC.js";
3
+ } from "./chunk-7PTG42QU.js";
4
4
  import {
5
5
  readStartup,
6
6
  startupFile,
7
7
  startupSettings
8
8
  } from "./chunk-PAX3QXX2.js";
9
9
  import "./chunk-DZ2MRTYT.js";
10
- import "./chunk-3IDXEV5E.js";
11
- import "./chunk-LW4TG7EL.js";
10
+ import "./chunk-6BN35BHI.js";
11
+ import "./chunk-HFE4QDJQ.js";
12
12
  import {
13
13
  locateExecutable
14
14
  } from "./chunk-R2GPCZUX.js";
15
- import "./chunk-7UCZAN4J.js";
15
+ import "./chunk-FX3LTTMB.js";
16
16
  import "./chunk-34DECPVC.js";
17
- import "./chunk-DMZHQZ7P.js";
18
- import "./chunk-7HFIGCSL.js";
17
+ import "./chunk-2RTRY45B.js";
18
+ import "./chunk-TAOOPXBV.js";
19
19
  import "./chunk-OEH47H6A.js";
20
20
  import "./chunk-IJBSOWHK.js";
21
- import "./chunk-65KAQSJP.js";
21
+ import "./chunk-AF2IBMWN.js";
22
22
  import "./chunk-QPL7E2HW.js";
23
23
  import "./chunk-PMJG2CXF.js";
24
24
  import {
@@ -77,4 +77,4 @@ async function startWorkspaceWorker(request, runtime, memoryMb) {
77
77
  export {
78
78
  startWorkspaceWorker
79
79
  };
80
- //# sourceMappingURL=worker-QZ5T6LJD.js.map
80
+ //# sourceMappingURL=worker-3VS6RQEL.js.map
@@ -2,7 +2,8 @@
2
2
 
3
3
  [Back to the overview](../README.md)
4
4
 
5
- What runs where. Other pages link here instead of repeating requirements.
5
+ What runs where. Other pages link here instead of repeating requirements. What does not work yet
6
+ is on [Known issues](known-issues.md).
6
7
 
7
8
  ## Platforms
8
9
 
@@ -0,0 +1,17 @@
1
+ # Known issues
2
+
3
+ [Back to the overview](../README.md)
4
+
5
+ What the current release does not do yet, and what to do instead. An entry leaves this page in
6
+ the commit that fixes it, so the fix shows in that release's notes.
7
+
8
+ - macOS binaries are unsigned. They run when installed through npm, which sets no quarantine
9
+ flag. (`scripts/platform-packages.mjs`)
10
+ - Windows is not supported: the harness, `pmcp tui` and pmcp-pty stop with
11
+ `platform_unsupported`. (`src/harness/platform.ts`)
12
+ - `pmcp harness host up` and `host unit` need Linux with a user systemd manager; on macOS
13
+ they refuse with `platform_unsupported`. Use `pmcp tui` or a harness group there.
14
+ (`src/harness/platform.ts`)
15
+ - pmcp-browser and pmcp-desktop ship for Linux only. (`scripts/platform-packages.mjs`)
16
+ - `[sessions.roles]` applies to Claude Code only; Codex and the other runtimes send no agent
17
+ type. ([Hooks](hooks.md#runtime-support))
@@ -0,0 +1,23 @@
1
+ # Upgrading
2
+
3
+ [Back to the overview](../README.md)
4
+
5
+ What to do when a release changes something you rely on. Each release's notes on GitHub
6
+ Releases list its breaking changes and link here.
7
+
8
+ ## From 0.17 to 0.18
9
+
10
+ 0.18 replaces tmux with pmcp's own terminal host, so it does not read tmux groups or views.
11
+ Stop what 0.17 started before you upgrade, with the 0.17 release that created it:
12
+
13
+ ```sh
14
+ npx @modootoday/pmcp@0.17.4 tui recovery # a workspace from bare pmcp: prints groupFile and generation
15
+ npx @modootoday/pmcp@0.17.4 tui close --view "$VIEW_FILE"
16
+ npx @modootoday/pmcp@0.17.4 harness group inspect --group-file "$GROUP_FILE" # any other group: prints the generation
17
+ npx @modootoday/pmcp@0.17.4 harness group stop --group-file "$GROUP_FILE" --generation "$GENERATION"
18
+ ```
19
+
20
+ Then upgrade and start a new workspace with `pmcp tui --new` (plain `pmcp` once no 0.17
21
+ checkpoint is left). Scripts that called the removed `pmcp tui` view operations now get a
22
+ usage error (exit 2). The terminal workspace needs Linux or macOS; see
23
+ [Compatibility](compatibility.md).
@@ -1,11 +1,11 @@
1
1
  {
2
2
  "name": "pmcp",
3
- "version": "0.18.2",
3
+ "version": "0.18.3",
4
4
  "mcpServers": {
5
5
  "pmcp": {
6
6
  "type": "stdio",
7
7
  "command": "npx",
8
- "args": ["-y", "@modootoday/pmcp@0.18.2", "serve"]
8
+ "args": ["-y", "@modootoday/pmcp@0.18.3", "serve"]
9
9
  }
10
10
  }
11
11
  }
package/mcp.json CHANGED
@@ -4,7 +4,7 @@
4
4
  "pmcp": {
5
5
  "type": "stdio",
6
6
  "command": "npx",
7
- "args": ["-y", "@modootoday/pmcp@0.18.2", "serve"]
7
+ "args": ["-y", "@modootoday/pmcp@0.18.3", "serve"]
8
8
  }
9
9
  }
10
10
  }
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@modootoday/pmcp",
3
- "version": "0.18.2",
3
+ "version": "0.18.3",
4
4
  "license": "Elastic-2.0",
5
5
  "author": "modootoday",
6
6
  "description": "Use the skills your packages already ship, and keep your AI tools' project configuration in one place.",
@@ -75,7 +75,6 @@
75
75
  "docs/hooks/capabilities/*.json",
76
76
  "docs/*.md",
77
77
  "README.md",
78
- "CHANGELOG.md",
79
78
  "CONTRIBUTING.md",
80
79
  "SECURITY.md",
81
80
  "LICENSE",
@@ -137,9 +136,9 @@
137
136
  "bun": ">=1.3.0"
138
137
  },
139
138
  "optionalDependencies": {
140
- "@modootoday/pmcp-linux-x64": "0.18.2",
141
- "@modootoday/pmcp-linux-arm64": "0.18.2",
142
- "@modootoday/pmcp-darwin-x64": "0.18.2",
143
- "@modootoday/pmcp-darwin-arm64": "0.18.2"
139
+ "@modootoday/pmcp-linux-x64": "0.18.3",
140
+ "@modootoday/pmcp-linux-arm64": "0.18.3",
141
+ "@modootoday/pmcp-darwin-x64": "0.18.3",
142
+ "@modootoday/pmcp-darwin-arm64": "0.18.3"
144
143
  }
145
144
  }
package/plugin.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
3
3
  "name": "pmcp",
4
- "version": "0.18.2",
4
+ "version": "0.18.3",
5
5
  "description": "Find package skills and use native runtime project configuration.",
6
6
  "author": { "name": "modootoday" },
7
7
  "license": "Elastic-2.0",
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "pmcp",
3
- "version": "0.18.2",
3
+ "version": "0.18.3",
4
4
  "description": "Find package skills and use native runtime project configuration.",
5
5
  "author": { "name": "modootoday" },
6
6
  "license": "Elastic-2.0",
@@ -3,7 +3,7 @@
3
3
  "pmcp": {
4
4
  "type": "stdio",
5
5
  "command": "npx",
6
- "args": ["-y", "@modootoday/pmcp@0.18.2", "serve"]
6
+ "args": ["-y", "@modootoday/pmcp@0.18.3", "serve"]
7
7
  }
8
8
  }
9
9
  }
@@ -1,11 +1,11 @@
1
1
  {
2
2
  "name": "pmcp",
3
- "version": "0.18.2",
3
+ "version": "0.18.3",
4
4
  "mcpServers": {
5
5
  "pmcp": {
6
6
  "type": "stdio",
7
7
  "command": "npx",
8
- "args": ["-y", "@modootoday/pmcp@0.18.2", "serve"]
8
+ "args": ["-y", "@modootoday/pmcp@0.18.3", "serve"]
9
9
  }
10
10
  }
11
11
  }
@@ -4,7 +4,7 @@
4
4
  "pmcp": {
5
5
  "type": "stdio",
6
6
  "command": "npx",
7
- "args": ["-y", "@modootoday/pmcp@0.18.2", "serve"]
7
+ "args": ["-y", "@modootoday/pmcp@0.18.3", "serve"]
8
8
  }
9
9
  }
10
10
  }
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
3
3
  "name": "pmcp",
4
- "version": "0.18.2",
4
+ "version": "0.18.3",
5
5
  "description": "Find package skills and use native runtime project configuration.",
6
6
  "author": { "name": "modootoday" },
7
7
  "license": "Elastic-2.0",
@@ -21,14 +21,14 @@ tool files.
21
21
 
22
22
  List every source with its bytes and line count, and note which are links:
23
23
 
24
- | Found | Goes to |
25
- | --- | --- |
26
- | `CLAUDE.md`, `GEMINI.md`, `.cursorrules`, `.windsurfrules`, `.github/copilot-instructions.md` | merged into `AGENTS.md`; each then becomes a link to it |
27
- | `.claude/skills/<n>/`, `.agent/skills/<n>/` | `.agents/skills/<n>/` (whole folder) |
28
- | `.claude/commands/<n>.md`, `.agent/workflows/<n>.md` | `.agents/skills/<n>/SKILL.md` plus `[skills.<n>] invocation = "user"` |
29
- | `.claude/agents/<n>.md`, `.gemini/agents/<n>.md`, `.agent/agents/<n>.md` | `.agents/agents/<n>/agent.md` |
30
- | `.claude/rules/*.md` with `paths:` | `.agents/rules/<n>.md` with `trigger: glob` and `globs:` |
31
- | MCP entries in `.mcp.json`, `.gemini/settings.json`, `.codex/config.toml` | `[mcp.<alias>]` in `pmcp.toml` |
24
+ | Found | Goes to |
25
+ | --------------------------------------------------------------------------------------------- | --------------------------------------------------------------------- |
26
+ | `CLAUDE.md`, `GEMINI.md`, `.cursorrules`, `.windsurfrules`, `.github/copilot-instructions.md` | merged into `AGENTS.md`; each then becomes a link to it |
27
+ | `.claude/skills/<n>/`, `.agent/skills/<n>/` | `.agents/skills/<n>/` (whole folder) |
28
+ | `.claude/commands/<n>.md`, `.agent/workflows/<n>.md` | `.agents/skills/<n>/SKILL.md` plus `[skills.<n>] invocation = "user"` |
29
+ | `.claude/agents/<n>.md`, `.gemini/agents/<n>.md`, `.agent/agents/<n>.md` | `.agents/agents/<n>/agent.md` |
30
+ | `.claude/rules/*.md` with `paths:` | `.agents/rules/<n>.md` with `trigger: glob` and `globs:` |
31
+ | MCP entries in `.mcp.json`, `.gemini/settings.json`, `.codex/config.toml` | `[mcp.<alias>]` in `pmcp.toml` |
32
32
 
33
33
  pmcp has no Copilot or Cursor target. Keep those filenames as links to `AGENTS.md` so they
34
34
  cannot drift.
@@ -37,7 +37,9 @@ reason, not served.
37
37
  {
38
38
  "name": "acme",
39
39
  "metadata": { "tier": "open" },
40
- "plugins": [{ "name": "billing-skills", "source": "./plugins/billing-skills" }]
40
+ "plugins": [
41
+ { "name": "billing-skills", "source": "./plugins/billing-skills" }
42
+ ]
41
43
  }
42
44
  ```
43
45
 
@@ -55,13 +57,13 @@ name a different hooks file (a string path); otherwise `hooks/hooks.json` is rea
55
57
 
56
58
  ## What each place becomes
57
59
 
58
- | Place | Catalog entry | Name in the catalog |
59
- | --- | --- | --- |
60
- | `skills/<name>/SKILL.md` | a skill; its folder is what describe and read may open | `<marketplace>/<plugin>/<name>` |
61
- | `commands/<name>.md` | a one-file skill; only that file is readable | `<marketplace>/<plugin>/<name>` |
62
- | `agents/<name>.md`, `agents/<name>/agent.md` | kind `agent` | `<marketplace>/<plugin>/agents/<name>` |
63
- | `hooks/hooks.json` | one kind `hook` entry for the plugin; needs a `description` in the file or in plugin.json | `<marketplace>/<plugin>/hooks` |
64
- | `.mcp.json` | one kind `mcp` entry per key of `mcpServers` | `<marketplace>/<plugin>/mcp/<server>` |
60
+ | Place | Catalog entry | Name in the catalog |
61
+ | -------------------------------------------- | ----------------------------------------------------------------------------------------- | -------------------------------------- |
62
+ | `skills/<name>/SKILL.md` | a skill; its folder is what describe and read may open | `<marketplace>/<plugin>/<name>` |
63
+ | `commands/<name>.md` | a one-file skill; only that file is readable | `<marketplace>/<plugin>/<name>` |
64
+ | `agents/<name>.md`, `agents/<name>/agent.md` | kind `agent` | `<marketplace>/<plugin>/agents/<name>` |
65
+ | `hooks/hooks.json` | one kind `hook` entry for the plugin; needs a `description` in the file or in plugin.json | `<marketplace>/<plugin>/hooks` |
66
+ | `.mcp.json` | one kind `mcp` entry per key of `mcpServers` | `<marketplace>/<plugin>/mcp/<server>` |
65
67
 
66
68
  Skills and commands appear in `skill_catalog` and `skill_find`. Agents, hooks and MCP
67
69
  servers are left out unless the caller asks for that `kind` (`agent`, `hook`, `mcp` or
@@ -37,14 +37,14 @@ for code that is not there.
37
37
 
38
38
  These are the Agent Skills checks `pmcp validate` always runs:
39
39
 
40
- | Field | Rule |
41
- | --- | --- |
42
- | `name` | required; at most 64 characters; lowercase letters, digits and single hyphens, not starting or ending with one; equal to the directory name |
43
- | `description` | required, non-blank; at most 1024 characters |
44
- | `compatibility` | optional string; at most 500 characters |
45
- | `license` | optional string |
46
- | `allowed-tools` | optional; one space-separated string, not a list |
47
- | `metadata` | optional map |
40
+ | Field | Rule |
41
+ | --------------- | ------------------------------------------------------------------------------------------------------------------------------------------- |
42
+ | `name` | required; at most 64 characters; lowercase letters, digits and single hyphens, not starting or ending with one; equal to the directory name |
43
+ | `description` | required, non-blank; at most 1024 characters |
44
+ | `compatibility` | optional string; at most 500 characters |
45
+ | `license` | optional string |
46
+ | `allowed-tools` | optional; one space-separated string, not a list |
47
+ | `metadata` | optional map |
48
48
 
49
49
  A marketplace may add its own rules on top (a metadata schema, tiers, ASCII-only text).
50
50
  `pmcp validate` checks them only when `pmcp.toml` names a profile in `[catalog.validation]`
@@ -59,10 +59,10 @@ description: Draft a reply to a customer disputing an invoice ... Use when ... N
59
59
 
60
60
  ## Evals: three cases, each self-contained
61
61
 
62
- | Case | Tests |
63
- | --- | --- |
64
- | normal | the common request, with every input present |
65
- | exception | the input that should change the answer: a rule's exception, an edge value, a refusal |
62
+ | Case | Tests |
63
+ | ------------ | --------------------------------------------------------------------------------------------- |
64
+ | normal | the common request, with every input present |
65
+ | exception | the input that should change the answer: a rule's exception, an edge value, a refusal |
66
66
  | missing-info | a request lacking something essential; the skill must ask or state the assumption, not invent |
67
67
 
68
68
  Each `prompt.md` must carry everything the case needs. The grader's sandbox starts empty, so
@@ -21,14 +21,14 @@ tool files.
21
21
 
22
22
  List every source with its bytes and line count, and note which are links:
23
23
 
24
- | Found | Goes to |
25
- | --- | --- |
26
- | `CLAUDE.md`, `GEMINI.md`, `.cursorrules`, `.windsurfrules`, `.github/copilot-instructions.md` | merged into `AGENTS.md`; each then becomes a link to it |
27
- | `.claude/skills/<n>/`, `.agent/skills/<n>/` | `.agents/skills/<n>/` (whole folder) |
28
- | `.claude/commands/<n>.md`, `.agent/workflows/<n>.md` | `.agents/skills/<n>/SKILL.md` plus `[skills.<n>] invocation = "user"` |
29
- | `.claude/agents/<n>.md`, `.gemini/agents/<n>.md`, `.agent/agents/<n>.md` | `.agents/agents/<n>/agent.md` |
30
- | `.claude/rules/*.md` with `paths:` | `.agents/rules/<n>.md` with `trigger: glob` and `globs:` |
31
- | MCP entries in `.mcp.json`, `.gemini/settings.json`, `.codex/config.toml` | `[mcp.<alias>]` in `pmcp.toml` |
24
+ | Found | Goes to |
25
+ | --------------------------------------------------------------------------------------------- | --------------------------------------------------------------------- |
26
+ | `CLAUDE.md`, `GEMINI.md`, `.cursorrules`, `.windsurfrules`, `.github/copilot-instructions.md` | merged into `AGENTS.md`; each then becomes a link to it |
27
+ | `.claude/skills/<n>/`, `.agent/skills/<n>/` | `.agents/skills/<n>/` (whole folder) |
28
+ | `.claude/commands/<n>.md`, `.agent/workflows/<n>.md` | `.agents/skills/<n>/SKILL.md` plus `[skills.<n>] invocation = "user"` |
29
+ | `.claude/agents/<n>.md`, `.gemini/agents/<n>.md`, `.agent/agents/<n>.md` | `.agents/agents/<n>/agent.md` |
30
+ | `.claude/rules/*.md` with `paths:` | `.agents/rules/<n>.md` with `trigger: glob` and `globs:` |
31
+ | MCP entries in `.mcp.json`, `.gemini/settings.json`, `.codex/config.toml` | `[mcp.<alias>]` in `pmcp.toml` |
32
32
 
33
33
  pmcp has no Copilot or Cursor target. Keep those filenames as links to `AGENTS.md` so they
34
34
  cannot drift.
@@ -37,7 +37,9 @@ reason, not served.
37
37
  {
38
38
  "name": "acme",
39
39
  "metadata": { "tier": "open" },
40
- "plugins": [{ "name": "billing-skills", "source": "./plugins/billing-skills" }]
40
+ "plugins": [
41
+ { "name": "billing-skills", "source": "./plugins/billing-skills" }
42
+ ]
41
43
  }
42
44
  ```
43
45
 
@@ -55,13 +57,13 @@ name a different hooks file (a string path); otherwise `hooks/hooks.json` is rea
55
57
 
56
58
  ## What each place becomes
57
59
 
58
- | Place | Catalog entry | Name in the catalog |
59
- | --- | --- | --- |
60
- | `skills/<name>/SKILL.md` | a skill; its folder is what describe and read may open | `<marketplace>/<plugin>/<name>` |
61
- | `commands/<name>.md` | a one-file skill; only that file is readable | `<marketplace>/<plugin>/<name>` |
62
- | `agents/<name>.md`, `agents/<name>/agent.md` | kind `agent` | `<marketplace>/<plugin>/agents/<name>` |
63
- | `hooks/hooks.json` | one kind `hook` entry for the plugin; needs a `description` in the file or in plugin.json | `<marketplace>/<plugin>/hooks` |
64
- | `.mcp.json` | one kind `mcp` entry per key of `mcpServers` | `<marketplace>/<plugin>/mcp/<server>` |
60
+ | Place | Catalog entry | Name in the catalog |
61
+ | -------------------------------------------- | ----------------------------------------------------------------------------------------- | -------------------------------------- |
62
+ | `skills/<name>/SKILL.md` | a skill; its folder is what describe and read may open | `<marketplace>/<plugin>/<name>` |
63
+ | `commands/<name>.md` | a one-file skill; only that file is readable | `<marketplace>/<plugin>/<name>` |
64
+ | `agents/<name>.md`, `agents/<name>/agent.md` | kind `agent` | `<marketplace>/<plugin>/agents/<name>` |
65
+ | `hooks/hooks.json` | one kind `hook` entry for the plugin; needs a `description` in the file or in plugin.json | `<marketplace>/<plugin>/hooks` |
66
+ | `.mcp.json` | one kind `mcp` entry per key of `mcpServers` | `<marketplace>/<plugin>/mcp/<server>` |
65
67
 
66
68
  Skills and commands appear in `skill_catalog` and `skill_find`. Agents, hooks and MCP
67
69
  servers are left out unless the caller asks for that `kind` (`agent`, `hook`, `mcp` or
@@ -37,14 +37,14 @@ for code that is not there.
37
37
 
38
38
  These are the Agent Skills checks `pmcp validate` always runs:
39
39
 
40
- | Field | Rule |
41
- | --- | --- |
42
- | `name` | required; at most 64 characters; lowercase letters, digits and single hyphens, not starting or ending with one; equal to the directory name |
43
- | `description` | required, non-blank; at most 1024 characters |
44
- | `compatibility` | optional string; at most 500 characters |
45
- | `license` | optional string |
46
- | `allowed-tools` | optional; one space-separated string, not a list |
47
- | `metadata` | optional map |
40
+ | Field | Rule |
41
+ | --------------- | ------------------------------------------------------------------------------------------------------------------------------------------- |
42
+ | `name` | required; at most 64 characters; lowercase letters, digits and single hyphens, not starting or ending with one; equal to the directory name |
43
+ | `description` | required, non-blank; at most 1024 characters |
44
+ | `compatibility` | optional string; at most 500 characters |
45
+ | `license` | optional string |
46
+ | `allowed-tools` | optional; one space-separated string, not a list |
47
+ | `metadata` | optional map |
48
48
 
49
49
  A marketplace may add its own rules on top (a metadata schema, tiers, ASCII-only text).
50
50
  `pmcp validate` checks them only when `pmcp.toml` names a profile in `[catalog.validation]`
@@ -59,10 +59,10 @@ description: Draft a reply to a customer disputing an invoice ... Use when ... N
59
59
 
60
60
  ## Evals: three cases, each self-contained
61
61
 
62
- | Case | Tests |
63
- | --- | --- |
64
- | normal | the common request, with every input present |
65
- | exception | the input that should change the answer: a rule's exception, an edge value, a refusal |
62
+ | Case | Tests |
63
+ | ------------ | --------------------------------------------------------------------------------------------- |
64
+ | normal | the common request, with every input present |
65
+ | exception | the input that should change the answer: a rule's exception, an edge value, a refusal |
66
66
  | missing-info | a request lacking something essential; the skill must ask or state the assumption, not invent |
67
67
 
68
68
  Each `prompt.md` must carry everything the case needs. The grader's sandbox starts empty, so