@modootoday/pmcp 0.18.0 → 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 +112 -20
- package/CONTRIBUTING.md +71 -0
- package/README.md +98 -206
- package/SECURITY.md +17 -1
- package/dist/{apply-4IGTXOCQ.js → apply-JUTGS5WZ.js} +11 -11
- package/dist/{broadcast-3RY3OZGY.js → broadcast-CBMVOV3G.js} +4 -4
- package/dist/{chunk-SG5TPMKH.js → chunk-26WLNWDG.js} +2 -2
- package/dist/{chunk-ELAGZ635.js → chunk-2FIV63WC.js} +5 -5
- package/dist/{chunk-JUXNIXN4.js → chunk-3FCFAQDG.js} +2 -2
- package/dist/{chunk-EJBZGIDK.js → chunk-3IDXEV5E.js} +3 -3
- package/dist/chunk-65KAQSJP.js +7 -0
- package/dist/{chunk-665TA55Z.js → chunk-7HFIGCSL.js} +2 -2
- package/dist/{chunk-R4L6LJJ2.js → chunk-7UCZAN4J.js} +2 -2
- package/dist/{chunk-J6QLLQVL.js → chunk-A7VF7A35.js} +5 -5
- package/dist/{chunk-NZS5CD72.js → chunk-AJ4VXM2U.js} +20 -4
- package/dist/{chunk-25GHX674.js → chunk-D77IRGHO.js} +6 -6
- package/dist/{chunk-4VCC2NXE.js → chunk-DMZHQZ7P.js} +2 -2
- package/dist/{chunk-Q65R3XKX.js → chunk-EAWPJHJ7.js} +2 -2
- package/dist/{chunk-PLX3BOOS.js → chunk-F5QYZK7E.js} +2 -2
- package/dist/{chunk-YMHUM7AV.js → chunk-F5XMGOOX.js} +7 -1
- package/dist/{chunk-7BLPN3W6.js → chunk-FENOGX3U.js} +2 -2
- package/dist/{chunk-N5AQ3PP7.js → chunk-I2ZP2PSA.js} +5 -5
- package/dist/{chunk-UOCLRM7P.js → chunk-IG33DXLT.js} +16 -16
- package/dist/{chunk-RK4PYD7L.js → chunk-LBXO4VPG.js} +2 -2
- package/dist/{chunk-BVCTKPT3.js → chunk-LMUBBIE2.js} +2 -2
- package/dist/{chunk-Z4HRRXRF.js → chunk-LTZH5E3G.js} +6 -5
- package/dist/{chunk-MWFOUBFC.js → chunk-LW4TG7EL.js} +2 -2
- package/dist/{chunk-LAZQBMAU.js → chunk-NLEXKE7U.js} +3 -3
- package/dist/{chunk-ZH6R642Z.js → chunk-PKODFR5F.js} +2 -2
- package/dist/{chunk-IGYRMM62.js → chunk-QEF7EK3T.js} +2 -2
- package/dist/{chunk-MM2Y43LC.js → chunk-RPQOBHVU.js} +2 -2
- package/dist/{chunk-3NYG4SGU.js → chunk-TXQ7L33K.js} +3 -3
- package/dist/{chunk-PWSJJXLQ.js → chunk-VMHUEOT5.js} +8 -8
- package/dist/{chunk-65ZHM5RH.js → chunk-VRPMYPZU.js} +9 -9
- package/dist/{cli-VYCQJZ5X.js → cli-MI4ZCAZ3.js} +9 -9
- package/dist/{cli-ZTCBSDW4.js → cli-ZN7ZVDEZ.js} +3 -3
- package/dist/cli.js +4 -4
- package/dist/{completion-E7RRG3ZT.js → completion-ILSRB3LW.js} +3 -3
- package/dist/{diagnostics-XXH4FLUG.js → diagnostics-XKXVVQWH.js} +6 -6
- package/dist/{doctor-ZIOESU3N.js → doctor-O2E63YGO.js} +13 -13
- package/dist/{entry-ZNFCTDVE.js → entry-X6CSYQRQ.js} +10 -10
- package/dist/{exec-mcp-X6372BLE.js → exec-mcp-2PMWBPD7.js} +8 -8
- package/dist/{harness-F2XFDYXF.js → harness-L2KSI2ZB.js} +5 -5
- package/dist/harness-launch-gate.js +4 -4
- package/dist/harness-worker.js +6 -6
- package/dist/hook-body.js +7 -6
- package/dist/{hooks-FYE2L5RW.js → hooks-BHTA44X7.js} +3 -3
- package/dist/{host-GRY3VAHH.js → host-UIZAXXQH.js} +7 -7
- package/dist/{host-X6BR6X4O.js → host-UWK754BW.js} +20 -10
- package/dist/{host-run-GCA6H6SR.js → host-run-BI2OTZDZ.js} +5 -5
- package/dist/http.js +1 -1
- package/dist/{import-mcp-2TTBPVLY.js → import-mcp-GPKJI7DI.js} +6 -6
- package/dist/index.d.ts +1 -1
- package/dist/index.js +13 -13
- package/dist/{init-627KFXTG.js → init-3C2Y7BNJ.js} +2 -2
- package/dist/{invoke-LW22Z6ET.js → invoke-44CJRVMK.js} +8 -8
- package/dist/{list-NGMSQ5SH.js → list-WL6L4J5H.js} +8 -8
- package/dist/{logout-6CSHUWWE.js → logout-F5EJ5MOU.js} +7 -7
- package/dist/{logs-SPB6AANY.js → logs-TBUA4UWU.js} +4 -4
- package/dist/{mailbox-7BV54Q4R.js → mailbox-BMTZOSZ7.js} +4 -4
- package/dist/{mainline-JQTTYJMI.js → mainline-KAD2ERLP.js} +2 -2
- package/dist/{mcp-2DKVU3SW.js → mcp-235QZN2A.js} +2 -2
- package/dist/{mcp-V23HC3LB.js → mcp-FJ2UQ4RH.js} +2 -2
- package/dist/{pause-FFAYRBWI.js → pause-7LILUVGL.js} +4 -4
- package/dist/{project-FY62G55N.js → project-5YV5CUEG.js} +4 -4
- package/dist/{resume-UU4HZIUP.js → resume-26VFAAMH.js} +4 -4
- package/dist/{run-OGA3P7FC.js → run-3AXTZSR7.js} +7 -7
- package/dist/{run-HALGEJNJ.js → run-3SOVRQIA.js} +4 -4
- package/dist/{serve-NBKT5BKY.js → serve-DQMKTFIV.js} +3 -3
- package/dist/{start-login-UIQYQBMC.js → start-login-YTZV6KMF.js} +7 -7
- package/dist/{status-NOOHW5WA.js → status-MROQ7WR7.js} +7 -7
- package/dist/{status-VHODZPXB.js → status-RO55QPKV.js} +4 -4
- package/dist/{status-XQANBVXW.js → status-UME2L33L.js} +11 -11
- package/dist/stdio.js +2 -2
- package/dist/{sweep-64JDCGK6.js → sweep-35LGQTTO.js} +4 -4
- package/dist/{test-MKAXFJOL.js → test-AGZOJLRZ.js} +7 -7
- package/dist/{tui-MWKAXE4K.js → tui-G5LLWCSV.js} +5 -5
- package/dist/{unbroadcast-KPUEFLZD.js → unbroadcast-5QNGAJR2.js} +4 -4
- package/dist/{validate-5GZ5YWNA.js → validate-IU52H2IC.js} +2 -2
- package/dist/{worker-RQ575EJL.js → worker-QZ5T6LJD.js} +8 -8
- 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.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 +51 -386
- package/docs/sessions.md +64 -0
- package/docs/skills.md +4 -45
- package/docs/terminal-harness.md +26 -21
- package/docs/terminal-workspace.md +4 -13
- package/gemini-extension.json +2 -2
- package/mcp.json +1 -1
- package/package.json +8 -6
- package/plugin.json +2 -2
- package/plugins/pmcp/.claude-plugin/plugin.json +2 -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/sessions/types.ts +1 -1
- package/plugins/pmcp/plugin.json +2 -2
- package/plugins/pmcp/skills/headless-agents-ci-scaffold/SKILL.md +12 -11
- package/plugins/pmcp/skills/package-skill-catalog/SKILL.md +0 -4
- 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 +19 -11
- package/plugins/pmcp/skills/pmcp-sessions-and-git/SKILL.md +20 -28
- package/plugins/pmcp/skills/skill-package-scaffold/SKILL.md +4 -3
- package/schema/catalog-v1.json +36 -7
- package/schema/library.json +40 -8
- package/schema/marketplace-manifest.json +19 -5
- package/schema/plugin-manifest.json +6 -2
- package/schema/skill-frontmatter.json +33 -7
- package/schema/skill-metadata-core.json +26 -5
- package/skills/headless-agents-ci-scaffold/SKILL.md +12 -11
- package/skills/package-skill-catalog/SKILL.md +0 -4
- package/skills/pmcp-browser/SKILL.md +27 -0
- package/skills/pmcp-desktop/SKILL.md +25 -0
- package/skills/pmcp-project-init/SKILL.md +19 -11
- package/skills/pmcp-sessions-and-git/SKILL.md +20 -28
- package/skills/skill-package-scaffold/SKILL.md +4 -3
- package/dist/chunk-E7OOHLQR.js +0 -7
- package/docs/manual-library-skills.md +0 -74
|
@@ -12,13 +12,15 @@ metadata:
|
|
|
12
12
|
|
|
13
13
|
# Starting a repository the pmcp way
|
|
14
14
|
|
|
15
|
-
pmcp
|
|
16
|
-
|
|
17
|
-
|
|
15
|
+
`pmcp init [--preset solo|multi-session]` writes a starting `pmcp.toml` from what it detects
|
|
16
|
+
in the checkout; it refuses to replace an existing one without `--force`. You edit it and write
|
|
17
|
+
the other sources by hand; `pmcp project` writes every tool's native files from them, and
|
|
18
|
+
`pmcp doctor` asks each installed tool what it loads. Never write the generated files
|
|
19
|
+
yourself: pmcp refuses to overwrite a file it did not write.
|
|
18
20
|
|
|
19
|
-
Install
|
|
20
|
-
|
|
21
|
-
|
|
21
|
+
Install `@modootoday/pmcp` as a dev dependency. Never run the bare unscoped name `pmcp`
|
|
22
|
+
through npx: that name is not the package, and whoever publishes it later would run in your
|
|
23
|
+
repository.
|
|
22
24
|
|
|
23
25
|
## 1. Instructions: one file, two links
|
|
24
26
|
|
|
@@ -46,13 +48,17 @@ an agent whose `tools` names another tool's tools. Those fields go in `pmcp.toml
|
|
|
46
48
|
|
|
47
49
|
## 3. The base pmcp.toml
|
|
48
50
|
|
|
51
|
+
Start with `pmcp init`: it writes `[targets]`, the stage-all and heredoc guards and the git
|
|
52
|
+
settings it detects (`--preset multi-session` adds the session registry, pause and broadcast).
|
|
53
|
+
Then add what it does not invent, such as the MCP servers:
|
|
54
|
+
|
|
49
55
|
```toml
|
|
50
56
|
[targets]
|
|
51
57
|
tools = ["claude", "codex", "gemini", "grok", "antigravity"]
|
|
52
58
|
|
|
53
59
|
[mcp.skills]
|
|
54
60
|
command = "node"
|
|
55
|
-
args = ["${PROJECT_ROOT}/node_modules
|
|
61
|
+
args = ["${PROJECT_ROOT}/node_modules/@modootoday/pmcp/dist/cli.js", "serve"]
|
|
56
62
|
|
|
57
63
|
[skills.release]
|
|
58
64
|
invocation = "user"
|
|
@@ -82,7 +88,7 @@ Every layer is a table; a missing table is off. Look before adding:
|
|
|
82
88
|
|
|
83
89
|
```sh
|
|
84
90
|
git rev-parse --git-common-dir # a git checkout? then the git layer applies
|
|
85
|
-
git worktree list # more than one line:
|
|
91
|
+
git worktree list # more than one line: linked worktrees already exist
|
|
86
92
|
git remote -v # the remote deliveries push to
|
|
87
93
|
```
|
|
88
94
|
|
|
@@ -91,14 +97,16 @@ git remote -v # the remote deliveries push to
|
|
|
91
97
|
| Agents run shell commands (always for Claude or Codex) | `[hooks]` with `targets`, and the `[hooks.guards.shell.*]` and `[hooks.guards.git.*]` you want | Refuses heredocs, in-place `sed -i`, `git add -A`, `push --no-verify`, credential exfiltration. Each declared table is one guard. |
|
|
92
98
|
| A validator script per skill or package | `[hooks.checks.after_edit]` with `validator_glob` and a `command` containing `{validator}` | Reports a failing validator as context right after the edit. |
|
|
93
99
|
| Committed generated files | `[hooks.checks.on_stop]` | Reports projection drift at the end of a turn that edited. |
|
|
94
|
-
| More than one agent at a time | `[sessions.registry]`, `[sessions.pause]`, `[sessions.broadcast]` | The
|
|
100
|
+
| More than one agent at a time | `[sessions.registry]`, `[sessions.pause]`, `[sessions.broadcast]` | The user can see, pause and message every session. |
|
|
95
101
|
| A lockfile or other file two sessions must not change at once | `[sessions.leases.<name>]` with `path` and the `blocks` command prefixes | A delivery touching that file holds the lease; the listed commands wait. |
|
|
96
|
-
| A git checkout | nothing: `[git] enabled` is `"auto"`, and `[git.shared_checkout]` warns once the hooks exist | A session in the main checkout is warned while
|
|
97
|
-
| Parallel agents in worktrees | `[git.worktrees]`, `[git.worktrees.sync]` | `pmcp git worktree create <alias>`;
|
|
102
|
+
| A git checkout | nothing: `[git] enabled` is `"auto"`, and `[git.shared_checkout]` warns once the hooks exist | A session in the main checkout is warned while worktrees exist. |
|
|
103
|
+
| Parallel agents in worktrees | `[git.worktrees]`, `[git.worktrees.sync]` | `pmcp git worktree create <alias>`; worktrees follow the mainline when that loses nothing. |
|
|
98
104
|
| A protected mainline with a test gate | `[git.mainline]` with `branch`, `[git.mainline.gate]` with `command`, `[git.mainline.deliver]`, `[git.mainline.sync]` | `pmcp git deliver` replays, gates and pushes one delivery at a time; direct `git push` is refused. |
|
|
99
105
|
| Submodules | `[git.submodules]` | Sync follows clean submodule pins. |
|
|
100
106
|
| You will debug hooks | `[logging]` with `level` | `pmcp logs` reads the JSONL; redaction is on by default. |
|
|
101
107
|
| A remote MCP server both Claude and Codex use | `auth = "pmcp"` on that `[mcp.<alias>]`, then `pmcp mcp login <alias>` | One login shared by both tools; tokens never enter the project. |
|
|
108
|
+
| Agents on Gemini CLI, Grok, Antigravity or opencode too | the runtime ids in `[hooks] targets` | The same guards run there; `pmcp doctor` shows what each runtime supports. |
|
|
109
|
+
| Long-running sessions pmcp-pty should host (Linux) | `[host]` with `[[host.sessions]]` and any `[[host.answers]]` | Nothing runs until the user approves it with `pmcp harness host approve` in their own terminal. |
|
|
102
110
|
| A team plugin marketplace | `[marketplaces.<name>]` with `source` and `plugins` | Claude and Codex both enable the same plugins. |
|
|
103
111
|
| Claude Code with several sessions | `[ui.claude]` (needs `[sessions.registry]`) | Session panes and a hold before editing another session's file. |
|
|
104
112
|
| Claude should ask before reading secrets or running risky git | `[permissions.claude]` with `allow`, `ask`, `deny` lists of native rules such as `Read(.env)` or `Bash(git push:*)` | pmcp owns only the entries it adds to `.claude/settings.json`; rules already there stay. Claude only. |
|
|
@@ -1,12 +1,12 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: pmcp-sessions-and-git
|
|
3
|
-
description: Work alongside other agent sessions in a pmcp repository - read who is working and what is held with pmcp sessions status, pause
|
|
3
|
+
description: Work alongside other agent sessions in a pmcp repository - read who is working and what is held with pmcp sessions status, leave pause and broadcast to the user, wait out a lease, work in a linked worktree instead of the shared main checkout, deliver commits through pmcp git deliver rather than git push, sync the main checkout and linked worktrees, and read pmcp logs to explain a hook refusal. Use when a pmcp hook refused or warned, when several agents share one repository, when asked to deliver work, or when a session reports a pause, lease or leftover edits. Not for writing pmcp.toml (set the project up first) or for repositories without pmcp hooks.
|
|
4
4
|
metadata:
|
|
5
5
|
tier: open
|
|
6
6
|
level: L2
|
|
7
7
|
domain: agent-workflow
|
|
8
8
|
install: optional
|
|
9
|
-
keywords: "pmcp, sessions, pause, broadcast, lease, worktree,
|
|
9
|
+
keywords: "pmcp, sessions, pause, broadcast, lease, worktree, deliver, mainline, git sync, pmcp logs, hook refusal"
|
|
10
10
|
requires-bin: "pmcp"
|
|
11
11
|
---
|
|
12
12
|
|
|
@@ -23,48 +23,40 @@ pmcp sessions status
|
|
|
23
23
|
```
|
|
24
24
|
|
|
25
25
|
It prints each live session (its id, runtime, checkout and current tool), the pause, current
|
|
26
|
-
broadcasts, held leases, and files edited but not
|
|
27
|
-
before
|
|
26
|
+
broadcasts, held leases, and files edited but not delivered in a shared checkout. Read it
|
|
27
|
+
before delivering anything, and whenever a hook mentions another session.
|
|
28
28
|
|
|
29
|
-
## Pause and broadcast
|
|
29
|
+
## Pause and broadcast are the user's
|
|
30
30
|
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
pmcp sessions broadcast "main moved; sync your desk before delivering"
|
|
35
|
-
pmcp sessions unbroadcast
|
|
36
|
-
pmcp sessions sweep # drop records whose process is gone
|
|
37
|
-
```
|
|
38
|
-
|
|
39
|
-
While paused, every other session's edits and mutating commands are refused; reading and
|
|
40
|
-
planning continue. A broadcast reaches each session once, as context. An agent does not
|
|
41
|
-
pause, resume or broadcast on its own initiative; it reports the need to the operator.
|
|
31
|
+
Do not pause, resume or broadcast on your own initiative; report the need to the user. While
|
|
32
|
+
a pause is in effect, your edits and mutating commands are refused; keep to reading and
|
|
33
|
+
planning until it lifts.
|
|
42
34
|
|
|
43
35
|
## Leases
|
|
44
36
|
|
|
45
37
|
A lease protects a file two sessions must not change at once, such as a lockfile. While a
|
|
46
|
-
delivery that touches it is
|
|
47
|
-
`... is
|
|
48
|
-
way.
|
|
38
|
+
delivery that touches it is in progress, the commands listed for that lease are refused with
|
|
39
|
+
`... is being delivered ... retry once the delivery finishes`. Wait and retry; do not run
|
|
40
|
+
the command another way.
|
|
49
41
|
|
|
50
|
-
##
|
|
42
|
+
## Linked worktrees, not the shared checkout
|
|
51
43
|
|
|
52
44
|
When the repository has worktrees, the main checkout is shared: an edit left there blocks
|
|
53
|
-
syncing the mainline for every session, and the hook says so. Work in a
|
|
45
|
+
syncing the mainline for every session, and the hook says so. Work in a linked worktree:
|
|
54
46
|
|
|
55
47
|
```sh
|
|
56
|
-
pmcp git worktree create <alias> # prints the
|
|
48
|
+
pmcp git worktree create <alias> # prints the worktree path; work there
|
|
57
49
|
pmcp git worktree list # alias, branch, behind/ahead, path
|
|
58
|
-
pmcp git worktree sync # move this
|
|
50
|
+
pmcp git worktree sync # move this worktree onto the mainline when nothing is lost
|
|
59
51
|
```
|
|
60
52
|
|
|
61
|
-
If you already edited the main checkout,
|
|
62
|
-
|
|
53
|
+
If you already edited the main checkout, deliver those files within the task or move them
|
|
54
|
+
to a linked worktree. `pmcp sessions status` lists them under the shared checkout.
|
|
63
55
|
|
|
64
56
|
## Deliver, do not push
|
|
65
57
|
|
|
66
58
|
With `[git.mainline.deliver]`, a direct `git push` from any checkout of the repository is
|
|
67
|
-
refused. Commit in the
|
|
59
|
+
refused. Commit in the linked worktree, then:
|
|
68
60
|
|
|
69
61
|
```sh
|
|
70
62
|
pmcp git deliver # every commit the upstream lacks
|
|
@@ -78,7 +70,7 @@ stderr; 2 the fetch failed. Fix what the gate reports; never bypass it with
|
|
|
78
70
|
`--no-verify` or a gate-bypass variable, which the guards refuse.
|
|
79
71
|
|
|
80
72
|
`pmcp git sync` moves the main checkout to the mainline afterwards; it refuses (exit 2)
|
|
81
|
-
while
|
|
73
|
+
while undelivered edits sit there.
|
|
82
74
|
|
|
83
75
|
## Explain a refusal with pmcp logs
|
|
84
76
|
|
|
@@ -101,4 +93,4 @@ duration. Secret values, prompt text and environment values are redacted.
|
|
|
101
93
|
|
|
102
94
|
What `pmcp sessions status` showed, which refusal or warning occurred and what it asked
|
|
103
95
|
for, the commands run instead (delivery or sync and their exit codes), and anything left for
|
|
104
|
-
the
|
|
96
|
+
the user (a pause to lift, a lease still held, leftovers in the shared checkout).
|
|
@@ -13,7 +13,7 @@ metadata:
|
|
|
13
13
|
# Scaffolding one skill folder
|
|
14
14
|
|
|
15
15
|
This is the shape, not the content. What the body should say, and how to word a description
|
|
16
|
-
that triggers, is skill authoring
|
|
16
|
+
that triggers, is skill authoring and out of scope here. Here the job is a
|
|
17
17
|
folder that every loader accepts and that carries its own test cases.
|
|
18
18
|
|
|
19
19
|
## Layout
|
|
@@ -35,7 +35,7 @@ for code that is not there.
|
|
|
35
35
|
|
|
36
36
|
## Frontmatter limits
|
|
37
37
|
|
|
38
|
-
These are the checks `pmcp validate` runs
|
|
38
|
+
These are the Agent Skills checks `pmcp validate` always runs:
|
|
39
39
|
|
|
40
40
|
| Field | Rule |
|
|
41
41
|
| --- | --- |
|
|
@@ -47,7 +47,8 @@ These are the checks `pmcp validate` runs (pmcp 0.8):
|
|
|
47
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]`
|
|
51
|
+
(`catalog-v1` or `library`); without one, a skill that breaks them still passes.
|
|
51
52
|
|
|
52
53
|
```markdown
|
|
53
54
|
---
|
package/dist/chunk-E7OOHLQR.js
DELETED
|
@@ -1,74 +0,0 @@
|
|
|
1
|
-
# Manually selected library skills
|
|
2
|
-
|
|
3
|
-
[Back to the overview](../README.md)
|
|
4
|
-
|
|
5
|
-
These three library-major pilots provide free public instructions for Python,
|
|
6
|
-
Rust and Go libraries. Select them yourself and copy them into a local collection
|
|
7
|
-
you choose. No PMCP login, subscription or registry account is required to read
|
|
8
|
-
the files or load that collection.
|
|
9
|
-
|
|
10
|
-
| Ecosystem | Library | Selected version | Instructions |
|
|
11
|
-
| ---------- | -------------------------- | ------------------------------- | ------------------------------------------------------ |
|
|
12
|
-
| PyPI | `pydantic` 2 | `2.13.4` | [Pydantic SKILL.md](/skills/pydantic/2/SKILL.md) |
|
|
13
|
-
| crates.io | `serde_json` 1 | `1.0.149`, with Serde `1.0.228` | [serde_json SKILL.md](/skills/serde-json/1/SKILL.md) |
|
|
14
|
-
| Go modules | `github.com/google/uuid` 1 | `v1.6.0` | [Google UUID SKILL.md](/skills/google-uuid/1/SKILL.md) |
|
|
15
|
-
|
|
16
|
-
Selected versions identify each pilot's scope. They are not a statement that
|
|
17
|
-
every project, feature or AI runtime has been verified. Each SKILL.md contains
|
|
18
|
-
its own supported task boundaries and links to primary documentation and
|
|
19
|
-
licenses. Keep those sources when copying or adapting the instructions.
|
|
20
|
-
|
|
21
|
-
## Choose a collection and copy only the skills you need
|
|
22
|
-
|
|
23
|
-
Place each downloaded file under its frontmatter name:
|
|
24
|
-
|
|
25
|
-
```text
|
|
26
|
-
chosen-collection/
|
|
27
|
-
skills/
|
|
28
|
-
pydantic/
|
|
29
|
-
SKILL.md
|
|
30
|
-
serde-json/
|
|
31
|
-
SKILL.md
|
|
32
|
-
google-uuid/
|
|
33
|
-
SKILL.md
|
|
34
|
-
```
|
|
35
|
-
|
|
36
|
-
Include only your selected files; all three are not required locally. The
|
|
37
|
-
collection may be a plain directory without a package.json. Keep SKILL.md
|
|
38
|
-
frontmatter, source links and any accompanying reference files intact. The
|
|
39
|
-
collection's directory name is a local discovery label, not a registry package
|
|
40
|
-
identity.
|
|
41
|
-
|
|
42
|
-
## Register the collection explicitly
|
|
43
|
-
|
|
44
|
-
For a direct CLI invocation:
|
|
45
|
-
|
|
46
|
-
```bash
|
|
47
|
-
pmcp serve --package /absolute/path/to/chosen-collection
|
|
48
|
-
```
|
|
49
|
-
|
|
50
|
-
Or merge the chosen path into the existing project's pmcp.toml:
|
|
51
|
-
|
|
52
|
-
```toml
|
|
53
|
-
[catalog]
|
|
54
|
-
packages = ["./chosen-collection"]
|
|
55
|
-
```
|
|
56
|
-
|
|
57
|
-
Preserve other catalog entries rather than replacing them with this example.
|
|
58
|
-
Project-relative paths resolve from the configuration's directory. The
|
|
59
|
-
existing `skill_catalog`, `skill_find` and `skill_call` tools can then discover
|
|
60
|
-
and read the selected local instructions. Leave folder trust and tool approval
|
|
61
|
-
to the native AI runtime.
|
|
62
|
-
|
|
63
|
-
## Understand the manual boundary
|
|
64
|
-
|
|
65
|
-
PMCP does not automatically detect these pilots from PyPI, Cargo or Go
|
|
66
|
-
dependencies. They are separate from the managed npm skill catalog and are
|
|
67
|
-
not installed through `pmcp available` or `pmcp install`. Serving a local
|
|
68
|
-
collection does not install a library, download a compiler or run its examples.
|
|
69
|
-
|
|
70
|
-
Loading an instruction file also does not establish model execution evidence.
|
|
71
|
-
Check the project's installed library major, lockfile and environment before
|
|
72
|
-
applying guidance, and run the appropriate project checks after code changes.
|
|
73
|
-
This explicit workflow supplements the package skill discovery described in
|
|
74
|
-
the [skills reference](skills.md).
|