help

---
name: help
description: List available commands the user can invoke. Works from CLI or messaging channels. Triggers on /help, /commands, /agent:help, "qué comandos puedo usar", "help commands".
user-invocable: true
---

# Help — list commands

Show a concise, LIVE list of all available commands. Never hardcode — always pull from the `list_commands` MCP tool so recently installed or removed skills are reflected.

## Steps

1. **Detect the surface.** If the incoming message has a `<channel source="...">` marker, you're on a messaging channel. Otherwise you're on CLI or WebChat.

2. **Call `list_commands`** with the right format:
   - **CLI / WebChat:** `list_commands({ format: "table", includeTools: false })` — grouped markdown, readable.
   - **Messaging (WhatsApp, Telegram, Discord, iMessage):** `list_commands({ format: "compact", includeTools: false })` — one line per command, mobile-friendly.

   Leave `includeTools: false` for the user-facing help — MCP tools are agent-invoked, not user-typed. Users who want the internals can ask "what MCP tools do you have?" and you call with `includeTools: true`.

3. **Print the output** from the tool as-is. Do not rewrite or reorder.

4. **Adapt formatting to the channel** after the tool output:
   - WhatsApp: strip `**bold**` → `*bold*`, remove markdown headers if too noisy
   - Telegram: keep `**bold**` or convert to HTML
   - Discord: markdown as-is
   - iMessage: strip markdown to plain text
   - CLI / WebChat: markdown as-is

5. **Append a short native-tools note** at the end (only on CLI):
   ```
   Native Claude Code commands (CLI only): /status /usage /cost /compact /clear /mcp /model /help
   ```

## Example flows

### CLI user asks `/help`

Call `list_commands({ format: "table", includeTools: false })`. Print the returned markdown. Append the native-tools note.

### WhatsApp user says "what can you do?"

Call `list_commands({ format: "compact", includeTools: false })`. Convert any `**bold**` to `*bold*`. Don't include the native-tools note (doesn't apply).

## Notes

- `/help` and `/commands` are aliases.
- Keep the response short on mobile channels. `compact` format handles that.
- If the user wants the internals ("tools", "MCP"), call with `includeTools: true` so they see them too.
- If nothing comes back, something's wrong with the install — suggest `/agent:doctor`.