Skip to content

docs: document skill version pinning via git refs - #204

Open
yunaremaia wants to merge 2 commits into
google:mainfrom
yunaremaia:docs/version-pinning
Open

docs: document skill version pinning via git refs#204
yunaremaia wants to merge 2 commits into
google:mainfrom
yunaremaia:docs/version-pinning

Conversation

@yunaremaia

Copy link
Copy Markdown

Summary

Adds a "Pinning a version" section to the README Installation docs, answering the versioning question raised in #48.

What's documented

  • Install a specific skill version by appending a git ref (#ref) to the package path — commit SHA, tag, or branch:
    npx skills add google/skills/skills/cloud/gke-basics#6f0b877
    npx skills add google/skills/skills/cloud/gke-basics#main
  • Same ref syntax works with Microsoft's apm (Agent Package Manager), as demonstrated in Versioning #48:
    apm install -g google/skills/skills/cloud/gke-basics#6f0b877
  • Use case note: reproducible agent setups (CI pipelines, team workspaces).

Verification

  • npx skills add google/skills/skills/cloud/gke-basics#main was run and correctly resolved to Source: https://github.com/google/skills.git @ main (skills/cloud/gke-basics)
  • Ref syntax is the same one demonstrated with apm in issue Versioning #48

Closes #48

@google-cla

google-cla Bot commented Aug 8, 2026

Copy link
Copy Markdown

Thanks for your pull request! It looks like this may be your first contribution to a Google open source project. Before we can look at your pull request, you'll need to sign a Contributor License Agreement (CLA).

View this failed invocation of the CLA check for more information.

For the most up to date status, view the checks section at the bottom of the pull request.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Versioning

2 participants