diff --git a/.agents/skills/commitizen/SKILL.md b/.agents/skills/commitizen/SKILL.md
index 0aa3871b8..dc957abca 100644
--- a/.agents/skills/commitizen/SKILL.md
+++ b/.agents/skills/commitizen/SKILL.md
@@ -6,7 +6,7 @@ compatibility: Git repository with Python and Commitizen available as `cz` or ru
 metadata:
   project: commitizen-tools/commitizen
   docs: https://commitizen-tools.github.io/commitizen/
-  install: "pip install commitizen"
+  install: "pipx install commitizen"
 ---
 
 # Commitizen
@@ -39,7 +39,7 @@ Commitizen is a CLI for enforcing Conventional Commits, automating version bumps
 
 ## Important domain details
 
-- Commitizen installs with `pip install commitizen` or `uv add commitizen`.
+- Commitizen supports both global installation (recommended for the `cz` CLI) and project-local installation; see the installation section in `docs/README.md` for the full matrix of supported tools.
 - The default version scheme is PEP 440; `semver` and `semver2` are also supported.
 - Common version providers include `commitizen`, `pep621`, `poetry`, `cargo`, `npm`, `composer`, `uv`, and `scm`.
 - `cz changelog` generates Markdown changelogs.
@@ -63,6 +63,8 @@ Commitizen is a CLI for enforcing Conventional Commits, automating version bumps
   - `docs/tutorials/gitlab_ci.md`
 - Error handling:
   - `docs/exit_codes.md`
+- Installation:
+  - `docs/README.md` (see the *Installation* section for global vs project-local options)
 
 ## Examples