Install From Catalog
Install a catalog entry into the current workspace or the user's agent dirs,
or add a source to the catalog. Read catalog.yaml in this skill's
directory (the directory that contains this file). When an entry names a
guide, read guides/<guide> in the same directory. Install through the
source's published path for this harness.
When the conversation names a catalog id or name, install that entry. When
it names a source URL absent from the catalog, or asks to add, read ADD.md.
Otherwise list the catalog (id, name, type, npx-skills or guide) and wait
for a pick.
Scope is project or global. Use it when this conversation already named one;
otherwise ask. Do not install until scope is known.
Process
Read catalog.yaml and resolve the entry.
Done when id, name, type, source, and npx-skills are known, and
guide is known when npx-skills is false.
Resolve scope. Detect the current harness from the running agent and its
CLIs (cursor-agent, claude, codex, Junie). When none match, the
harness is skills.sh. Choose the form in type this harness understands:
plugin for Cursor, Claude Code, or Codex; extension for Junie; skill for
skills.sh. If type has no form for this harness, say so and stop.
Done when scope and the install form are known, or the harness is unsupported
for this entry.
If npx-skills is true, run npx skills add <source> with -y. Add -g
when scope is global; project is the installer default. Add --skill <name>
when the catalog or source names one skill in a multi-skill repo.
Done when the installer has finished and the skill is listed for that scope.
If npx-skills is false, fetch the source's current install docs for this
harness and read guides/<guide>. Follow the docs; apply the guide's
deltas (prerequisites, human gates, scope limits, ids that differ by
harness). Run every step this agent can run. For a step only the user can
perform, stop and name the command or UI action. Do not proceed until the
user confirms it is done.
Done when every step on this harness's path has been run or confirmed.
Check that the capability is present: the harness's list command, the
installer's output, or the user's confirmation of a gate. Tell the user what
landed and where.
Done when presence is confirmed or the failure is reported with the next
action.
If the chosen form cannot honour scope, say so and ask again. Offer a form
from type that can, when one exists.
Done when
The chosen entry is present for this harness and scope, or a named gate is
waiting on the user.
1---2name: install-from-catalog3description: Install a catalogued third-party skill, plugin, or extension, or add a source to the catalog.4---56# Install From Catalog78Install a **catalog entry** into the current workspace or the user's agent dirs,9or add a **source** to the catalog. Read `catalog.yaml` in this skill's10directory (the directory that contains this file). When an entry names a11**guide**, read `guides/<guide>` in the same directory. Install through the12source's published path for this harness.1314When the conversation names a catalog `id` or `name`, install that entry. When15it names a source URL absent from the catalog, or asks to add, read `ADD.md`.16Otherwise list the catalog (`id`, `name`, `type`, npx-skills or guide) and wait17for a pick.1819**Scope** is project or global. Use it when this conversation already named one;20otherwise ask. Do not install until scope is known.2122## Process23241. Read `catalog.yaml` and resolve the entry.2526 Done when `id`, `name`, `type`, `source`, and `npx-skills` are known, and27 `guide` is known when `npx-skills` is false.28292. Resolve **scope**. Detect the current harness from the running agent and its30 CLIs (`cursor-agent`, `claude`, `codex`, Junie). When none match, the31 harness is skills.sh. Choose the form in `type` this harness understands:32 plugin for Cursor, Claude Code, or Codex; extension for Junie; skill for33 skills.sh. If `type` has no form for this harness, say so and stop.3435 Done when scope and the install form are known, or the harness is unsupported36 for this entry.37383. If `npx-skills` is true, run `npx skills add <source>` with `-y`. Add `-g`39 when scope is global; project is the installer default. Add `--skill <name>`40 when the catalog or source names one skill in a multi-skill repo.4142 Done when the installer has finished and the skill is listed for that scope.43444. If `npx-skills` is false, fetch the source's current install docs for this45 harness and read `guides/<guide>`. Follow the docs; apply the guide's46 deltas (prerequisites, human gates, scope limits, ids that differ by47 harness). Run every step this agent can run. For a step only the user can48 perform, stop and name the command or UI action. Do not proceed until the49 user confirms it is done.5051 Done when every step on this harness's path has been run or confirmed.52535. Check that the capability is present: the harness's list command, the54 installer's output, or the user's confirmation of a gate. Tell the user what55 landed and where.5657 Done when presence is confirmed or the failure is reported with the next58 action.5960If the chosen form cannot honour **scope**, say so and ask again. Offer a form61from `type` that can, when one exists.6263## Done when6465The chosen entry is present for this harness and scope, or a named gate is66waiting on the user.
akathecoder