From e6d6ca13ee12f53b66dc374299a2adacfa2e24db Mon Sep 17 00:00:00 2001 From: MrTango Date: Sun, 24 May 2026 12:46:16 +0300 Subject: [PATCH 1/2] Prefer installed plonecli over uvx in skill invoke docs The skill's invoke section led with 'uvx plonecli', which runs a separate PyPI-resolved copy and ignores a version installed via 'uv tool install plonecli'. Make the bare 'plonecli' command (on PATH) the preferred form and demote uvx to a no-install fallback. --- plonecli/skills/plonecli/SKILL.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) 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. From cad6f59e93178247e495ae603b2c825e1eee696e Mon Sep 17 00:00:00 2001 From: MrTango Date: Sun, 24 May 2026 12:52:05 +0300 Subject: [PATCH 2/2] Add changelog entry for skill invoke docs fix --- CHANGES.md | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) 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)