skill-installer

# Skill Installer Use this skill to install workspace skills into the workspace-local `skills/` directory. A freshly installed skill is usable **immediately, in this same run**: `skill({ name: "<id>" })` reads the folder off disk on every call. What waits for the next run is only the skill *listing* in your capability manifest — the skill itself is already there. Never tell the user to start a new conversation to use what you just installed; if they asked you to install it and use it, load it and carry on. ## Import an open-source skill from GitHub (preferred) Open-source skills (e.g. `github.com/anthropics/skills`) are just `SKILL.md` folders in the same format used here, so they can be imported whole. Use the runtime endpoint — it fetches the entire folder (`SKILL.md` plus bundled `scripts/`, `references/`, `assets/`), maps foreign frontmatter (`allowed-tools` → `holaboss_granted_tools`, aligns `name` to the installed id), and writes it under `skills/<id>/`: - Preview (no write): `POST /api/v1/workspaces/{workspaceId}/skills/import-github/preview` with `{ "url": "<github folder or SKILL.md URL>" }` — returns the parsed name, description, granted tools, and file list so you can confirm before installing. - Install: `POST /api/v1/workspaces/{workspaceId}/skills/import-github` with the same body. Accepts `github.com/<owner>/<repo>/tree/<ref>/<path>` (folder), `.../blob/<ref>/<path>/SKILL.md` (single file), or a bare repo. Pass an optional `"ref"` for a specific branch/ta...