Skip to main content

​
warden add

Add AI analysis skills to your Warden configuration. Skills can be local (from .agents/skills/) or remote (from GitHub repositories).

​
Usage

# Interactive selection
warden add

# Add specific skill
warden add <skill-name>

# Add remote skill
warden add --remote <owner/repo> --skill <skill-name>

# List available skills
warden add --list

​
Options

​
Skill Selection

​
skill-name
string
Name of the skill to add (positional argument or --skill flag)
warden add security-review
warden add --skill bug-detection
​
--skill
string
Skill name (alternative to positional argument)
warden add --skill security-review

​
Remote Skills

​
--remote
string
Remote repository reference for skillsFormats:
  • owner/repo - Latest version from default branch
  • owner/repo@sha - Pinned to specific commit
  • https://github.com/owner/repo - Full GitHub URL
warden add --remote getsentry/skills --skill security-review
warden add --remote getsentry/skills@abc123 --skill bug-detection
warden add --remote https://github.com/getsentry/skills --skill performance

​
Display

​
--list
boolean
default:"false"
List all available skills and exit
warden add --list                    # Local skills
warden add --remote owner/repo --list  # Remote skills
​
--force
boolean
default:"false"
Bypass skill cache and fetch latest from remote (for remote skills)
warden add --remote owner/repo --skill name --force
​
--quiet
boolean
default:"false"
Suppress non-error output
warden add security-review --quiet
​
--color / --no-color
boolean
Force color output on or off
warden add --no-color

​
Local Skills

Local skills are discovered from:
  • .agents/skills/
  • .claude/skills/

​
Interactive Selection

When run without arguments in an interactive terminal, add displays a menu: 
$ warden add

ADD SKILL

› security-review [.agents/skills]
    Detects security vulnerabilities and unsafe patterns
  bug-detection [.agents/skills]
    Finds logic errors and potential bugs
  ✓ code-quality [.agents/skills] (already configured)
    Reviews code quality and maintainability
Use arrow keys to navigate, Enter to select, or Ctrl+C to cancel.

​
List Available Skills

$ warden add --list

Available Skills

  ✓ bug-detection [.agents/skills] (already configured)
    Finds logic errors and potential bugs
    
    code-quality [.agents/skills]
    Reviews code quality and maintainability
    
    security-review [.agents/skills]
    Detects security vulnerabilities and unsafe patterns

​
Add Specific Skill

warden add security-review
Output: 
✓ Added skill 'security-review' to warden.toml

The skill will run on pull requests.
Edit warden.toml to customize filters and output options.

​
Remote Skills

Remote skills are fetched from GitHub repositories and cached locally in .warden/skills/.

​
Add from Remote Repository

# Latest version
warden add --remote getsentry/skills --skill security-review

# Pinned version
warden add --remote getsentry/skills@abc123 --skill security-review

# Full URL
warden add --remote https://github.com/getsentry/skills --skill security-review
Output: 
Fetching skills from getsentry/skills...
✓ Found 5 skills

✓ Added skill 'security-review' to warden.toml

The skill will run on pull requests using skill from getsentry/skills.
Edit warden.toml to customize filters and output options.

​
List Remote Skills

$ warden add --remote getsentry/skills --list

Fetching skills from getsentry/skills...
✓ Found 5 skills

Available Skills from getsentry/skills

    api-security
    Reviews API endpoints for security issues
    
    bug-detection
    Finds logic errors and potential bugs
    
  ✓ security-review (already configured)
    Detects security vulnerabilities and unsafe patterns

​
Force Refresh Remote Cache

Bypass the cache to fetch the latest version: 
warden add --remote owner/repo --skill name --force

​
Configuration Format

Skills are appended to warden.toml with default triggers:

​
Local Skill

[[skills]]
name = "security-review"

[[skills.triggers]]
type = "pull_request"
actions = ["opened", "synchronize", "reopened"]

​
Remote Skill

[[skills]]
name = "security-review"
remote = "getsentry/skills"

[[skills.triggers]]
type = "pull_request"
actions = ["opened", "synchronize", "reopened"]

​
Pinned Remote Skill

[[skills]]
name = "security-review"
remote = "getsentry/skills@abc123def456"

[[skills.triggers]]
type = "pull_request"
actions = ["opened", "synchronize", "reopened"]

​
Customization

After adding a skill, edit warden.toml to customize:

​
Path Filters

[[skills]]
name = "security-review"
paths = ["src/**/*.ts", "src/**/*.tsx"]
ignorePaths = ["**/*.test.ts", "**/__fixtures__/**"]

​
Severity Thresholds

[[skills]]
name = "security-review"
failOn = "high"      # Override default
reportOn = "medium"  # Override default

​
Multiple Triggers

[[skills]]
name = "security-review"

[[skills.triggers]]
type = "pull_request"
actions = ["opened", "synchronize"]

[[skills.triggers]]
type = "push"
branches = ["main", "develop"]

​
Exit Codes

​
0
Success
  • Skill added successfully
  • Skill already configured (no changes)
  • List displayed successfully
​
1
Error
  • Not in a git repository
  • warden.toml not found (run warden init first)
  • Skill not found
  • Invalid remote reference
  • Network error fetching remote

​
Examples

​
Interactive Workflow

# Initialize Warden
warden init

# Add skill interactively
warden add

# List configured skills in warden.toml
cat warden.toml

​
Non-Interactive

# Add specific skill
warden add security-review

# Add multiple skills
warden add security-review
warden add bug-detection
warden add code-quality

​
Remote Skills

# Browse available skills
warden add --remote getsentry/skills --list

# Add remote skill
warden add --remote getsentry/skills --skill api-security

# Pin to specific version
warden add --remote getsentry/skills@abc123 --skill api-security

# Update to latest (re-add with --force)
warden add --remote getsentry/skills --skill api-security --force

​
Automation

# Add skills in CI/CD
warden add security-review --quiet
warden add bug-detection --quiet

# Verify configuration
warden --skill security-review --dry-run

​
Requirements

  • Must run from a git repository
  • warden.toml must exist (run warden init first) - except when using --list without --remote
  • For local skills: Skills must exist in .agents/skills/ or .claude/skills/
  • For remote skills: Network access (unless using --offline with cached skills)

​
Skill Discovery

Warden discovers skills by reading SKILL.md files: 
.agents/skills/
├── security-review/
│   ├── SKILL.md          # Skill definition
│   └── references/       # Additional context files
└── bug-detection/
    └── SKILL.md
Each SKILL.md must include: 
---
name: security-review
description: Detects security vulnerabilities and unsafe patterns
---

​
Remote Caching

Remote skills are cached in .warden/skills/ after first fetch: 
.warden/
├── skills/
│   └── getsentry-skills-abc123/
│       ├── security-review/
│       └── bug-detection/
└── state.json  # Cache metadata
Cache benefits:
  • Offline usage with --offline flag
  • Faster repeated operations
  • Consistent versions across team
Update cache with warden sync.

Build docs developers (and LLMs) love

Get started for freeTalk to us