Skills (macOS)

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

Install actions

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