agentsclimarketplace

Pm extensions

Skill unbraind/pm-cli/.agents/skills/pm-extensions

Manages pm-cli package and extension lifecycle — explore, install, activate, author, diagnose, and release-safe validation. Use when building, integrating, or troubleshooting pm packages, extensions, and extension-provided commands.From its SKILL.md

Install
npx -y skills add unbraind/pm-cli --skill pm-extensions

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

  • 6 stars6 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

What its file declares

Copied from the file, not written here

The file declares its own license as MIT. That is the author’s claim about this one file, and it is not the same thing as the license GitHub reports for the repository, which is listed with the other numbers below.

SKILL.md

4.2 KB, as published. Nobody here has run it

pm Packages and Extensions Skill

Extensions are how pm becomes specific to a project without forking it. They register commands, item types, importers, exporters, search providers, and profiles over the same substrate.

Load Order

TierLoadCostWhen
0This file~650 tokAlways.
1pm package explore --project~0.5-2kSee what is installed.
1pm package doctor --detail deep~1-3kDiagnose activation failures.
2pm contracts --runtime-only --availability-only~1-2kWhat this install exposes.
3references/*.md below~0.3-1kProcedure detail.
4docs/EXTENSIONS.md, docs/EXTENSION_LIFECYCLE.mdvariesOnly when routed there.

Optional deep routing that never goes stale:

pm install guide-shell --project
pm guide extensions

Non-Negotiables

  • Author identity is detected automatically. Never pass --author, never set PM_AUTHOR.
  • Declare the minimum capability set; anything undeclared is not granted.
  • Never mirror a public SDK type inside a package — import it or derive it.
  • Inspect before mutating; verify exposure after.

Before Creating A Package

Check whether an existing package already owns the capability. Extending a published package is almost always correct; a near-duplicate package is the most expensive mistake in an ecosystem.

pm package explore --project
pm package explore --global
pm contracts --runtime-only --availability-only

Lifecycle Loop

pm package explore --project              # inspect state first
pm package manage --detail summary
pm package doctor --detail deep
pm install <package> --project            # then mutate
pm contracts --command <extension-command> --flags-only
pm package doctor --detail deep           # verify after

Order matters: inspect, mutate, verify exposure, record evidence on the linked pm item. Deactivation and uninstall are reversible only if you recorded what they removed.

Authoring

Author with defineExtension and declared capabilities. A capability the manifest does not declare is not granted at activation, which is what keeps a third-party extension from silently widening its own reach.

pm contracts --command package --flags-only
pm contracts --schema-only

Packages ship TypeScript entries and are loaded through native type stripping, so there is no separate build step for a package's own sources. Installed npm extensions are not tracked in the host repository; only the managed-extension manifest is.

Verification

pm package doctor --detail deep
pm contracts --runtime-only --availability-only
pm health --check-only
pm validate --check-resolution

An extension is correctly integrated when pm contracts reports its commands and actions as available and pm <command> --help --json returns a complete flag contract for each one.

References

NeedLoadCost
Lifecycle recipesExtension lifecycle~450 tok
Failure diagnosis playbookTroubleshooting~300 tok
Authoring an extension end to endAuthoring~900 tok

Keep looking

Skills are one crate of 610,220. Ordering is by how many stacks a row turns up in, so the top of any crate is what has actually been picked rather than what has the most stars.