clawdbot/docs/platforms/mac/skills.md

summary, read_when

summary	read_when
macOS Skills settings UI and gateway-backed status	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).