Scenario 35: Add a remote skill package

Frequency: Common · Status: Shipped

← Back to scenarios index

Use this when you want to install skills from a GitHub repo or local skill package in one step — similar to skills add, but with HarnessTap library import and optional plugin composition.

Typical commands:

# Discover skills without installing
harnesstap add mattpocock/skills --list

# Install selected skills globally (non-interactive)
harnesstap add mattpocock/skills --skill caveman,tdd --global --yes

# Install all skills and create a reusable plugin
harnesstap add mattpocock/skills --all --global --create-plugin mattpocock-skills -y

# Install into the current project
harnesstap add ./vendor/skills --project . --skill triage --yes

The command:

1. Resolves the source (GitHub shorthand, URL, or local path) and clones into ~/.harnesstap/cache/sources/ when remote.
2. Discovers skills recursively under skills/ or .agents/skills/.
3. Imports all discovered skills into the HarnessTap library under a source namespace (for example mattpocock/skills).
4. Installs the selected subset to the hub at ~/.agents/skills/{name}/ (global) or {project}/.agents/skills/{name}/ (project), with fan-out symlinks to each target harness.
5. Optionally creates or updates a plugin with namespaced skill refs such as skill:caveman@mattpocock/skills for downstream apply workflows.

After install, edit or apply the plugin:

harnesstap plugin show mattpocock-skills
harnesstap apply mattpocock-skills --project .

See Scenario 4 for adopting an existing project tree and Scenario 5 for building plugins from already-imported resources.