How to mention files and invoke skills from the composer

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).

Mention a file with `@`

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.
Move with ↑ / ↓, pick with Enter or Tab (or click). The mention becomes @src/main.go in the text.
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.

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.

Invoke a skill or command with `/`

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).
Filter by name or description, pick with Enter / Tab: the text becomes /quality . Add arguments if the skill takes some, then send.

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.

Variants

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.
Skills are listed when the popup first opens; add a skill on disk and reload the page to see it.

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28


# How to mention files and invoke skills from the composer

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)).

## Mention a file with `@`

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.
2. Move with **↑ / ↓**, pick with **Enter** or **Tab** (or click). The mention becomes `@src/main.go ` in the text.
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.

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.

## Invoke a skill or command with `/`

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**).
2. Filter by name or description, pick with **Enter** / **Tab**: the text becomes `/quality `. Add arguments if the skill takes some, then send.

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.

## Variants

- 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.
- Skills are listed when the popup first opens; add a skill on disk and reload the page to see it.

## See also

- Wire format of `attachments`: [WebSocket protocol reference](../reference/websocket-protocol.md)
- The search and skills endpoints: [workspace API reference](../reference/workspace-api.md)

How to mention files and invoke skills from the composer

Mention a file with @

Invoke a skill or command with /

Variants

See also

Mention a file with `@`

Invoke a skill or command with `/`