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