Przejdź do treści
Biblioteka skilli
Programowanie · Integracja z narzędziem

pm-extensions

/pm-extensions

Zarządza cyklem życia pakietów i rozszerzeń pm-cli: przegląd, instalacja, aktywacja, tworzenie, diagnostyka i walidacja przed wydaniem.

Repozytorium
pm-cli ↗
Licencja
MIT
Ostatnia zmiana repozytorium
27.10.2026

Ocena i bezpieczeństwo

100/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść35 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
4
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
0
Przestarzałość

Brak sygnałów. Repozytorium zmienione 27.10.2026, bez odwołań do wycofanych modeli i API.

Licencja

MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.

Co robi i kiedy

Zarządza cyklem życia pakietów i rozszerzeń pm-cli: przegląd, instalacja, aktywacja, tworzenie, diagnostyka i walidacja przed wydaniem.

Oryginalny opis (EN)

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.

Jak działa

  1. Load Order
  2. Non-Negotiables
  3. Before Creating A Package
  4. Lifecycle Loop
  5. Authoring
  6. Verification
  7. References
Sekcje z nagłówków SKILL.md, w oryginale · 103 linii, 535 słów
Podgląd SKILL.md
---
name: pm-extensions
description: 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.
license: MIT
compatibility: Requires pm package/extension commands and local project/global extension directories.
metadata:
  owner: unbrained
  domain: pm-cli
  scope: extension-workflow
---

# 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

| Tier | Load                                              | Cost      | When                          |
| ---- | ------------------------------------------------- | --------- | ----------------------------- |
| 0    | This file                                         | ~650 tok  | Always.                       |
| 1    | `pm package explore --project`                    | ~0.5-2k   | See what is installed.        |
| 1    | `pm package doctor --detail deep`                 | ~1-3k     | Diagnose activation failures. |
| 2    | `pm contracts --runtime-only --availability-only` | ~1-2k     | What this install exposes.    |
| 3    | `references/*.md` below                           | ~0.3-1k   | Procedure detail.             |
| 4    | `docs/EXTENSIONS.md`, `docs/EXTENSION_LIFECYCLE.md` | varies  | Only when routed there.       |

Optional deep routing that never goes stale:

```bash
pm package 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.

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

## Lifecycle Loop

```bash
pm package explore --project              # inspect state first
pm package manage --project
pm package doctor --detail summary
pm package 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.

```bash
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

```bash
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

Use the [generated capability routing](../../../docs/generated/AGENT_CAPABILITY_ROUTING.md)
to discover the complete contract-owned surface. A capability that does not
suit this project's real workflow should have a sandbox scenario or an explicit
waiver on its canonical item; creating artificial production data is not proof
of useful adoption.

| Need                              | Load                                                | Cost     |
| --------------------------------- | ---------------------------------------------------- | -------- |
| Lifecycle recipes                  | [Extension lifecycle](references/LIFECYCLE.md)       | ~450 tok |
| Failure diagnosis playbook         | [Troubleshooting](references/TROUBLESHOOTING.md)     | ~300 tok |
| Authoring an extension end to end  | [Authoring](references/AUTHORING.md)                 | ~900 tok |
Pliki w paczce (4)
  • SKILL.md 5 KB
  • references/AUTHORING.md 3 KB
  • references/LIFECYCLE.md 1 KB
  • references/TROUBLESHOOTING.md 1 KB

Wersje

W bazie nie ma innych skilli o nazwie pm-extensions.

Migawka bazy z 13.11.2026 · wersja paczki 18592f3c4725 (skrót SHA-256 całej paczki)

Pobrania w ostatnich 30 dniach: 0 · ranking

Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.

Podobne skille

  • 100app-extensions
    Generuje infrastrukturę rozszerzeń aplikacji: Share, Action, Keyboard i Safari Web Extensions, z udostępnianiem danych przez App Groups.
  • 100windsurf-extension-pack
    Instaluje i konfiguruje przydatne rozszerzenia Windsurf zwiększające produktywność.
  • 100publishing-pi-extensions
    Tworzy nową paczkę rozszerzenia pi i wydaje jej kolejne wersje do npm oraz galerii pakietów pi.
  • 90browser-extension-launch
    Buduje, testuje, pakuje i przygotowuje rozszerzenia Chrome do publikacji w sklepie na podstawie opisu pomysłu, od nowych rozszerzeń po poprawki, wydania i naprawę zgłoszeń.
  • 90browser-extension-launch
    Buduje, testuje, pakuje i przygotowuje rozszerzenia Chrome do publikacji w sklepie na podstawie opisu pomysłu, od nowych rozszerzeń po poprawki, wydania i naprawę zgłoszeń.
  • 100scaffold-extension
    Tworzy nowy pakiet rozszerzenia w katalogu extensions/ istniejącego frameworka przy pisaniu rozszerzenia dla AIWG.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.