forked from bots-garden/ori
| ✨ Workspace panel, selectors, previews, desktop app, sandbox template, resizable file tree, light/dark theme | 1 | # How to mention files and invoke skills from the composer |
| 2 | ||
| 3 | This guide shows how to point the agent at workspace files with `@` and how to invoke a Claude Code skill or slash command with `/`, straight from the message composer. It assumes Ori is running (see the [getting started tutorial](../tutorials/getting-started.md)). | |
| 4 | ||
| 5 | ## Mention a file with `@` | |
| 6 | ||
| 7 | 1. In the composer, type `@` at the start of the message or after a space. A popup lists the workspace files; keep typing to filter — `@main` matches `src/main.go` and `src/server/main_test.go`, and a fragment of a directory name works too. | |
| 8 | 2. Move with **↑ / ↓**, pick with **Enter** or **Tab** (or click). The mention becomes `@src/main.go ` in the text. | |
| 9 | 3. Send as usual. The agent receives the text plus a `resource_link` to the file (`file:///…/src/main.go`), which the Claude Code adapter turns into a file reference the model can open. | |
| 10 | ||
| 11 | If you delete a mention before sending, its attachment is dropped too; an `@` glued to a word (`me@example.com`) never opens the popup. **Esc** closes the popup for the current mention. | |
| 12 | ||
| 13 | ## Invoke a skill or command with `/` | |
| 14 | ||
| 15 | 1. Type `/` as the **first** character of the message. The popup lists, sorted by name, the skills found in `<cwd>/.claude/skills/` and `~/.claude/skills/` (tagged **skill**, with the description from their `SKILL.md`) and the slash commands the agent announced over ACP (tagged **command**). | |
| 16 | 2. Filter by name or description, pick with **Enter** / **Tab**: the text becomes `/quality `. Add arguments if the skill takes some, then send. | |
| 17 | ||
| 18 | The skill is invoked the way Claude Code invokes it: the text `/quality …` is what gets sent, there is no separate ACP method. A `/` anywhere else in the message is plain text. | |
| 19 | ||
| 20 | ## Variants | |
| 21 | ||
| 22 | - With the mock agent (`make run-mock`), the `/` popup shows two demo commands (`review`, `compact`) and the answer echoes each attached file as `[attached: <name>]` — handy to check the plumbing without Claude. | |
| 23 | - Skills are listed when the popup first opens; add a skill on disk and reload the page to see it. | |
| 24 | ||
| 25 | ## See also | |
| 26 | ||
| 27 | - Wire format of `attachments`: [WebSocket protocol reference](../reference/websocket-protocol.md) | |
| 28 | - The search and skills endpoints: [workspace API reference](../reference/workspace-api.md) |