Skills
Skills are reusable guidance for the Investigator — your runbooks, your conventions, your “here’s how we debug this” knowledge, written down once so every investigation can use it. The Investigator loads a skill when you invoke it from chat with /, or on its own when a skill’s description matches what it’s working on.
Project skills and personal skills
Skills live in two scopes, side by side in the same library:
- Project skills — skills the Investigator can load in this project. Use these for team knowledge: how your alerts are wired, what “normal” looks like for a service, the steps for a recurring incident.
- Your skills — personal skills available to you in every project. Use these for your own habits and shortcuts.
Add a skill
- In the console, open your project’s settings and choose Skills under Agent.
- Click Add skill and pick Project skill or Personal skill.
- Fill in the three fields:
- Name — kebab-case, like
investigate-alb-502. Lowercase letters, numbers, and hyphens only. This is also the skill’s/command. - Description — when the Investigator should load this skill. Write it for the Investigator, not for people: a clear description is what lets it pick the skill up automatically.
- Instructions — the guidance itself, in Markdown. Steps, checks, known causes, whatever you’d tell a new teammate.
- Name — kebab-case, like
- Save. The skill appears in the Library immediately.
When a skill loads
- You invoke it — type
/followed by the skill’s name in chat, or ask for it by name. - It matches — the Investigator loads a skill automatically when its description matches the situation it’s investigating. This is why the description matters more than the name.
Edit or delete
Select a skill in the Library to read it. From there you can edit the description and instructions, or delete the skill — deleting asks for confirmation and removes it permanently.
Next: Memory