28 lines
1.1 KiB
Markdown
28 lines
1.1 KiB
Markdown
---
|
|
summary: "macOS Skills settings UI and gateway-backed status"
|
|
read_when:
|
|
- Updating the macOS Skills settings UI
|
|
- Changing skills gating or install behavior
|
|
---
|
|
# Skills (macOS)
|
|
|
|
The macOS app surfaces Clawdbot skills via the gateway; it does not parse skills locally.
|
|
|
|
## Data source
|
|
- `skills.status` (gateway) returns all skills plus eligibility and missing requirements
|
|
(including allowlist blocks for bundled skills).
|
|
- Requirements are derived from `metadata.clawdbot.requires` in each `SKILL.md`.
|
|
|
|
## Install actions
|
|
- `metadata.clawdbot.install` defines install options (brew/node/go/uv).
|
|
- The app calls `skills.install` to run installers on the gateway host.
|
|
- The gateway surfaces only one preferred installer when multiple are provided
|
|
(brew when available, otherwise node manager from `skills.install`, default npm).
|
|
|
|
## Env/API keys
|
|
- The app stores keys in `~/.clawdbot/clawdbot.json` under `skills.entries.<skillKey>`.
|
|
- `skills.update` patches `enabled`, `apiKey`, and `env`.
|
|
|
|
## Remote mode
|
|
- Install + config updates happen on the gateway host (not the local Mac).
|