Skip to content

Skill Entries

Skills define what Warden analyzes and when.

FieldPurpose
nameSkill name or path.
pathsFiles to include as glob patterns.
ignorePathsFiles to exclude as glob patterns.
failOnMinimum severity to fail: critical, high, medium, low, info, off.
reportOnMinimum severity to report.
remoteGitHub repository for remote skills: owner/repo or owner/repo@sha.
modelOverride the main agent model for this skill. See Models and Runtimes.
maxTurnsOptional max agentic turns per hunk.

Use paths and ignorePaths to scope a skill:

warden.toml
[[skills]]
name = "api-review"
paths = ["src/api/**/*.ts"]
ignorePaths = ["**/*.test.ts"]
[[skills.triggers]]
type = "pull_request"
actions = ["opened", "synchronize"]
warden.toml
# Built-in skill
[[skills]]
name = "security-review"
# Relative path
[[skills]]
name = "./custom-skills/my-review"
# Remote skill
[[skills]]
name = "api-review"
remote = "your-org/warden-skills"
# Pinned remote skill
[[skills]]
name = "api-review"
remote = "your-org/warden-skills@abc123def"

See skill discovery for resolution order.