Specifiers

skills-package-manager uses specifiers to describe where skills come from.

General format

<source>#[ref&]path:<skill-path>

Supported forms

TypeExample
GitHub shorthandowner/repo
GitHub URLhttps://github.com/owner/repo
Git + pathhttps://github.com/owner/repo.git#path:/skills/my-skill
Git + ref + pathhttps://github.com/owner/repo.git#main&path:/skills/my-skill
Git + commit SHA + pathhttps://github.com/owner/repo.git#6cb0992a176f2ca142e19f64dca8ac12025b035e&path:/skills/my-skill
Local filefile:./local-dir#path:/skills/my-skill

Notes

  • source: A Git repository URL or a local file: path
  • ref: An optional git ref, such as main, a tag, a full commit SHA, or a short commit SHA
  • path: The directory of the skill inside the source repository

Resolution types

  • git: Clone the repository, resolve the commit, and copy the skill files
  • file: Read the local directory and compute a digest

For team collaboration, it is recommended to use explicit specifiers with path: whenever possible. This makes the manifest more stable and easier to review.