Pull, status, update

pull

Materialize resolved skills into agent folders and refresh the lockfile.

pm-skills pull
pm-skills pull --dry-run
pm-skills pull --agent claude,codex
pm-skills pull --scope project          # repo-local dirs (default)
pm-skills pull --scope user             # home-dir agent folders
pm-skills pull --frozen                 # CI: exact lockfile SHAs
pm-skills pull --force                  # discard conflicting local edits when supported

status

Two-way drift report (lockfile ↔ disk ↔ server).

pm-skills status
pm-skills status --json

Typical exit codes (CI-friendly):

Code	Meaning
0	Clean
3	Updates available on server
4	Local modifications
5	Both

Exact codes may vary by CLI version — prefer --json in automation and treat non-zero as fail when gating merges.

update

Advance (or roll back) local pins with a diff preview. Does not auto-fire.

pm-skills update                         # walk pending updates
pm-skills update secure-coding-policy    # one skill
pm-skills update --all --yes             # non-interactive (bump PRs)
pm-skills update secure-coding-policy --to a91f3c20be11

Skills in modified locally state should be resolved first (pull --force to discard, or re-apply via UI) so update does not silently destroy work.