BetterClaw
Models & Skills

Installing skills

Install skills from ClawHub, GitHub, a URL, or a file upload.

Installing skills

Open the Skills page and click Add skill, then pick a source. You can also install a catalog skill in one click from the Available skills section — the + button on a card opens a short confirmation; click Install. Catalog skills turn on for every agent.

From ClawHub

  1. Choose ClawHub as the source.
  2. Browse clawhub.ai and paste a skill page URL.
  3. Click Install.

From GitHub

  1. Choose GitHub repo.
  2. Enter the repository URL. If the repo has a SKILL.md at its root, the path is optional — otherwise enter the path to the skill within the repo.
  3. Click Install.

From a URL

  1. Choose From URL.
  2. Paste a link to a raw SKILL.md or a ZIP.
  3. Click Install.

Upload a file

  1. Choose Upload file.
  2. Select a .md, .js, or .zip file from your machine.
  3. Click Install.

Upload many skills at once

To move a set of skills in one go, put them in a single ZIP with one folder per skill, each with its own SKILL.md:

my-skills.zip
├── daily-report/
│   ├── SKILL.md
│   └── scripts/fetch.js
├── invoice-check/
│   └── SKILL.md
└── weekly-digest/
    └── SKILL.md
  1. Choose Upload file and select the ZIP. The dialog shows how many skills it found.
  2. Tick the agents to turn all of them on for. Leave every box clear to install them switched off. (If the dialog says it can't preview the ZIP's contents, it still installs, with every skill switched off; turn them on from each skill's card.)
  3. Click Install N skills.

Each folder installs as its own skill, named from its SKILL.md frontmatter. The dialog shows progress while they install, then lists any skills that need a secret before they work. Click Set secrets next to one to choose or create its secret for each agent. You can also do this later from the skill's card under Manage agents; until then, the skill is on but can't use the secret.

A skill that fails (for example, a broken SKILL.md, or a second folder whose SKILL.md has the same name as another in the ZIP) shows failed on its own card; the rest still install. To retry, fix it and upload the same ZIP again: skills that are already installed are skipped, and the one that failed installs in place of its failed card.

A ZIP can hold up to 500 skills, be up to 50 MB, and unpack to at most 100 MB; each skill inside is limited to 5 MB. A SKILL.md inside another skill's folder counts as part of that skill, and a ZIP with a SKILL.md at its root installs as a single skill.

the Add skill dialog with the four source options

Configure and enable

The skill installs (installing → ready). Once ready, the dialog moves to a configure step where you:

  1. Pick the agents to enable the skill on. A skill installed from ClawHub, GitHub, a URL, or a file is turned on only for the agents you pick here.
  2. For any agent, bind the secrets the skill requires — choose an existing secret of the right kind, or create one inline (API key, username/password, or generic value).
  3. Click Enable on N agents. You can also Skip for now — the skill stays installed but off for every agent until you enable it from the skill's card.
If an install shows failed, check the source (ClawHub URL, repo, URL, or file) is valid. Catalog installs offer a Retry button on the card. If the skill installed but couldn't be pushed to an agent, that agent shows Failed with the error on the skill's Agents tab, with a Retry button.