Agent skills
Find, invoke, preview, and create skills for your coding agents.
A skill packages instructions in a SKILL.md file. Dream discovers skills for the selected agent
and project using that provider's skill locations. The skill picker supports Claude Code,
Codex, OpenCode, and Cursor Agent.
Use a skill in a chat#
- Open a chat and select the model you want to use.
- Type $ followed by part of a skill's name in the message box.
- Choose a skill from the picker and add your task instructions.
- Send the message.
For example, select a release-checklist skill and ask it to review the current changes before a
release. Dream shows the chosen skill as an inline mention and a skill badge on the sent
message. Available skills can change when you switch the chat's provider or project.
Skill invocation is handled by the selected provider. Mentioning a skill supplies instructions; it does not change the chat's permission settings.
Browse and preview skills#
- Open Settings → Skills.
- Choose the provider tab and the project to inspect.
- Select a skill to see its description, source, path, and
SKILL.mdpreview. - Use Open folder to edit its files in your preferred editor.
Skills are grouped by scope, such as Project, Personal, Plugin, Managed, and Built-in, when those sources are available. Use Refresh after installing or editing a skill if it has not appeared yet.
Enable or disable a skill#
Claude Code and Codex offer per-skill switches. These update the provider's own configuration,
so they also affect skill availability outside Dream. Claude Code stores overrides in
~/.claude/settings.json; Codex stores them through its app-server in ~/.codex/config.toml.
OpenCode and Cursor do not offer a per-skill switch in Dream. To stop loading a skill, manage its folder in the provider's skill locations.
Create a skill#
- In Settings → Skills, choose the project if the skill should belong to one.
- Click New skill.
- Enter a Name, a Description explaining when to use it, and Instructions (SKILL.md).
- Select one or more Location choices.
- Optionally select Only run when mentioned, then click Create.
Names use lowercase letters, digits, and hyphens, with a maximum of 64 characters. Dream creates
a folder with that name and a SKILL.md file in each chosen location.
| Location | Intended use |
|---|---|
Project · .agents/skills | Shared project skills for Codex, OpenCode, and Cursor |
Project · .claude/skills | Project skills for Claude Code |
Personal · ~/.agents/skills | Shared personal skills for Codex, OpenCode, and Cursor |
Personal · ~/.claude/skills | Personal skills for Claude Code |
Project locations require an open project. Only run when mentioned writes the skill's
disable-model-invocation setting; how that setting is enforced depends on the provider.
You can also start from Save as skill in Settings → Prompts.
If a skill is missing#
Check the selected provider and project, refresh the list, and read any discovery error shown in Settings. Confirm that the skill is in a location the provider reads and that it has not been disabled. A skill available to one provider is not necessarily available to another.