@modootoday/pmcp 0.17.4 → 0.18.2
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.
- package/.agents/plugins/marketplace.json +1 -1
- package/.claude-plugin/marketplace.json +1 -1
- package/.claude-plugin/plugin.json +2 -2
- package/.mcp.json +1 -1
- package/CHANGELOG.md +152 -0
- package/CONTRIBUTING.md +71 -0
- package/README.md +98 -201
- package/SECURITY.md +17 -1
- package/dist/apply-JUTGS5WZ.js +242 -0
- package/dist/{attachment-tU5FZrgZ.d.ts → attachment-D84OGI6n.d.ts} +1 -1
- package/dist/available-DBSIVVJ6.js +73 -0
- package/dist/broadcast-CBMVOV3G.js +18 -0
- package/dist/chunk-26WLNWDG.js +93 -0
- package/dist/chunk-2FIV63WC.js +252 -0
- package/dist/chunk-2P4Z2NUX.js +28 -0
- package/dist/chunk-34DECPVC.js +22 -0
- package/dist/chunk-3FCFAQDG.js +42 -0
- package/dist/chunk-3IDXEV5E.js +1934 -0
- package/dist/chunk-3PW4FI7U.js +32 -0
- package/dist/chunk-3Y3HDMHA.js +108 -0
- package/dist/chunk-47O3X4VS.js +113 -0
- package/dist/chunk-4NDEP7HU.js +26 -0
- package/dist/chunk-5OMOPUE6.js +39 -0
- package/dist/chunk-5QQWS4US.js +53 -0
- package/dist/chunk-5ZABTVSW.js +48 -0
- package/dist/chunk-65KAQSJP.js +7 -0
- package/dist/chunk-6STKGOCW.js +27 -0
- package/dist/chunk-6WXMJOMI.js +9 -0
- package/dist/chunk-73AKO4UL.js +24 -0
- package/dist/chunk-7DLZC73N.js +29 -0
- package/dist/chunk-7GBYECSK.js +72 -0
- package/dist/chunk-7HFIGCSL.js +419 -0
- package/dist/chunk-7TD53M7L.js +13 -0
- package/dist/chunk-7UCZAN4J.js +778 -0
- package/dist/chunk-A4PKLESO.js +112 -0
- package/dist/chunk-A7VF7A35.js +1025 -0
- package/dist/chunk-ABTJQ4QV.js +74 -0
- package/dist/chunk-AJ4VXM2U.js +349 -0
- package/dist/chunk-BBTBJCFA.js +380 -0
- package/dist/chunk-BU65MNVU.js +13 -0
- package/dist/chunk-C4NHQGHL.js +142 -0
- package/dist/chunk-CJTKR6K6.js +1213 -0
- package/dist/chunk-D77IRGHO.js +1246 -0
- package/dist/chunk-DCU2EXQV.js +78 -0
- package/dist/chunk-DMZHQZ7P.js +104 -0
- package/dist/chunk-DZ2MRTYT.js +135 -0
- package/dist/chunk-E2YOZ2FF.js +207 -0
- package/dist/chunk-E3DQB5LS.js +48 -0
- package/dist/chunk-EATCUWGG.js +66 -0
- package/dist/chunk-EAWPJHJ7.js +155 -0
- package/dist/chunk-EIDIVIAD.js +33 -0
- package/dist/chunk-F5QYZK7E.js +396 -0
- package/dist/chunk-F5XMGOOX.js +28 -0
- package/dist/chunk-FENOGX3U.js +31 -0
- package/dist/chunk-GZHHEHKY.js +44 -0
- package/dist/chunk-HDMBVLCZ.js +53 -0
- package/dist/chunk-HQOB7OQS.js +81 -0
- package/dist/chunk-I2ZP2PSA.js +211 -0
- package/dist/chunk-IG33DXLT.js +151 -0
- package/dist/chunk-IJBSOWHK.js +86 -0
- package/dist/chunk-INT7QLEU.js +114 -0
- package/dist/chunk-J7UYNJCR.js +9 -0
- package/dist/chunk-JEL35P7S.js +53 -0
- package/dist/chunk-JGJ4INEN.js +32 -0
- package/dist/chunk-JS5RTH4I.js +84 -0
- package/dist/chunk-JWRZDYB5.js +59 -0
- package/dist/chunk-KMXRRSKT.js +660 -0
- package/dist/chunk-LBXO4VPG.js +73 -0
- package/dist/chunk-LLBPVZXM.js +67 -0
- package/dist/chunk-LLT5FQBE.js +57 -0
- package/dist/chunk-LMT3PPXJ.js +17 -0
- package/dist/chunk-LMUBBIE2.js +83 -0
- package/dist/chunk-LTZH5E3G.js +479 -0
- package/dist/chunk-LW4TG7EL.js +39 -0
- package/dist/chunk-MPSQXSC6.js +346 -0
- package/dist/chunk-MVFH26QT.js +97 -0
- package/dist/chunk-NLEXKE7U.js +67 -0
- package/dist/chunk-NQPURJT5.js +44 -0
- package/dist/chunk-NRBQK6UX.js +105 -0
- package/dist/chunk-OEH47H6A.js +48 -0
- package/dist/chunk-OG7QR2DP.js +75 -0
- package/dist/chunk-OPYFEHKG.js +52 -0
- package/dist/chunk-P4N7DBD5.js +83 -0
- package/dist/chunk-PAX3QXX2.js +140 -0
- package/dist/chunk-PKODFR5F.js +102 -0
- package/dist/chunk-PMJG2CXF.js +122 -0
- package/dist/chunk-Q5H3L6Y4.js +23 -0
- package/dist/chunk-QEF7EK3T.js +28 -0
- package/dist/chunk-QEW4J3IZ.js +74 -0
- package/dist/chunk-QPL7E2HW.js +464 -0
- package/dist/chunk-R2GPCZUX.js +22 -0
- package/dist/chunk-R5MT42JS.js +284 -0
- package/dist/chunk-RMATE45Z.js +197 -0
- package/dist/chunk-RPQOBHVU.js +87 -0
- package/dist/chunk-S3PIAMXV.js +230 -0
- package/dist/chunk-T3LKX23M.js +168 -0
- package/dist/chunk-T6GOWHK6.js +30 -0
- package/dist/chunk-TIA4SPU2.js +10 -0
- package/dist/chunk-TNCZ6444.js +57 -0
- package/dist/chunk-TVL5RTE6.js +269 -0
- package/dist/chunk-TXQ7L33K.js +45 -0
- package/dist/chunk-UPQTAHUK.js +189 -0
- package/dist/chunk-V4NPDK6X.js +14 -0
- package/dist/chunk-VJFEN6DJ.js +38 -0
- package/dist/chunk-VMHUEOT5.js +643 -0
- package/dist/chunk-VRPMYPZU.js +4985 -0
- package/dist/chunk-WIW772I3.js +25 -0
- package/dist/chunk-XELAZAIM.js +136 -0
- package/dist/chunk-XNML2KIC.js +23 -0
- package/dist/chunk-XP2U3LO3.js +30 -0
- package/dist/chunk-YGOWIJPE.js +51 -0
- package/dist/chunk-YIXDHQYE.js +11 -0
- package/dist/chunk-YSAWTGNA.js +117 -0
- package/dist/claude-U2JC2DNQ.js +77 -0
- package/dist/cli-MI4ZCAZ3.js +41 -0
- package/dist/cli-ZN7ZVDEZ.js +46 -0
- package/dist/cli.js +144 -16197
- package/dist/completion-ILSRB3LW.js +142 -0
- package/dist/config-DnpLL2kT.d.ts +46 -0
- package/dist/{service-qpCsOXkQ.d.ts → core-C1LPjxK6.d.ts} +2 -6
- package/dist/diagnostics-XKXVVQWH.js +93 -0
- package/dist/doctor-O2E63YGO.js +538 -0
- package/dist/entry-X6CSYQRQ.js +305 -0
- package/dist/exec-mcp-2PMWBPD7.js +365 -0
- package/dist/harness-L2KSI2ZB.js +177 -0
- package/dist/harness-egress-bridge.js +4 -4
- package/dist/harness-launch-gate.js +47 -940
- package/dist/harness-pane-runner.js +13 -80
- package/dist/harness-worker.js +21 -2703
- package/dist/hook-body.js +5222 -0
- package/dist/hook-spec-C5fWTSCH.d.ts +100 -0
- package/dist/hook.js +26 -0
- package/dist/hooks-BHTA44X7.js +21 -0
- package/dist/host-UIZAXXQH.js +22 -0
- package/dist/host-UWK754BW.js +210 -0
- package/dist/host-run-BI2OTZDZ.js +307 -0
- package/dist/http.d.ts +5 -42
- package/dist/http.js +21 -2234
- package/dist/import-mcp-GPKJI7DI.js +400 -0
- package/dist/index.d.ts +146 -168
- package/dist/index.js +133 -4948
- package/dist/init-3C2Y7BNJ.js +14 -0
- package/dist/install-GG7HHZK2.js +796 -0
- package/dist/invoke-44CJRVMK.js +23 -0
- package/dist/list-MCP2FXUF.js +68 -0
- package/dist/list-WL6L4J5H.js +65 -0
- package/dist/load-BEUBABtB.d.ts +21 -0
- package/dist/logout-F5EJ5MOU.js +44 -0
- package/dist/logs-TBUA4UWU.js +107 -0
- package/dist/mailbox/index.d.ts +10 -5
- package/dist/mailbox/index.js +53 -1572
- package/dist/mailbox-BMTZOSZ7.js +285 -0
- package/dist/mailbox-GDJ7BWQN.js +189 -0
- package/dist/mainline-KAD2ERLP.js +639 -0
- package/dist/marketplace-G4VQET5W.js +191 -0
- package/dist/mcp-235QZN2A.js +15 -0
- package/dist/mcp-FJ2UQ4RH.js +193 -0
- package/dist/models-ISU4DCMA.js +32 -0
- package/dist/opencode-CN7JLQYO.js +60 -0
- package/dist/pause-7LILUVGL.js +18 -0
- package/dist/preview-DT7DWG5F.js +91 -0
- package/dist/project/hook-adapter.d.ts +5 -2
- package/dist/project/hook-adapter.js +41 -27
- package/dist/project-5YV5CUEG.js +70 -0
- package/dist/pty-XTJ4MIWK.js +94 -0
- package/dist/recovery-U6QB3PMT.js +100 -0
- package/dist/reindex-Y27QJFDB.js +22 -0
- package/dist/resume-26VFAAMH.js +18 -0
- package/dist/run-3AXTZSR7.js +126 -0
- package/dist/run-3SOVRQIA.js +19 -0
- package/dist/serve-DQMKTFIV.js +104 -0
- package/dist/session-XM2CR425.js +159 -0
- package/dist/setup-DTKZLZUT.js +18 -0
- package/dist/start-login-YTZV6KMF.js +416 -0
- package/dist/status-A2OUTNGK.js +9 -0
- package/dist/status-H2VAHIDV.js +10 -0
- package/dist/status-MROQ7WR7.js +43 -0
- package/dist/status-RO55QPKV.js +55 -0
- package/dist/status-UME2L33L.js +286 -0
- package/dist/stdio.d.ts +3 -13
- package/dist/stdio.js +16 -3186
- package/dist/sweep-35LGQTTO.js +18 -0
- package/dist/test-AGZOJLRZ.js +561 -0
- package/dist/tools-gpHNq9Dh.d.ts +328 -0
- package/dist/tui-G5LLWCSV.js +153 -0
- package/dist/unbroadcast-5QNGAJR2.js +18 -0
- package/dist/validate-IU52H2IC.js +46 -0
- package/dist/worker-QZ5T6LJD.js +80 -0
- package/dist/worktree-create-PZSRB7PH.js +89 -0
- package/dist/worktree-list-JYB6VXLW.js +51 -0
- package/dist/worktree-sync-UF5CXPWV.js +30 -0
- package/docs/authoring.md +82 -0
- package/docs/browser-and-desktop.md +46 -0
- package/docs/commands.md +325 -0
- package/docs/compare.md +35 -0
- package/docs/compatibility.md +55 -0
- package/docs/embeddings.md +1 -1
- package/docs/getting-started.md +105 -0
- package/docs/git-workflow.md +60 -0
- package/docs/glossary.md +31 -0
- package/docs/hooks/capabilities/antigravity.json +199 -0
- package/docs/hooks/capabilities/claude.json +179 -0
- package/docs/hooks/capabilities/codex.json +179 -0
- package/docs/hooks/capabilities/gemini.json +196 -0
- package/docs/hooks/capabilities/grok.json +192 -0
- package/docs/hooks/capabilities/opencode.json +184 -0
- package/docs/hooks.md +264 -0
- package/docs/install.md +72 -0
- package/docs/library-skills.md +132 -0
- package/docs/mailbox.md +16 -5
- package/docs/project-configuration.md +540 -58
- package/docs/sessions.md +64 -0
- package/docs/skills.md +4 -45
- package/docs/terminal-harness.md +92 -44
- package/docs/terminal-workspace.md +81 -169
- package/gemini-extension.json +2 -2
- package/mcp.json +1 -1
- package/package.json +16 -2
- package/plugin.json +2 -2
- package/plugins/pmcp/.claude-plugin/plugin.json +4 -2
- package/plugins/pmcp/.mcp.json +1 -1
- package/plugins/pmcp/gemini-extension.json +2 -2
- package/plugins/pmcp/mcp.json +1 -1
- package/plugins/pmcp/mod/commands.ts +72 -0
- package/plugins/pmcp/mod/contract.d.ts +39 -0
- package/plugins/pmcp/mod/draw.tsx +216 -0
- package/plugins/pmcp/mod/guard.ts +42 -0
- package/plugins/pmcp/mod/hooks.json +4 -0
- package/plugins/pmcp/mod/host.ts +46 -0
- package/plugins/pmcp/mod/model.ts +144 -0
- package/plugins/pmcp/mod/reader/index.ts +18 -0
- package/plugins/pmcp/mod/reader/read.ts +76 -0
- package/plugins/pmcp/mod/reader/settings.ts +54 -0
- package/plugins/pmcp/mod/reader/types.ts +38 -0
- package/plugins/pmcp/mod/register.tsx +73 -0
- package/plugins/pmcp/mod/sessions/format.ts +91 -0
- package/plugins/pmcp/mod/sessions/types.ts +162 -0
- package/plugins/pmcp/mod/snapshot.ts +75 -0
- package/plugins/pmcp/mod/spinner.tsx +30 -0
- package/plugins/pmcp/mod/state.ts +28 -0
- package/plugins/pmcp/plugin.json +2 -2
- package/plugins/pmcp/skills/agent-assets-migrate/SKILL.md +96 -0
- package/plugins/pmcp/skills/headless-agents-ci-scaffold/SKILL.md +101 -0
- package/plugins/pmcp/skills/marketplace-plugin-scaffold/SKILL.md +87 -0
- package/plugins/pmcp/skills/package-skill-catalog/SKILL.md +51 -15
- package/plugins/pmcp/skills/pmcp-browser/SKILL.md +27 -0
- package/plugins/pmcp/skills/pmcp-desktop/SKILL.md +25 -0
- package/plugins/pmcp/skills/pmcp-project-init/SKILL.md +153 -0
- package/plugins/pmcp/skills/pmcp-sessions-and-git/SKILL.md +96 -0
- package/plugins/pmcp/skills/skill-package-scaffold/SKILL.md +89 -0
- package/schema/catalog-v1.json +187 -0
- package/schema/library.json +196 -0
- package/schema/marketplace-manifest.json +144 -0
- package/schema/plugin-manifest.json +59 -0
- package/schema/skill-frontmatter.json +170 -0
- package/schema/skill-metadata-core.json +131 -0
- package/skills/agent-assets-migrate/SKILL.md +96 -0
- package/skills/headless-agents-ci-scaffold/SKILL.md +101 -0
- package/skills/marketplace-plugin-scaffold/SKILL.md +87 -0
- package/skills/package-skill-catalog/SKILL.md +51 -15
- package/skills/pmcp-browser/SKILL.md +27 -0
- package/skills/pmcp-desktop/SKILL.md +25 -0
- package/skills/pmcp-project-init/SKILL.md +153 -0
- package/skills/pmcp-sessions-and-git/SKILL.md +96 -0
- package/skills/skill-package-scaffold/SKILL.md +89 -0
- package/dist/config-BkSpjUG6.d.ts +0 -50
- package/dist/embed-DRROSD3F.d.ts +0 -53
- package/dist/hook-spec-CSJJySsH.d.ts +0 -11
- package/dist/server-VWSY3Shw.d.ts +0 -543
- package/dist/tui-worker.js +0 -6549
- package/docs/manual-library-skills.md +0 -74
- /package/dist/{tui-worker.d.ts → hook.d.ts} +0 -0
|
@@ -0,0 +1,170 @@
|
|
|
1
|
+
{
|
|
2
|
+
"$schema": "https://json-schema.org/draft/2020-12/schema",
|
|
3
|
+
"type": "object",
|
|
4
|
+
"properties": {
|
|
5
|
+
"name": {
|
|
6
|
+
"type": "string",
|
|
7
|
+
"minLength": 1
|
|
8
|
+
},
|
|
9
|
+
"description": {
|
|
10
|
+
"type": "string",
|
|
11
|
+
"minLength": 1
|
|
12
|
+
},
|
|
13
|
+
"license": {
|
|
14
|
+
"type": "string"
|
|
15
|
+
},
|
|
16
|
+
"compatibility": {
|
|
17
|
+
"type": "string"
|
|
18
|
+
},
|
|
19
|
+
"allowed-tools": {
|
|
20
|
+
"anyOf": [
|
|
21
|
+
{
|
|
22
|
+
"type": "string"
|
|
23
|
+
},
|
|
24
|
+
{
|
|
25
|
+
"type": "array",
|
|
26
|
+
"items": {
|
|
27
|
+
"type": "string"
|
|
28
|
+
}
|
|
29
|
+
}
|
|
30
|
+
]
|
|
31
|
+
},
|
|
32
|
+
"metadata": {
|
|
33
|
+
"type": "object",
|
|
34
|
+
"properties": {
|
|
35
|
+
"version": {
|
|
36
|
+
"type": "string",
|
|
37
|
+
"pattern": "^(0|[1-9][0-9]*)\\.(0|[1-9][0-9]*)\\.(0|[1-9][0-9]*)$"
|
|
38
|
+
},
|
|
39
|
+
"keywords": {
|
|
40
|
+
"type": "array",
|
|
41
|
+
"items": {
|
|
42
|
+
"type": "string"
|
|
43
|
+
}
|
|
44
|
+
},
|
|
45
|
+
"locales": {
|
|
46
|
+
"type": "array",
|
|
47
|
+
"items": {
|
|
48
|
+
"type": "string",
|
|
49
|
+
"pattern": "^[a-z]{2}$"
|
|
50
|
+
}
|
|
51
|
+
},
|
|
52
|
+
"level": {
|
|
53
|
+
"type": "string",
|
|
54
|
+
"enum": [
|
|
55
|
+
"L1",
|
|
56
|
+
"L2",
|
|
57
|
+
"L3",
|
|
58
|
+
"L4",
|
|
59
|
+
"L5"
|
|
60
|
+
]
|
|
61
|
+
},
|
|
62
|
+
"domain": {
|
|
63
|
+
"type": "string",
|
|
64
|
+
"pattern": "^[a-z0-9]+(-[a-z0-9]+)*$"
|
|
65
|
+
},
|
|
66
|
+
"install": {
|
|
67
|
+
"type": "string",
|
|
68
|
+
"enum": [
|
|
69
|
+
"default",
|
|
70
|
+
"optional",
|
|
71
|
+
"catalog-only"
|
|
72
|
+
]
|
|
73
|
+
},
|
|
74
|
+
"requires": {
|
|
75
|
+
"type": "object",
|
|
76
|
+
"properties": {
|
|
77
|
+
"mcp": {
|
|
78
|
+
"type": "array",
|
|
79
|
+
"items": {
|
|
80
|
+
"type": "string"
|
|
81
|
+
}
|
|
82
|
+
},
|
|
83
|
+
"bin": {
|
|
84
|
+
"type": "array",
|
|
85
|
+
"items": {
|
|
86
|
+
"type": "string"
|
|
87
|
+
}
|
|
88
|
+
},
|
|
89
|
+
"env": {
|
|
90
|
+
"type": "array",
|
|
91
|
+
"items": {
|
|
92
|
+
"type": "string"
|
|
93
|
+
}
|
|
94
|
+
},
|
|
95
|
+
"gpu-gb": {
|
|
96
|
+
"type": "string"
|
|
97
|
+
},
|
|
98
|
+
"capabilities": {
|
|
99
|
+
"type": "array",
|
|
100
|
+
"items": {
|
|
101
|
+
"type": "string"
|
|
102
|
+
}
|
|
103
|
+
}
|
|
104
|
+
},
|
|
105
|
+
"additionalProperties": {}
|
|
106
|
+
},
|
|
107
|
+
"provides": {
|
|
108
|
+
"type": "array",
|
|
109
|
+
"items": {
|
|
110
|
+
"type": "string"
|
|
111
|
+
}
|
|
112
|
+
},
|
|
113
|
+
"approval": {
|
|
114
|
+
"type": "string",
|
|
115
|
+
"enum": [
|
|
116
|
+
"none",
|
|
117
|
+
"scripts",
|
|
118
|
+
"hooks"
|
|
119
|
+
]
|
|
120
|
+
},
|
|
121
|
+
"output-license": {
|
|
122
|
+
"type": "string"
|
|
123
|
+
},
|
|
124
|
+
"pair": {
|
|
125
|
+
"type": "array",
|
|
126
|
+
"items": {
|
|
127
|
+
"type": "string"
|
|
128
|
+
}
|
|
129
|
+
},
|
|
130
|
+
"verified-runtimes": {
|
|
131
|
+
"type": "array",
|
|
132
|
+
"items": {
|
|
133
|
+
"type": "string",
|
|
134
|
+
"enum": [
|
|
135
|
+
"claude-code",
|
|
136
|
+
"codex-cli",
|
|
137
|
+
"gemini-cli",
|
|
138
|
+
"grok-cli",
|
|
139
|
+
"antigravity"
|
|
140
|
+
]
|
|
141
|
+
},
|
|
142
|
+
"description": "Generated from recorded runtime evaluations; do not author by hand.",
|
|
143
|
+
"readOnly": true,
|
|
144
|
+
"uniqueItems": true
|
|
145
|
+
},
|
|
146
|
+
"tier": {
|
|
147
|
+
"type": "string",
|
|
148
|
+
"enum": [
|
|
149
|
+
"open",
|
|
150
|
+
"free",
|
|
151
|
+
"paid",
|
|
152
|
+
"internal"
|
|
153
|
+
],
|
|
154
|
+
"deprecated": true,
|
|
155
|
+
"description": "Inherited from marketplace metadata.tier; repeated skill tiers warn."
|
|
156
|
+
}
|
|
157
|
+
},
|
|
158
|
+
"additionalProperties": {},
|
|
159
|
+
"title": "Skill metadata",
|
|
160
|
+
"description": "The metadata map of a SKILL.md frontmatter: catalog fields pmcp reads (level, domain, install, keywords and the rest)."
|
|
161
|
+
}
|
|
162
|
+
},
|
|
163
|
+
"required": [
|
|
164
|
+
"name",
|
|
165
|
+
"description"
|
|
166
|
+
],
|
|
167
|
+
"additionalProperties": {},
|
|
168
|
+
"title": "SKILL.md frontmatter",
|
|
169
|
+
"description": "The Agent Skills frontmatter pmcp validate checks: name, description and the optional fields."
|
|
170
|
+
}
|
|
@@ -0,0 +1,131 @@
|
|
|
1
|
+
{
|
|
2
|
+
"$schema": "https://json-schema.org/draft/2020-12/schema",
|
|
3
|
+
"type": "object",
|
|
4
|
+
"properties": {
|
|
5
|
+
"version": {
|
|
6
|
+
"type": "string",
|
|
7
|
+
"pattern": "^(0|[1-9][0-9]*)\\.(0|[1-9][0-9]*)\\.(0|[1-9][0-9]*)$"
|
|
8
|
+
},
|
|
9
|
+
"keywords": {
|
|
10
|
+
"type": "array",
|
|
11
|
+
"items": {
|
|
12
|
+
"type": "string"
|
|
13
|
+
}
|
|
14
|
+
},
|
|
15
|
+
"locales": {
|
|
16
|
+
"type": "array",
|
|
17
|
+
"items": {
|
|
18
|
+
"type": "string",
|
|
19
|
+
"pattern": "^[a-z]{2}$"
|
|
20
|
+
}
|
|
21
|
+
},
|
|
22
|
+
"level": {
|
|
23
|
+
"type": "string",
|
|
24
|
+
"enum": [
|
|
25
|
+
"L1",
|
|
26
|
+
"L2",
|
|
27
|
+
"L3",
|
|
28
|
+
"L4",
|
|
29
|
+
"L5"
|
|
30
|
+
]
|
|
31
|
+
},
|
|
32
|
+
"domain": {
|
|
33
|
+
"type": "string",
|
|
34
|
+
"pattern": "^[a-z0-9]+(-[a-z0-9]+)*$"
|
|
35
|
+
},
|
|
36
|
+
"install": {
|
|
37
|
+
"type": "string",
|
|
38
|
+
"enum": [
|
|
39
|
+
"default",
|
|
40
|
+
"optional",
|
|
41
|
+
"catalog-only"
|
|
42
|
+
]
|
|
43
|
+
},
|
|
44
|
+
"requires": {
|
|
45
|
+
"type": "object",
|
|
46
|
+
"properties": {
|
|
47
|
+
"mcp": {
|
|
48
|
+
"type": "array",
|
|
49
|
+
"items": {
|
|
50
|
+
"type": "string"
|
|
51
|
+
}
|
|
52
|
+
},
|
|
53
|
+
"bin": {
|
|
54
|
+
"type": "array",
|
|
55
|
+
"items": {
|
|
56
|
+
"type": "string"
|
|
57
|
+
}
|
|
58
|
+
},
|
|
59
|
+
"env": {
|
|
60
|
+
"type": "array",
|
|
61
|
+
"items": {
|
|
62
|
+
"type": "string"
|
|
63
|
+
}
|
|
64
|
+
},
|
|
65
|
+
"gpu-gb": {
|
|
66
|
+
"type": "string"
|
|
67
|
+
},
|
|
68
|
+
"capabilities": {
|
|
69
|
+
"type": "array",
|
|
70
|
+
"items": {
|
|
71
|
+
"type": "string"
|
|
72
|
+
}
|
|
73
|
+
}
|
|
74
|
+
},
|
|
75
|
+
"additionalProperties": {}
|
|
76
|
+
},
|
|
77
|
+
"provides": {
|
|
78
|
+
"type": "array",
|
|
79
|
+
"items": {
|
|
80
|
+
"type": "string"
|
|
81
|
+
}
|
|
82
|
+
},
|
|
83
|
+
"approval": {
|
|
84
|
+
"type": "string",
|
|
85
|
+
"enum": [
|
|
86
|
+
"none",
|
|
87
|
+
"scripts",
|
|
88
|
+
"hooks"
|
|
89
|
+
]
|
|
90
|
+
},
|
|
91
|
+
"output-license": {
|
|
92
|
+
"type": "string"
|
|
93
|
+
},
|
|
94
|
+
"pair": {
|
|
95
|
+
"type": "array",
|
|
96
|
+
"items": {
|
|
97
|
+
"type": "string"
|
|
98
|
+
}
|
|
99
|
+
},
|
|
100
|
+
"verified-runtimes": {
|
|
101
|
+
"type": "array",
|
|
102
|
+
"items": {
|
|
103
|
+
"type": "string",
|
|
104
|
+
"enum": [
|
|
105
|
+
"claude-code",
|
|
106
|
+
"codex-cli",
|
|
107
|
+
"gemini-cli",
|
|
108
|
+
"grok-cli",
|
|
109
|
+
"antigravity"
|
|
110
|
+
]
|
|
111
|
+
},
|
|
112
|
+
"description": "Generated from recorded runtime evaluations; do not author by hand.",
|
|
113
|
+
"readOnly": true,
|
|
114
|
+
"uniqueItems": true
|
|
115
|
+
},
|
|
116
|
+
"tier": {
|
|
117
|
+
"type": "string",
|
|
118
|
+
"enum": [
|
|
119
|
+
"open",
|
|
120
|
+
"free",
|
|
121
|
+
"paid",
|
|
122
|
+
"internal"
|
|
123
|
+
],
|
|
124
|
+
"deprecated": true,
|
|
125
|
+
"description": "Inherited from marketplace metadata.tier; repeated skill tiers warn."
|
|
126
|
+
}
|
|
127
|
+
},
|
|
128
|
+
"additionalProperties": {},
|
|
129
|
+
"title": "Skill metadata",
|
|
130
|
+
"description": "The metadata map of a SKILL.md frontmatter: catalog fields pmcp reads (level, domain, install, keywords and the rest)."
|
|
131
|
+
}
|
|
@@ -0,0 +1,96 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: agent-assets-migrate
|
|
3
|
+
description: Move a repository's scattered agent files - CLAUDE.md, .cursorrules, .windsurfrules, copilot-instructions.md, .claude/skills, .claude/agents, .claude/commands, .gemini/agents and a root .agent/ folder - into one AGENTS.md, .agents/ and pmcp.toml without losing a line, keeping historical citations as they are, and finishing with a clean pmcp project --check. Use when consolidating agent instructions from several tools into one source, when adopting pmcp in a repository that already has agent files, or when agent files have drifted apart. Not for a new empty repository or for trimming an oversized AGENTS.md.
|
|
4
|
+
metadata:
|
|
5
|
+
tier: open
|
|
6
|
+
level: L3
|
|
7
|
+
domain: agent-workflow
|
|
8
|
+
install: optional
|
|
9
|
+
keywords: "migrate agent files, AGENTS.md, .agents, pmcp, CLAUDE.md, cursorrules, consolidate rules, subagents"
|
|
10
|
+
requires-bin: "pmcp"
|
|
11
|
+
---
|
|
12
|
+
|
|
13
|
+
# Migrating agent assets into AGENTS.md, .agents/ and pmcp.toml
|
|
14
|
+
|
|
15
|
+
The risk is not the move; it is silent loss. Two files that look alike usually differ by a
|
|
16
|
+
few rules, and a field one tool needed vanishes when an agent file is copied. Inventory
|
|
17
|
+
first, move verbatim, prove nothing was dropped, then let `pmcp project` regenerate the
|
|
18
|
+
tool files.
|
|
19
|
+
|
|
20
|
+
## 1. Inventory
|
|
21
|
+
|
|
22
|
+
List every source with its bytes and line count, and note which are links:
|
|
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` |
|
|
32
|
+
|
|
33
|
+
pmcp has no Copilot or Cursor target. Keep those filenames as links to `AGENTS.md` so they
|
|
34
|
+
cannot drift.
|
|
35
|
+
|
|
36
|
+
## 2. Merge instruction files without loss
|
|
37
|
+
|
|
38
|
+
Diff each instruction file against the others line by line. Keep the union; where two say
|
|
39
|
+
different things, settle it from the code or ask, and record the decision. Do not summarise
|
|
40
|
+
during the move. Then replace each old file with a link (`ln -s AGENTS.md CLAUDE.md`).
|
|
41
|
+
Use file-to-file links only: a directory symlink at the repository root, such as `.agents`
|
|
42
|
+
pointing at `.agent`, is rejected by the Codex sandbox.
|
|
43
|
+
|
|
44
|
+
## 3. Split agent fields
|
|
45
|
+
|
|
46
|
+
A subagent's `agent.md` keeps only `name`, `description` and the body. Everything else is
|
|
47
|
+
tool-specific and becomes a `pmcp.toml` table:
|
|
48
|
+
|
|
49
|
+
```toml
|
|
50
|
+
[agents.reviewer.claude]
|
|
51
|
+
tools = "Read, Grep, Glob"
|
|
52
|
+
model = "sonnet"
|
|
53
|
+
effort = "high"
|
|
54
|
+
```
|
|
55
|
+
|
|
56
|
+
Why: Antigravity silently drops an agent whose `tools` field lists another tool's tool
|
|
57
|
+
names. What survives projection: Claude keeps `name`, `description`, `tools`, `model`,
|
|
58
|
+
`effort`; Gemini keeps `name` and `description`; Codex gets those two plus the body. A
|
|
59
|
+
Gemini-only field has nowhere to go; list it in the report as dropped.
|
|
60
|
+
|
|
61
|
+
## 4. Keep history as it was
|
|
62
|
+
|
|
63
|
+
Change live references to the new paths: scripts, configs, current docs, other skills.
|
|
64
|
+
Leave decision records, dated plans, changelogs and evidence notes citing the old paths
|
|
65
|
+
untouched; they record what was true then. Count both groups and report them.
|
|
66
|
+
|
|
67
|
+
## 5. Remove the old copies, then project
|
|
68
|
+
|
|
69
|
+
`pmcp project` refuses to overwrite a file it did not write (exit 1, naming the file), so
|
|
70
|
+
delete the hand-written `.claude/agents/<n>.md`, `.claude/skills/<n>` and old MCP blocks
|
|
71
|
+
after their content is in the sources. Then:
|
|
72
|
+
|
|
73
|
+
```sh
|
|
74
|
+
pmcp project
|
|
75
|
+
pmcp project --check # must exit 0
|
|
76
|
+
```
|
|
77
|
+
|
|
78
|
+
`--check` exits 2 and names each problem: `drift` (an output differs from its source),
|
|
79
|
+
`stale` (the lock lists an output no source produces), `undeclared` (a file left in
|
|
80
|
+
`.claude/skills`, `.claude/agents`, `.claude/commands`, `.gemini/agents`, `.codex/agents`,
|
|
81
|
+
`.grok/skills` or `.claude/rules/pmcp` that nothing generates, often a copy you forgot to
|
|
82
|
+
delete), and `dead glob` (a rule glob matching no tracked file).
|
|
83
|
+
|
|
84
|
+
Codex in `workspace-write` cannot edit `.agents/` unless it is listed in
|
|
85
|
+
`sandbox_workspace_write.writable_roots`; a patch touching it is refused whole.
|
|
86
|
+
|
|
87
|
+
## 6. Prove nothing was lost
|
|
88
|
+
|
|
89
|
+
For each old file, check that every non-blank line now exists in a source (same text, or
|
|
90
|
+
a recorded decision). Count skills, agents, commands and MCP servers before and after; the
|
|
91
|
+
counts must match, with commands now counted as user-invoked skills.
|
|
92
|
+
|
|
93
|
+
## Report
|
|
94
|
+
|
|
95
|
+
The inventory table, conflicts and how each was settled, fields dropped, live and historical
|
|
96
|
+
citation counts, the before and after asset counts, and the `pmcp project --check` output.
|
|
@@ -0,0 +1,101 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: headless-agents-ci-scaffold
|
|
3
|
+
description: Write a CI job that runs Claude Code, Gemini CLI, Codex, Grok Build and Antigravity headless against a project MCP server, giving each the permission setting it actually honours, asserting on the tool call rather than the exit code, and gating with pmcp project --check and pmcp doctor. Use when adding agent CLIs to CI, when a headless agent run skips an MCP tool call, or when a permission flag seems to do nothing. Not for interactive sessions or for writing the MCP server itself.
|
|
4
|
+
metadata:
|
|
5
|
+
tier: open
|
|
6
|
+
level: L3
|
|
7
|
+
domain: agent-workflow
|
|
8
|
+
install: optional
|
|
9
|
+
keywords: "headless agent, CI, allowedTools, permission flags, MCP permissions, Codex sandbox, Grok, Antigravity, pmcp doctor"
|
|
10
|
+
requires-bin: "pmcp"
|
|
11
|
+
verified-runtimes: "claude-code"
|
|
12
|
+
---
|
|
13
|
+
|
|
14
|
+
# Headless agent CLIs in CI
|
|
15
|
+
|
|
16
|
+
Every agent CLI blocks an MCP tool call it was not told to allow, and each spells the
|
|
17
|
+
allowance differently. Several fail quietly: the model announces the call and the run ends
|
|
18
|
+
with exit 0. So a CI job needs the right setting per tool and an assertion that the call
|
|
19
|
+
happened.
|
|
20
|
+
|
|
21
|
+
The settings below were last measured with one headless MCP call per tool (Claude Code
|
|
22
|
+
2.1.289, Gemini CLI 0.38.2, Codex 0.131.0, Grok Build 1.0.46, Antigravity 1.2.16); OpenCode,
|
|
23
|
+
also a pmcp target, was not measured, so check its own permission settings before relying on
|
|
24
|
+
a headless run. Re-check after an upgrade; these flags move.
|
|
25
|
+
|
|
26
|
+
## Permission per tool
|
|
27
|
+
|
|
28
|
+
`<server>` is the MCP alias (the `[mcp.<alias>]` name), `<tool>` the tool name.
|
|
29
|
+
|
|
30
|
+
| Tool | Command | What lets the call through |
|
|
31
|
+
| ----------- | ---------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
32
|
+
| Claude Code | `claude -p "<prompt>" --permission-mode default --allowedTools mcp__<server>__<tool>` | the `--allowedTools` rule; without it the call is blocked under `default` |
|
|
33
|
+
| Gemini CLI | `gemini -p "<prompt>" --allowed-mcp-server-names <server> --allowed-tools mcp_<server>_<tool>` | one `--allowed-tools` flag per tool (a bare tool name does not match; the array form swallowed the prompt); the folder must be trusted; the flag is deprecated in favour of the Policy Engine |
|
|
34
|
+
| Codex | `codex exec "<prompt>"` | nothing; `exec` allowed the call without a flag |
|
|
35
|
+
| Grok Build | `grok -p "<prompt>" --permission-mode default --allow <server>__<tool>` | `--allow <server>__<tool>`; the Claude-style `mcp__<server>__<tool>` matches nothing |
|
|
36
|
+
| Antigravity | `agy -p "<prompt>"` | a `permissions.allow` entry `mcp(<server>/<tool>)` in `~/.gemini/antigravity-cli/settings.json`; `mcp(<server>)` alone does not match, and an unlisted tool is auto-denied |
|
|
37
|
+
|
|
38
|
+
### Grok precedence traps
|
|
39
|
+
|
|
40
|
+
- Grok reads Claude Code's `~/.claude/settings.json`. A `defaultMode: auto` there approves
|
|
41
|
+
MCP calls over Grok's own `--permission-mode default` and `--disallowed-tools`. Run Grok on
|
|
42
|
+
a runner whose home has no such setting.
|
|
43
|
+
- `--permission-mode default` on the command line beats a config `permission_mode =
|
|
44
|
+
"always-approve"`, but `--disallowed-tools` does not. Do not rely on a deny rule to keep a
|
|
45
|
+
tool from running; pin the mode by flag and allow only what the job needs.
|
|
46
|
+
- A blocked call in `-p` is silent: no error line, exit 0.
|
|
47
|
+
|
|
48
|
+
### Codex sandbox
|
|
49
|
+
|
|
50
|
+
Under `--sandbox workspace-write`, `.agents/` is protected like `.git`: a patch touching it
|
|
51
|
+
is refused whole, including its other files. If the job edits `.agents/`, list it under
|
|
52
|
+
`[sandbox_workspace_write] writable_roots` in `.codex/config.toml`, or per run:
|
|
53
|
+
|
|
54
|
+
```sh
|
|
55
|
+
codex exec -s workspace-write \
|
|
56
|
+
-c 'sandbox_workspace_write.writable_roots=["<absolute repo path>/.agents"]' "<prompt>"
|
|
57
|
+
```
|
|
58
|
+
|
|
59
|
+
## Trust on the runner
|
|
60
|
+
|
|
61
|
+
Codex, Gemini and Grok skip project assets (skills, MCP servers, agents) in an untrusted
|
|
62
|
+
folder, without an error. On a fresh runner, record the checkout as trusted for each tool
|
|
63
|
+
before the run (Codex: `[projects."<absolute path>"] trust_level = "trusted"` in
|
|
64
|
+
`~/.codex/config.toml`; Gemini: `~/.gemini/trustedFolders.json`; Grok:
|
|
65
|
+
`~/.grok/trusted_folders.toml`; Antigravity: `trustedWorkspaces` in its settings file).
|
|
66
|
+
|
|
67
|
+
## Assert the call, not the exit code
|
|
68
|
+
|
|
69
|
+
Exit 0 proves nothing here. Either put a logging proxy in front of the MCP server and
|
|
70
|
+
assert it logged a `tools/call` for the tool, or have the prompt return a value only the
|
|
71
|
+
tool can supply and grep for it.
|
|
72
|
+
|
|
73
|
+
## Projection gate
|
|
74
|
+
|
|
75
|
+
```sh
|
|
76
|
+
pmcp project --check # exit 2: generated files drifted, went stale or are undeclared
|
|
77
|
+
pmcp doctor # exit 1 on any failed check
|
|
78
|
+
```
|
|
79
|
+
|
|
80
|
+
`pmcp doctor` skips a CLI that is not installed, except the Codex trust check, which reads
|
|
81
|
+
`~/.codex/config.toml` whenever `codex` is in `[targets]`. On a runner without Codex, either
|
|
82
|
+
write the trust entry or pass `--tool` for the tools present (`pmcp doctor --tool claude
|
|
83
|
+
--tool gemini`).
|
|
84
|
+
|
|
85
|
+
## Job skeleton
|
|
86
|
+
|
|
87
|
+
```sh
|
|
88
|
+
set -eu
|
|
89
|
+
pmcp project --check
|
|
90
|
+
pmcp doctor --tool claude --tool gemini --tool grok
|
|
91
|
+
out=$(claude -p "Call <tool> on <server> and print the first result name." \
|
|
92
|
+
--permission-mode default --allowedTools mcp__<server>__<tool>)
|
|
93
|
+
printf '%s\n' "$out" | grep -q '<expected value>'
|
|
94
|
+
```
|
|
95
|
+
|
|
96
|
+
Repeat the last two lines per tool with its own setting from the table.
|
|
97
|
+
|
|
98
|
+
## Report
|
|
99
|
+
|
|
100
|
+
The job file, the per-tool settings used with the version each was checked on, how each run
|
|
101
|
+
asserts the call, and any tool left out and why.
|
|
@@ -0,0 +1,87 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: marketplace-plugin-scaffold
|
|
3
|
+
description: Package skills, commands, subagents, hooks and MCP servers as a plugin in a plugin marketplace laid out the way pmcp's catalog reads it - marketplace.json with a tier, plugin.json, skills/, commands/, agents/, hooks/hooks.json and .mcp.json - and confirm every asset is listed with pmcp list and pmcp validate. Use when turning a folder of skills into a marketplace plugin, when a plugin's assets do not show up in a skill catalog, or when setting the tier of a marketplace. Not for writing a single skill's content or for hosting the catalog over HTTP.
|
|
4
|
+
metadata:
|
|
5
|
+
tier: open
|
|
6
|
+
level: L2
|
|
7
|
+
domain: agent-workflow
|
|
8
|
+
install: optional
|
|
9
|
+
keywords: "plugin marketplace, marketplace.json, plugin.json, skill plugin, pmcp catalog, tier, commands, hooks, mcp.json"
|
|
10
|
+
requires-bin: "pmcp"
|
|
11
|
+
verified-runtimes: "claude-code"
|
|
12
|
+
---
|
|
13
|
+
|
|
14
|
+
# Scaffolding a marketplace plugin pmcp can read
|
|
15
|
+
|
|
16
|
+
pmcp reads a marketplace by its files, with no package.json involved. Anything outside the
|
|
17
|
+
places below is invisible to it, and an asset without a description is dropped with a
|
|
18
|
+
reason, not served.
|
|
19
|
+
|
|
20
|
+
## Layout
|
|
21
|
+
|
|
22
|
+
```
|
|
23
|
+
<marketplace>/
|
|
24
|
+
.claude-plugin/marketplace.json
|
|
25
|
+
plugins/<plugin>/
|
|
26
|
+
.claude-plugin/plugin.json
|
|
27
|
+
skills/<name>/SKILL.md
|
|
28
|
+
commands/<name>.md
|
|
29
|
+
agents/<name>.md or agents/<name>/agent.md
|
|
30
|
+
hooks/hooks.json
|
|
31
|
+
.mcp.json
|
|
32
|
+
```
|
|
33
|
+
|
|
34
|
+
## marketplace.json
|
|
35
|
+
|
|
36
|
+
```json
|
|
37
|
+
{
|
|
38
|
+
"name": "acme",
|
|
39
|
+
"metadata": { "tier": "open" },
|
|
40
|
+
"plugins": [{ "name": "billing-skills", "source": "./plugins/billing-skills" }]
|
|
41
|
+
}
|
|
42
|
+
```
|
|
43
|
+
|
|
44
|
+
- A plugin entry without `name` or `source`, or whose `source` directory does not exist, is
|
|
45
|
+
skipped without a message. Check the count in `pmcp list`.
|
|
46
|
+
- The tier lives here, for the whole marketplace. There is no plugin-level tier.
|
|
47
|
+
- A skill, command or agent may repeat it as `metadata.tier` in its frontmatter. If that
|
|
48
|
+
disagrees with the marketplace tier the asset is rejected, because a mislabelled tier is
|
|
49
|
+
how a private asset leaks. Keep one tier per marketplace and split marketplaces by tier.
|
|
50
|
+
|
|
51
|
+
## plugin.json
|
|
52
|
+
|
|
53
|
+
`description` is what a hook entry and each MCP server entry are described with. `hooks` may
|
|
54
|
+
name a different hooks file (a string path); otherwise `hooks/hooks.json` is read.
|
|
55
|
+
|
|
56
|
+
## What each place becomes
|
|
57
|
+
|
|
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>` |
|
|
65
|
+
|
|
66
|
+
Skills and commands appear in `skill_catalog` and `skill_find`. Agents, hooks and MCP
|
|
67
|
+
servers are left out unless the caller asks for that `kind` (`agent`, `hook`, `mcp` or
|
|
68
|
+
`any`). A command is listed like any skill; nothing marks it as started by the user only.
|
|
69
|
+
The frontmatter `name` sets the slug; without one the file or folder name is used. Keep
|
|
70
|
+
them equal: the Agent Skills specification requires a skill's name to match its directory.
|
|
71
|
+
|
|
72
|
+
## Check
|
|
73
|
+
|
|
74
|
+
```sh
|
|
75
|
+
pmcp list --marketplace <marketplace> --no-config # every entry, with its tier
|
|
76
|
+
pmcp validate --marketplace <marketplace> --no-config # rejections and specification errors
|
|
77
|
+
```
|
|
78
|
+
|
|
79
|
+
`validate` prints why each asset was left out (`no description`, `metadata.tier ... in a
|
|
80
|
+
... marketplace`, `.mcp.json has no mcpServers object`, `hooks.json is not a JSON object`).
|
|
81
|
+
Compare the `list` count with the files you created; a missing plugin is usually a wrong
|
|
82
|
+
`source`.
|
|
83
|
+
|
|
84
|
+
## Report
|
|
85
|
+
|
|
86
|
+
The tree, marketplace.json and plugin.json, the `pmcp list` count per kind against the files
|
|
87
|
+
created, and the `pmcp validate` output.
|
|
@@ -1,20 +1,42 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: package-skill-catalog
|
|
3
|
-
description: Find
|
|
3
|
+
description: Find, check and load the right skill from a PMCP skill catalog instead of guessing, including version-appropriate instructions for installed public libraries, and install selected PMCP marketplace skills through a native runtime. Use when a task might have a dedicated skill, when the PMCP tools (skill_find, skill_catalog, skill_describe, skill_call, skill_read, skill_bundle) are available, or when a search for a skill came back empty.
|
|
4
|
+
metadata:
|
|
5
|
+
tier: open
|
|
6
|
+
level: L1
|
|
7
|
+
domain: agent-workflow
|
|
8
|
+
install: default
|
|
9
|
+
keywords: skill search, skill catalog, skill router, library instructions
|
|
10
|
+
verified-runtimes: claude-code
|
|
4
11
|
---
|
|
5
12
|
|
|
6
13
|
# Package skill catalog
|
|
7
14
|
|
|
8
|
-
|
|
9
|
-
|
|
10
|
-
|
|
15
|
+
A catalog server keeps hundreds of skills out of the session until one is
|
|
16
|
+
needed. Its value depends on the order you use it in: search before you read,
|
|
17
|
+
check before you load, and never invent a name. Prefer the project's installed
|
|
18
|
+
library version and preserve its package manager, configuration, build scripts
|
|
19
|
+
and native runtime permissions.
|
|
11
20
|
|
|
12
|
-
##
|
|
21
|
+
## The loop
|
|
13
22
|
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
23
|
+
1. **Search with the problem, not a keyword.** Call skill_find with one full
|
|
24
|
+
English sentence that says what you are trying to do and for whom. Add
|
|
25
|
+
filters only for facts you already know (for example tier or medium).
|
|
26
|
+
2. **On an empty result, look before concluding.** Call skill_catalog (paged)
|
|
27
|
+
and scan the group names. An empty search means the wording missed, not that
|
|
28
|
+
no skill exists. Rephrase once with the vocabulary you saw there.
|
|
29
|
+
3. **Check the top one to three candidates.** Call skill_describe for each and
|
|
30
|
+
compare metadata.level, the requirements, compatibility, the output licence
|
|
31
|
+
and whether approval is needed. Prefer the narrowest skill that covers the task.
|
|
32
|
+
4. **Load one.** Call skill_call with the exact name the server returned. The
|
|
33
|
+
body is the instruction; follow it on your own host.
|
|
34
|
+
5. **Read extra files only when the body points at them.** Use skill_read with
|
|
35
|
+
the path the body names, or skill_bundle when the complete selected skill is
|
|
36
|
+
needed. Treat scripts as text to review, not to run, unless the body asks and
|
|
37
|
+
the user agreed.
|
|
38
|
+
|
|
39
|
+
## Library instructions
|
|
18
40
|
|
|
19
41
|
Check the target major and verified version before following version-sensitive
|
|
20
42
|
API examples. Catalog availability is not proof that a particular version was
|
|
@@ -24,11 +46,22 @@ Without MCP, use pmcp list to inspect local catalogs and pmcp available to match
|
|
|
24
46
|
the public catalog against installed npm dependencies. Public library instructions
|
|
25
47
|
remain free and do not require a PMCP account.
|
|
26
48
|
|
|
27
|
-
##
|
|
49
|
+
## Rules
|
|
50
|
+
|
|
51
|
+
- Use only names a tool returned. A guessed name wastes a call and can load the
|
|
52
|
+
wrong skill.
|
|
53
|
+
- Load at most two skills for one task. If neither fits, say so and work
|
|
54
|
+
without one rather than stacking partial matches.
|
|
55
|
+
- Say which skill you used and why, in one line, so the user can check the
|
|
56
|
+
choice.
|
|
57
|
+
- A skill tagged paid runs on a remote service and may cost the user. Show the
|
|
58
|
+
estimate it asks for and wait for confirmation before submitting work.
|
|
59
|
+
- Never paste secrets into a skill's inputs. Skills name the environment
|
|
60
|
+
variables they need; the values stay in the user's environment.
|
|
61
|
+
- When native skills and MCP both expose the same instructions, use one source
|
|
62
|
+
for the task rather than loading duplicate bodies.
|
|
28
63
|
|
|
29
|
-
|
|
30
|
-
Older versions retain their previous install behavior; their users can install
|
|
31
|
-
free website archives or native plugins.
|
|
64
|
+
## Install deliberately
|
|
32
65
|
|
|
33
66
|
Choose one library major with the native plugin manager, or use pmcp marketplace
|
|
34
67
|
export to create a runtime-specific plugin directory. Installing a skill does not
|
|
@@ -39,8 +72,11 @@ Use pmcp install --dry-run before applying public npm skill installation with
|
|
|
39
72
|
provider OAuth credentials into plugin manifests or PMCP configuration.
|
|
40
73
|
|
|
41
74
|
Avoid activating competing major versions under the same unnamespaced skill name.
|
|
42
|
-
|
|
43
|
-
|
|
75
|
+
|
|
76
|
+
## When to stop using the catalog
|
|
77
|
+
|
|
78
|
+
If the task is a one-line answer, or the user named the exact procedure, skip
|
|
79
|
+
the search. The catalog is for tasks where a tested procedure beats improvising.
|
|
44
80
|
|
|
45
81
|
## Boundaries and sources
|
|
46
82
|
|