Progressive capability gateway
The progressive capability gateway keeps optional extension tools and skills out of the default model context while making them available on demand.
Bundled with Selesai
Loaded automatically with Selesai; no per-extension npm install is required.
Setup and prerequisites
- Bundled with Selesai and loaded automatically.
- No separate installation or configuration is required.
- Built-in tools remain active and are not mediated by the gateway.
What it sets up
- Keeps optional extension tools dormant until they are needed.
- Replaces the full skill index with compact capability guidance.
- Provides catalog search, native tool activation, and explicit skill loading.
- Resets temporary tool activations when an agent run settles.
What you can configure
Optional extension tools and skills stay out of the default model context and are activated explicitly through the compact capability catalog.
Environment variables
| Key / path | Allowed values | Description |
|---|---|---|
SELESAI_CAPABILITY_GATEWAY | unset (enabled), 0 (disabled) | Set to 0 to disable the progressive capability gateway. |
Command, tool, and shortcut controls
| Key / path | Description |
|---|---|
capability_catalog | Search the compact catalog of optional tools and skills. |
capability_discover / capability_skill_show | Activate a catalogued tool or load a skill's full instructions. |
Source evidence
src/extensions/capability-gateway/Capability gateway source
Set SELESAI_CAPABILITY_GATEWAY=0 before launching Selesai to disable the gateway and restore the normal tool and skill surface.
What you can do
- Search optional capabilities with
capability_catalog. - Use natural phrasing or close spellings: a unique routed tool or skill match is returned directly, including a one-character typo in its name.
- Activate a discovered tool with
capability_discover. - Load a skill’s complete instructions with
capability_skill_showbefore applying it.
Commands, tools, and shortcuts
The gateway registers capability_catalog, capability_discover, and capability_skill_show as model tools. They are not slash commands.
Limits and safety
- Only catalogued tools can be activated; exact names are validated before activation.
- Skills are never auto-loaded by routing; their instructions require an explicit show operation.
- Skills already expanded inline via
$skillreferences are excluded from prompt routing, so they are not re-recommended throughcapability_skill_show. - Routing is deterministic and local; ambiguous matches return a hint instead of activating a capability.