Skills Settings
Skills are AI knowledge modules that extend the agent's capabilities for specific tasks — for example, a skill that teaches the agent your company's dbt naming conventions, or a skill with domain-specific transformation patterns.
What's on This Screen
The Skills panel shows:
- A heading: Skills
- A subtitle: "Manage AI knowledge modules that enhance agent capabilities."
- An Import Skill button (blue, top right)
- Skill cards with a toggle to enable or disable each skill, plus a Delete link
Only user-imported skills appear on this screen. Plugin-bundled skills are managed through the Plugins panel.
Importing a Skill
- Click Import Skill.
- A file picker opens. Select a
.skillor.ziparchive (maximum 10 MB). - An Import Skill dialog appears showing the file name and size.
- On success: the dialog shows a green "Skill imported successfully" message with the skill name, description, version, and line count. If the skill has more than 500 lines, a warning notes that large skills may impact agent performance. Click Done to close.
- On name collision: the dialog shows an amber "Name collision" warning with the existing skill's source. You can click Overwrite to replace the existing skill or Cancel to abort.
- On error: the dialog shows a red "Import failed" message with details. Click Close.
Skill archive format
A .skill or .zip archive must contain a SKILL.md file with the skill's instructions. The archive may also include a metadata header with name, description, and version.
Enabling or Disabling a Skill
Each skill card has a toggle switch on the right side.
- Toggle on (blue/active) — the skill's instructions are included in the agent's context for all intents.
- Toggle off — the skill is saved but not injected into the agent context.
Click the toggle to change the state. The change takes effect immediately for new chat messages.
Deleting a Skill
Each skill card has a Delete link below the toggle. Clicking it shows a browser confirmation prompt ("Delete skill {name}? This cannot be undone."). Confirming permanently removes the skill.
States
| State | What you see |
|---|---|
| Empty | No skill cards displayed |
| Skills present | Skill cards with name, description, and enable/disable toggle, plus a Delete link |
Quick Reference
| Action | How |
|---|---|
| Import a skill | Import Skill → select a .skill or .zip file |
| Enable a skill | Click the toggle on the skill card (blue = enabled) |
| Disable a skill | Click the toggle on the skill card (grey = disabled) |
| Delete a skill | Click the Delete link on the skill card and confirm |