Skip to content

Give an agent skills

A skill is a written procedure an agent can apply: how your team runs an accessibility pass, what your definition of done is, how a migration gets reviewed. Skills live in a skill graph for the whole workspace, and each agent is given the ones it should start from.

  • A skill graph with at least one skill in it. Skill graphs are built in Settings, under Skill graphs, for the whole workspace.
  • The agent you are assigning to.
  1. From the agent’s page, select Skills. Rhea’s looks like this.

    Rhea's Skills tab, with entrypoints assigned for meeting and coding modes.

  2. The tab has one section per invocation mode, because an agent behaves differently depending on where it is working:

    ModeWhen it applies
    MeetingThe agent is talking in a meeting
    Task ChatThe agent is in a conversation on a task
    CodingThe agent is executing a run against a repository

    Each section lists only the skills your graph allows in that mode, so a coding-only procedure cannot be assigned to meeting turns by accident. Add skill assigns one, and selecting an assigned chip removes it.

    Rhea holds the frontend and offline storage skills for coding, and the frontend skill for meetings.

  3. Save Changes in the header writes the assignment.

What you assign is where the agent starts, not the full set it can use. From an entrypoint, the graph is walked to a limited depth, so a skill that depends on two others brings them with it. That is why a handful of entrypoints is usually the right number: assigning everything gives the agent a reading list instead of a starting point.

Two different messages, two different causes:

  • No skills for a mode. The graph has skills, but none of them allows that mode. Widen the skill’s allowed contexts in the skill graph.
  • The graph failed to load. The workspace has no draft graph at all. Create one first.

An agent with no skills is not broken. It works from its role, its description, and its system prompt, which is enough for most teams to start with.