Holt community skill registry

This repository is the community skill registry for Holt. It is a monorepo of installable skills plus a registry.json index that Holt reads to let anyone search and install them.

A skill is a folder of prompt text (a SKILL.md) that teaches Holt how to do a specific task well. Skills in this registry are the more specialized ones that do not ship bundled with Holt.

How Holt uses this

Holt reads registry.json from the root of this repo (raw, on main), then installs individual skills by subpath from the same repo.

holt skill search <query>    # search the registry by name, description, or tag
holt skill add <name>        # install a listed skill by name

Under the hood, holt skill add <name> resolves the skill's source and installs the folder by subpath:

holt skill add https://github.com/holt-os/registry#skills/<name>

The #skills/<name> fragment is a subpath into this repo, so each skill folder is fetched directly without cloning the whole registry.

registry.json schema

registry.json lives at the repo root:

{
  "version": 1,
  "skills": [
    {
      "name": "prd",
      "description": "Draft a tight, skimmable Product Requirements Document from a feature idea.",
      "source": "https://github.com/holt-os/registry#skills/prd",
      "author": "Holt",
      "tags": ["product", "writing", "planning"]
    }
  ]
}

• name and source are required.
• description, author, and tags are recommended.
• source always points at this repo with the #skills/<name> subpath.

Repository layout

registry.json          index Holt reads
skills/<name>/SKILL.md  one folder per skill
README.md
CONTRIBUTING.md
LICENSE

Contributing

See CONTRIBUTING.md. In short: add a skills/<name>/SKILL.md, append an entry to registry.json, and open a pull request.