From a5214289ef8b11785cae8cdf851ab38312d3463e Mon Sep 17 00:00:00 2001 From: yunaremaia Date: Sat, 8 Aug 2026 01:29:16 +0000 Subject: [PATCH 1/2] docs: document skill version pinning via git refs --- README.md | 24 ++++++++++++++++++++++++ 1 file changed, 24 insertions(+) diff --git a/README.md b/README.md index 753d99b7f9..4fcf78ff99 100644 --- a/README.md +++ b/README.md @@ -17,6 +17,30 @@ npx skills add google/skills From the `npx install` command, you can select the specific skills from this repo to install. +### Pinning a version + +To install a specific version of a skill, append a git reference (`#ref`) to +the package path — the ref can be a commit SHA, tag, or branch: + +```bash +# Pin a skill to a specific commit +npx skills add google/skills/skills/cloud/gke-basics#6f0b877 + +# Pin to a branch +npx skills add google/skills/skills/cloud/gke-basics#main +``` + +This works with other agent package managers too, e.g. Microsoft's +[`apm`](https://github.com/microsoft/apm): + +```bash +apm install -g google/skills/skills/cloud/gke-basics#6f0b877 +``` + +Pinning is useful for reproducible agent setups (CI pipelines, team +workspaces) where you want to control exactly which version of a skill is in +use. + ## Available Skills From 0ce99a1c3a270200c13edc5b04029006cac19ae3 Mon Sep 17 00:00:00 2001 From: yunaremaia Date: Sat, 8 Aug 2026 14:22:08 +0000 Subject: [PATCH 2/2] chore: trigger CLA recheck