# Skills Skills are reusable sets of instructions you author for Olly. Use them to capture workflows, terminology, or response style — runbooks, naming conventions, on-call procedures — without restating context in every conversation. There are two kinds: - **Personal skills**: you create them, only you see them, and Olly applies them only to your chats. - **Team skills**: a team admin creates them, everyone in the team sees them, and Olly applies them across everyone's chats — for example, a shared runbook for service-degradation alerts, a response template for incident retrospectives, or a guide for which environments to query first. Each 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. To open your skills, select **Settings**, then **Olly AI**, then **Skills**. The page has two tabs — the **Personal** tab lists the skills you've added, and the **Team** tab lists the skills your admin has shared with the team. ## How skills are applied Olly considers built-in skills, your team skills, and your personal skills together when it decides which skill applies. Skill names are unique across your account and your team, so the same name never refers to more than one skill. Adding, editing, or deleting a skill does not reprocess past chats — changes apply to subsequent interactions only. ## Permissions for team skills Anyone with access to Olly can manage their own personal skills — no extra permissions required. Team skills are admin-managed, and the following permissions, both in the **AI** permission group, control access: - The [`OLLY-TEAM-SKILLS:VIEW`](https://coralogix.com/docs/user-guides/aaa/access-control/permissions/permissions-list/index.md) permission to view team skills. - The [`OLLY-TEAM-SKILLS:MANAGE`](https://coralogix.com/docs/user-guides/aaa/access-control/permissions/permissions-list/index.md) permission to add, edit, enable or disable, and delete team skills. When you open the **Team** tab without the manage permission, the page shows the skills your admin has added with the management controls disabled. ## Create a skill Open the **Personal** tab to add a personal skill, or the **Team** tab to add a team skill. The dialog is the same on both tabs. 1. Select **+ New skill**, then **Write skill instructions**. 1. 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](#naming-rules). - **Description**: a one-line summary shown when you pick the skill in chat. - **Instructions**: the Markdown content Olly follows for this skill. 1. Select **Create**. Olly saves the skill and applies it to subsequent chats — to your chats only for a personal skill, or to everyone in the team for a team skill. ## 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`). From the **Personal** or **Team** tab: 1. Select **+ New skill**, then **Upload a file**. 1. Pick a `.md` file that follows this format — `---` dividers enclosing the `name` and `description`, then the instructions: ```markdown --- 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. 1. 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 on either tab, 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. On a team-skill toggle, hovering shows the reminder **Affects all team members.** - **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 the skill descriptions available to you — no action required. 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. The picker shows two grouped sections — **Team skills** at the top and **Personal skills** below — so you can scan them at a glance. 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. ## Naming rules A skill name: - Contains only letters, digits, and hyphens. Spaces, underscores, and other special characters are not allowed. - Is unique within your team. You can't have two personal skills with the same name, and a team skill can't share a name with any personal skill on the team or with another team skill. - Cannot use a name reserved by a built-in skill. If a name violates any of these rules, Olly rejects the skill and surfaces an error. Pick a different name and try again. ## Validation Olly validates every skill before saving it. The same checks apply to personal and team skills. Olly rejects a skill if its instructions contain: - **Prompt injection**: attempts to override Olly's instructions, change tool permissions, exfiltrate data, or reveal internal prompts. - **Foul language**: hate or harassment, sexual content, self-harm, violence, or guidance for illicit or dangerous activity. If a skill fails validation, Olly does not save it and returns an error message explaining why. ## Limits - You can create up to 10 personal skills. - Your team can have up to 10 team 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 a skill limit, delete a skill you no longer use, or disable it, to free up the slot. ## Privacy and scope Personal skills are private to your user account — they don't appear in another user's Olly session, and Olly applies your active personal skills only to your own chats. Team skills belong to your team. Everyone in the team sees them in their Skills mode sessions, and admins can manage them from the **Team** tab. Olly stores skills alongside the rest of your Olly data. See [Data processing, privacy, and compliance](https://coralogix.com/docs/user-guides/olly/data-privacy/index.md) for details. ## Next steps Capture team-wide context the same way with [Rules](https://coralogix.com/docs/user-guides/olly/rules/index.md).