hraness

saved

Skilldeck: install agent skills from Git-backed catalogs

by Cause-of-a-KindGitHub

gist

Skilldeck is Cause-of-a-Kind's cross-platform CLI for installing and managing agent skills from Git-backed catalogs. Point it at catalogs you trust, install a skill or group into .agents/skills or a native harness directory, and later update from recorded provenance. Named registries stay unambiguous because unqualified names resolve only in the default. First-party skills may render MiniJinja recipes at install time into ordinary portable Agent Skills, so using them does not require Skilldeck. The tool stores no Git credentials, and install provenance lives in .skilldeck/installations.toml.

ideas

  • Catalogs are Git repositories you already trust. Public or private remotes work through system git; Skilldeck stores no credentials and is not a marketplace.
  • Unqualified names stay in the default registry. Adding another named registry cannot change an existing command through an ambiguous search.
  • Portable installs are the default. Skills land in .agents/skills unless --target writes a native harness directory or --claude adds a local compatibility alias.
  • Recipes compile into ordinary skills. MiniJinja templates render at install time; the installed skill does not need Skilldeck or a template engine.
  • Provenance is the update source. .skilldeck/installations.toml records catalog, local, direct-git, or built-in origin so bulk update does not depend on a mutable registry alias.

quotes

Skilldeck installs agent skills from Git-backed catalogs.

Cause-of-a-Kind, stating the product purpose.

Skilldeck never stores Git credentials. Do not put secrets in repository URLs.

Cause-of-a-Kind, stating the credential boundary.

Unqualified names resolve only in the default registry, so adding another registry never changes an existing command through an ambiguous search.

Cause-of-a-Kind, describing registry name resolution.

Render inputs and outputs are plaintext: never use recipe values for secrets or credentials.

Cause-of-a-Kind, stating the recipe secret boundary.