Skills System

Dynamic prompt enhancement via markdown files. Skills inject context-specific instructions when triggered by keywords in user messages.

Configuration

config.toml
[skills]
dir = "skills"
enabled = true

Skill File Format

Skills are markdown files with YAML-like frontmatter, stored in the skills directory:

skills/code-review.md
---
name: Code Review
description: Provides code review guidelines
triggers: review, code review, PR, pull request
---
When reviewing code, follow these guidelines:

1. Check for security vulnerabilities
2. Verify error handling
3. Assess readability and naming
4. Look for performance issues
5. Ensure tests are adequate

Frontmatter Fields

KeyTypeDefaultDescription
namestringDisplay name of the skill
descriptionstringBrief description (shown in "Available Skills" list)
triggersstringComma-separated keywords that activate the skill

Matching

Trigger matching is case-insensitive substring matching. If any trigger keyword appears anywhere in the user's message, the skill activates.

System Prompt Injection

When skills are loaded, the system prompt is enhanced with:

  1. Available Skills — lists all skill names and descriptions
  2. Active Skills — full body of each matched skill
  3. Known Facts — stored facts (injected below skills)
system prompt structure
## Available Skills
- Code Review: Provides code review guidelines
- DevOps: Infrastructure and deployment help

## Active Skill: Code Review
When reviewing code, follow these guidelines:
...

## Known Facts
### user
- name: David