diff --git a/CHANGES.md b/CHANGES.md index 39a9e28..f365a26 100644 --- a/CHANGES.md +++ b/CHANGES.md @@ -3,7 +3,11 @@ ## 7.0.0b9 (unreleased) -- Nothing changed yet. +- Prefer the installed `plonecli` (on `PATH`, e.g. via `uv tool install + plonecli`) over `uvx` in the skill's invoke docs, so the user's + installed/pinned version runs instead of a separate PyPI-resolved copy. + `uvx` is now documented as a no-install fallback. + [MrTango] ## 7.0.0b8 (2026-05-24) diff --git a/plonecli/skills/plonecli/SKILL.md b/plonecli/skills/plonecli/SKILL.md index 14a02b5..cd71953 100644 --- a/plonecli/skills/plonecli/SKILL.md +++ b/plonecli/skills/plonecli/SKILL.md @@ -9,7 +9,8 @@ description: Scaffold and develop Plone packages with plonecli (copier-template ## How to invoke it -- **End users:** `uvx plonecli ` (no install needed). +- **Installed (preferred):** `plonecli ` — if `plonecli` is on `PATH` (e.g. via `uv tool install plonecli`), always use the bare command so the user's installed/pinned version runs. +- **Not installed / one-off:** `uvx plonecli ` (no install needed). Only fall back to this when `plonecli` is not on `PATH`. - **Inside this repo (plonecli's own source):** it is not on `PATH` — use `uv run plonecli `. On first run, plonecli clones the copier-templates to `~/.copier-templates/plone-copier-templates`. If a command complains about missing templates, run `plonecli update` first.