# Mentions

Type `@` in the Composer to find a person or resource, then select a result to insert a reference. A selected mention identifies the resource more precisely than writing its name in ordinary text.

Use mentions to make your request specific: which project, which conversation, or which reusable guidance should inform the work. Results depend on the current surface, Workspace, and your access.

## Mention inventory

The shared Composer supports these reference types. Each surface exposes a subset; Agent composers focus on Files, Skills, Designs, Connectors, and MCP servers.

| Reference | Use it to identify |
| --- | --- |
| Collection | A collection of resources |
| Connector | An integration definition |
| Conversation | An existing conversation |
| Design | Visual guidance relevant to the request |
| File | Managed background material |
| MCP server | An available MCP server resource |
| Member | A person in the available member results |
| Playbooks | The Playbooks Operator entry |
| Project | A particular Project |
| Skill | Reusable guidance for a method or task |

These are resource types in the picker, not literal commands such as `@file`. Search for the resource and select the intended result. A plain-text name does not establish the same structured reference.

## Examples

The names below are illustrative. Select resources you can actually access in the mention menu.

| Request | Select this kind of reference |
| --- | --- |
| “Summarize the decisions from the Planning conversation.” | Conversation |
| “Use the Brand guide Design as visual guidance for this page.” | Design |
| “Use the Launch checklist Skill to review this release plan.” | Skill |
| “Use the Product background File when explaining these features.” | File |

After inserting the reference, explain what you want the Operator to do with it. Mentioning a resource alone may not make your intended task clear.

## References and access

A mention does not assign a resource to an Agent or Project, persistently select a Design, or authorize a connection. It also does not grant another person access to the referenced content.

Use [Configuration](/docs/configuration/overview) to make lasting changes and [Connections](/docs/configuration/connections) to manage authorized external access. When you need to supply a new document or image as input, use an [attachment](/docs/composer/controls#attachments).

## Check an ambiguous match

If two Files have similar names, inspect the selected resource and its owning context before relying on it. For example, distinguish the current customer glossary from an older Project-specific copy. If the resource is unavailable, resolve access or supply an authorized [Source](/docs/services/sources); typing its name does not bypass that requirement.