Documentation

Agent Profiles

Agent Profiles change the voice, habits, and prompt instructions driving the current chat. Use them for repeatable styles such as researcher, developer, writing partner, or security reviewer.

Switch Profile In A Chat

Open a chat, click the current profile name near the chat input, choose the profile you want, and continue normally. The change applies to the selected chat.

Agent Profile selector

Create A New Agent Profile

The same menu includes Create new Agent Profile. It places a ready-to-send message in chat and starts a guided profile-creation flow.

Create Agent Profile prompt

Use usr/agents For Direct Edits

Most users should create profiles through the menu above. If you edit files directly, put custom profiles under /a0/usr/agents/<profile-name>/. Custom prompts belong inside that profile's prompts/ folder.

Rule of thumb: whatever is in /a0/usr, if it has the same ID as something in the root /a0 area, the user-owned version replaces or extends the root version. Keep root profiles as the base reference and keep your edits in /a0/usr/agents.

/a0/usr/agents/my_research_profile/
└── prompts/
    ├── agent.system.main.role.md
    └── agent.system.main.communication.md

Profile, Skill, Project, Or Preset?

Agent ProfileChanges role, tone, workflow, and prompt behavior.
SkillAdds a specific procedure or capability to prompt extras.
ProjectAdds workspace, files, memories, instructions, and secrets.
Model PresetChanges which models power the chat.