---
name: source-command-prd-version
description: Check whether a newer PRD Plugin is available on npm, or toggle the auto version check. Host-native /prd-version equivalent for hosts that load skills instead of Claude command files; trigger on "/prd-version", "prd-version", or a request to run the prd-version operation.
---

# /prd-version (host-native command skill)

Generated from `commands/prd-version.md` by `scripts/generate_command_skills.py` — do not edit by hand; edit the command file and regenerate.

Treat the user's invocation as this command. Where the instructions use `$ARGUMENTS`, substitute the arguments the user supplied.

Show, refresh, or toggle the PRD Plugin version-available check. Fail-open and
network-optional; the result is cached with a TTL so it is not a network call
every turn.

The argument is: `$ARGUMENTS` (one of `status`, `check`, `on`, `off`; default `status`).

Run from the repo root (downstream path if it exists, else hub):

- **status** (default): cache-only, no network — what we last knew.
  `python .prd_plugin/scripts/prd_version_check.py --status`
- **check**: query npm now (forced), ignoring the TTL cache.
  `python .prd_plugin/scripts/prd_version_check.py --check --refresh`
- **on** / **off**: enable/disable the auto check (automation.version_check.enabled).
  `python .prd_plugin/scripts/prd_version_check.py --on`

When an update is available the session-start nudge and /prd-status show
`update available: X (you're on Y)` with the update command. Report the result in
one plain line.

## Staleness

This adapter owns no records of its own; apply the shared policy in `.prd_plugin/method/staleness-rules.md` to any records the underlying operation reads or writes.