Skills (macOS)

Scope

Use this page when:

• Updating the macOS Skills settings UI
• Changing skills gating or install behavior

The macOS app surfaces Moltbot 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.moltbot.requires in each SKILL.md.

Install actions

• metadata.moltbot.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 ~/.moltbot/moltbot.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).