Skip to content

Custom skills

Custom skills are reusable sets of instructions you author for Olly. Use them to capture your team's workflows, terminology, or response style — runbooks, naming conventions, on-call procedures — without restating context in every conversation.

Each custom skill is a short Markdown document with a name, a description, and the instructions Olly applies when the skill runs. Olly loads a relevant skill on its own when it thinks the question fits, and you can also pick one explicitly while chatting.

Skills run in Pro mode, which is Olly's default. See Olly modes for details.

Manage custom skills

The settings page lists the custom skills you've added. To open it, select Settings, then Olly AI, then Olly AI skills.

Create a skill from scratch

  1. Select + New skill, then Write skill instructions.
  2. In the create dialog, fill in all three fields — every field is required:
    • Name: a short identifier you use to invoke the skill in chat (for example, log-summarizer). See Naming rules.
    • Description: a one-line summary shown when you pick the skill in chat.
    • Instructions: the Markdown content Olly follows for this skill.
  3. Select Create.

Create skill in Olly

Olly saves the skill and applies it to your subsequent chats.

Upload a skill file

If you already maintain skill files elsewhere — for example, in a Git repository — upload them directly. By convention, the file is named for the skill's purpose (for example, read-logs.md).

  1. Select + New skill, then Upload a file.
  2. Pick a .md file that follows this format — --- dividers enclosing the name and description, then the instructions:

    ---
    name: read-logs
    description: Summarize the last hour of logs by service.
    ---
    
    When this skill is invoked, group log entries by `service.name` and
    surface the top three error categories per service.
    

    Olly reads the name and description from between the dividers. Everything after the closing --- becomes the skill's instructions.

  3. Confirm the upload.

If the file is missing the dividers, the name, or the description, Olly rejects the upload and surfaces an error.

Edit, enable, or delete a skill

From a skill card, you can:

  • Edit: open the dialog and update the name, description, or instructions. Changes apply to subsequent chats; past chats stay unchanged.
  • Enable or disable: toggle the card switch. A disabled skill stays in the list, but Olly doesn't load it or suggest it in chat. New skills are active by default.
  • Delete: remove the skill permanently. Olly asks you to confirm before deleting; the action cannot be undone.

Invoke a skill in chat

Olly may load a relevant skill on its own when the question matches one of your skill descriptions — no action required from you.

To force a specific skill, pick it explicitly in either of two ways:

  • Slash command: type / in the chat prompt and pick the skill from the autocomplete picker. As you keep typing, the list filters to matching names. Confirm with Enter or Tab to insert your selection.
  • + menu: select the + icon in the chat input bar, then Skills, and pick a skill from the list. Selecting Manage skills opens the settings page.

When you pick a skill, Olly loads its instructions into the current chat and responds according to them.

Invoke a skill

Naming rules

A skill name:

  • Contains only letters, digits, and hyphens. Spaces, underscores, and other special characters are not allowed.
  • Is unique among your custom skills.
  • Cannot use a name reserved by Coralogix.

If a name violates any of these rules, Olly rejects the skill and surfaces an error.

Limits

  • You can create up to 10 custom skills.
  • A skill name is up to 64 characters.
  • A skill description is up to 200 characters.
  • A skill's instructions are up to 20 KB.

If you reach the skill limit, delete a skill you no longer use or disable it to free up the slot.

Privacy and scope

Custom skills belong to your user account. Other members of your team don't see them and can't use them — your skills don't appear in another user's Olly session. Olly applies your active custom skills only to your own chats.

Olly stores your skills alongside the rest of your Olly data. See Data processing, privacy, and compliance for details.

Next steps

Capture team-wide context the same way with Rules.