Official agent skill

Warden Skill

Guide for using Warden CLI locally to analyze code changes. An agent skill from getsentry/dotagents.

OfficialMITAuto-check passed

Install Warden Skill

skills CLI

$ npx skills add getsentry/dotagents --skill warden-skill -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI

$ gh skill install getsentry/dotagents warden-skill --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy

$ git clone --depth 1 https://github.com/getsentry/dotagents.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/warden-skill .claude/skills/warden-skill && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Paste into Claude Code

Install the "warden-skill" agent skill from https://github.com/getsentry/dotagents/tree/main/.agents/skills/warden-skill into .claude/skills/warden-skill/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "warden-skill", then confirm the skill loads.

Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

$skill-installer

$skill-installer install https://github.com/getsentry/dotagents/tree/main/.agents/skills/warden-skill

Type this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.

skills CLI

$ npx skills add getsentry/dotagents --skill warden-skill -a codex

Project install goes to .agents/skills/; add -g for ~/.codex/skills/.

GitHub CLI

$ gh skill install getsentry/dotagents warden-skill --agent codex

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/getsentry/dotagents.git skills-src && mkdir -p .agents/skills && cp -r skills-src/.agents/skills/warden-skill .agents/skills/warden-skill && rm -rf skills-src

Use ~/.agents/skills/ instead of .agents/skills for a personal install.

Codex skills documentation · loads skills from .agents/skills/

Paste into Codex

Install the "warden-skill" agent skill from https://github.com/getsentry/dotagents/tree/main/.agents/skills/warden-skill into .agents/skills/warden-skill/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "warden-skill", then confirm the skill loads.

Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add getsentry/dotagents --skill warden-skill -a cursor

Project install goes to .agents/skills/; add -g for ~/.cursor/skills/.

GitHub CLI

$ gh skill install getsentry/dotagents warden-skill --agent cursor

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/getsentry/dotagents.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/.agents/skills/warden-skill .cursor/skills/warden-skill && rm -rf skills-src

Use ~/.cursor/skills/ instead of .cursor/skills for a personal install.

Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/

Paste into Cursor

Install the "warden-skill" agent skill from https://github.com/getsentry/dotagents/tree/main/.agents/skills/warden-skill into .cursor/skills/warden-skill/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "warden-skill", then confirm the skill loads.

Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

gemini skills install

$ gemini skills install https://github.com/getsentry/dotagents.git --path .agents/skills/warden-skill

--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.

skills CLI

$ npx skills add getsentry/dotagents --skill warden-skill -a gemini-cli

Project install goes to .agents/skills/; add -g for ~/.gemini/skills/.

GitHub CLI

$ gh skill install getsentry/dotagents warden-skill --agent gemini-cli

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/getsentry/dotagents.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/.agents/skills/warden-skill .gemini/skills/warden-skill && rm -rf skills-src

Use ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.

Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/

Paste into Gemini CLI

Install the "warden-skill" agent skill from https://github.com/getsentry/dotagents/tree/main/.agents/skills/warden-skill into .gemini/skills/warden-skill/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "warden-skill", then confirm the skill loads.

Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

GitHub CLI

$ gh skill install getsentry/dotagents warden-skill

Installs for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).

skills CLI

$ npx skills add getsentry/dotagents --skill warden-skill -a github-copilot

Project install goes to .agents/skills/; add -g for ~/.copilot/skills/.

Manual copy

$ git clone --depth 1 https://github.com/getsentry/dotagents.git skills-src && mkdir -p .github/skills && cp -r skills-src/.agents/skills/warden-skill .github/skills/warden-skill && rm -rf skills-src

Use ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.

GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/

Paste into GitHub Copilot

Install the "warden-skill" agent skill from https://github.com/getsentry/dotagents/tree/main/.agents/skills/warden-skill into .github/skills/warden-skill/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "warden-skill", then confirm the skill loads.

GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add getsentry/dotagents --skill warden-skill -a opencode

OpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.

GitHub CLI

$ gh skill install getsentry/dotagents warden-skill --agent opencode

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/getsentry/dotagents.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/.agents/skills/warden-skill .opencode/skills/warden-skill && rm -rf skills-src

Use ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.

OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/

Paste into OpenCode

Install the "warden-skill" agent skill from https://github.com/getsentry/dotagents/tree/main/.agents/skills/warden-skill into .opencode/skills/warden-skill/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "warden-skill", then confirm the skill loads.

OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

Facts

Skill name: warden-skill
GitHub stars: 247
Token cost: ~1.4k tokens
SKILL.md length: 312 words
Files: 2 (incl. references)
Skills in repo: 3
Repo updated: Oct 2, 2026
First seen: Oct 7, 2026
Licence: MIT

At a glance

Guide for using Warden CLI locally to analyze code changes. An agent skill from getsentry/dotagents.

Running warden commands
SKILL.md covers Quick Start, CLI Reference, Configuration (warden.toml) and Creating Custom Skills, plus 3 more sections
Needs WARDEN_ANTHROPIC_API_KEY
Configuring warden.toml

What it does

Warden Skill is an agent skill from getsentry/dotagents, published by the product's own GitHub organization. Guide for using Warden CLI locally to analyze code changes. Use when running warden commands, configuring warden.toml, creating custom skills, understanding triggers, or troubleshooting analysis issues. Triggers on "run warden", "warden config", "warden.toml", "create warden skill", "add trigger", or any Warden-related local development task.

Its SKILL.md is about 1.4k tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files, including reference files (for example `references/config-schema.md`).

The licence is MIT.

When your agent uses it

Running warden commands
Configuring warden.toml
Creating custom skills
Understanding triggers

Example prompts

“run warden”
“warden config”
“warden.toml”
“/warden-skill”

Requirements

A credential in WARDEN_ANTHROPIC_API_KEY

What it can do on your machine

Read from SKILL.md and the folder at commit 75a89fd. It shows what the files ask for, not the result of running them.

Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
No scripts in the folder and no shell commands in SKILL.md (its code samples are toml, bash and markdown).
From the folder's file list and the shell code blocks in SKILL.md.
Network
No URLs in SKILL.md.
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names these keys or tokens, usually read from environment variables:
- WARDEN_ANTHROPIC_API_KEY
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Warden Skill loads about 1.4k tokens when it runs, and up to ~2.3k if it reads all its reference files. Until then it costs about 89 tokens; SKILL.md has 312 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it: ~89
When it runs · the whole SKILL.md, loaded when a task matches: ~1.4k
With references · SKILL.md plus every file in references/, read only if the agent opens them: ~2.3k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from getsentry/dotagents at commit 75a89fd, republished under its MIT licence (© getsentry). 312 words, ~1,366 tokens.

Download SKILL.mdSave it as .claude/skills/warden-skill/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.

name: warden-skill
description: Guide for using Warden CLI locally to analyze code changes. Use when running warden commands, configuring warden.toml, creating custom skills, understanding triggers, or troubleshooting analysis issues. Triggers on "run warden", "warden config", "warden.toml", "create warden skill", "add trigger", or any Warden-related local development task.

Warden Usage

Warden is an event-driven AI agent that analyzes code changes and executes configurable skills to produce structured reports with findings.

Quick Start

bash

# Set API key
export WARDEN_ANTHROPIC_API_KEY=sk-ant-...

# Analyze uncommitted changes (uses warden.toml triggers)
warden

# Run specific skill on uncommitted changes
warden --skill find-bugs

# Analyze specific files
warden src/auth.ts src/database.ts

# Analyze changes from git ref
warden main..HEAD
warden HEAD~3

CLI Reference

warden [command] [targets...] [options]

Commands:

(default) - Run analysis
init - Initialize warden.toml and GitHub workflow
add [skill] - Add skill trigger to warden.toml
sync [repo] - Update cached remote skills to latest
setup-app - Create GitHub App via manifest flow

Targets:

<files> - Specific files (e.g., src/auth.ts)
<glob> - Pattern match (e.g., src/**/*.ts)
<git-ref> - Git range (e.g., main..HEAD, HEAD~3)
(none) - Uncommitted changes

Key Options:

Option	Description
`--skill <name>`	Run only this skill
`--config <path>`	Path to warden.toml (default: ./warden.toml)
`-m, --model <model>`	Model to use
`--json`	Output as JSON
`-o, --output <path>`	Write output to JSONL file
`--fail-on <severity>`	Exit 1 if findings >= severity
`--comment-on <severity>`	Show findings >= severity
`--fix`	Auto-apply suggested fixes
`--parallel <n>`	Concurrent executions (default: 4)
`--offline`	Use cached remote skills only
`-q, --quiet`	Errors and summary only
`-v, --verbose`	Show real-time findings
`-vv`	Debug info (tokens, latency)

Severity levels: critical, high, medium, low, info, off

Configuration (warden.toml)

See references/config-schema.md for complete schema.

Minimal example:

toml

version = 1

[defaults]
model = "claude-sonnet-4-20250514"

[[triggers]]
name = "find-bugs"
event = "pull_request"
actions = ["opened", "synchronize"]
skill = "find-bugs"

[triggers.filters]
paths = ["src/**/*.ts"]

With custom output thresholds:

toml

[[triggers]]
name = "security-strict"
event = "pull_request"
actions = ["opened", "synchronize"]
skill = "security-review"

[triggers.filters]
paths = ["src/auth/**", "src/payments/**"]

[triggers.output]
failOn = "critical"
commentOn = "high"
maxFindings = 20

Creating Custom Skills

Skills live in .warden/skills/, .agents/skills/, or .claude/skills/.

Structure:

.warden/skills/my-skill/
└── SKILL.md

SKILL.md format:

markdown

---
name: my-skill
description: What this skill analyzes
allowed-tools: Read Grep Glob
---

[Analysis instructions for the agent]

## What to Look For
- Specific issue type 1
- Specific issue type 2

## Output Format
Report findings with severity, location, and suggested fix.

Available tools: Read, Glob, Grep, WebFetch, WebSearch, Bash, Write, Edit

Remote Skills

Skills can be fetched from GitHub repositories:

bash

# Add a remote skill
warden add --remote getsentry/skills --skill security-review

# Add with version pinning (recommended for reproducibility)
warden add --remote getsentry/skills@abc123 --skill security-review

# List skills in a remote repo
warden add --remote getsentry/skills --list

# Update all unpinned remote skills
warden sync

# Update specific repo
warden sync getsentry/skills

# Run with cached skills only (no network)
warden --offline

Remote trigger in warden.toml:

toml

[[triggers]]
name = "security-review"
event = "pull_request"
actions = ["opened", "synchronize"]
skill = "security-review"
remote = "getsentry/skills@abc123"

Cache location: ~/.local/warden/skills/ (override with WARDEN_STATE_DIR)

Cache TTL: 24 hours for unpinned refs (override with WARDEN_SKILL_CACHE_TTL in seconds)

Common Patterns

Strict security on critical files:

toml

[[triggers]]
name = "auth-security"
event = "pull_request"
actions = ["opened", "synchronize"]
skill = "security-review"
model = "claude-opus-4-20250514"
maxTurns = 100

[triggers.filters]
paths = ["src/auth/**", "src/payments/**"]

[triggers.output]
failOn = "critical"

Skip test files:

toml

[triggers.filters]
paths = ["src/**/*.ts"]
ignorePaths = ["**/*.test.ts", "**/*.spec.ts"]

Whole-file analysis for configs:

toml

[defaults.chunking.filePatterns]
pattern = "*.config.*"
mode = "whole-file"

Troubleshooting

No findings reported:

Check --comment-on threshold (default shows all)
Verify skill matches file types in filters.paths
Use -v to see which files are being analyzed

Files being skipped:

Built-in skip patterns: lock files, minified, node_modules/, dist/
Check ignorePaths in config
Use -vv to see skip reasons

Token/cost issues:

Reduce maxTurns (default: 50)
Use chunking settings to control chunk size
Filter to relevant files with paths

Files

SKILL.md and 1 other file (references) in .agents/skills/warden-skill of getsentry/dotagents.

SKILL.md
references/config-schema.md

Open the folder on GitHubat commit 75a89fd

Compare with similar skills

Warden Skill next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Warden Skill compared with similar skills
Skill	Stars	Used in	Tokens	Auto-check	Licence	Repo updated
Warden Skill this skillgetsentry/dotagents	247	—	~1.4k	Automated safety check: Pass	MIT	5 days ago
LocalizeDonchitos/Claude-Code-Game-Studios	26k	—	~5.2k	Automated safety check: Notes	MIT	8 days ago
SEO LocalAgriciDaniel/claude-seo	18k	—	~4.5k	Automated safety check: Pass	MIT	2 days ago
Local Legal SEO Auditsickn33/agentic-awesome-skills	47k	2 repos	~3.2k	Automated safety check: Pass	MIT	yesterday
Local SEOevery-app/open-seo	23k	—	~1.9k	Automated safety check: Pass	MIT	today
Brightdata Local Searchdavila7/claude-code-templates	32k	—	~1.2k	Automated safety check: Notes	MIT	today

Similar skills

Localize
Donchitos/Claude-Code-Game-Studios
Localization pipeline — find hardcoded strings, extract string tables, cultural review, VO, RTL, enforce string freeze.
26k GitHub stars~5.2k tokensUpdated 8 days ago
Frontend & DesignAuto-check: notes
SEO Local
AgriciDaniel/claude-seo
Audit local SEO, including Google Business Profile, NAP consistency, citations, reviews, local schema, location pages, and multi-location structure.
18k GitHub stars~4.5k tokensUpdated 2 days ago
Marketing & SEOAuto-check passed
Local Legal SEO Audit
sickn33/agentic-awesome-skills
Audit and improve local SEO for law firms, attorneys, forensic experts and legal/professional services sites with local presence, focusing on GBP, directories, E-E-A-T and practice/location pages.
47k GitHub starsUsed in 2 repos~3.2k tokens
Marketing & SEOAuto-check passed
Local SEO
every-app/open-seo
Audit a Google Business Profile, compare it to local competitors, and map Maps visibility around a location.
23k GitHub stars~1.9k tokensUpdated today
Marketing & SEOAuto-check passed
Brightdata Local Search
davila7/claude-code-templates
Set up and run local web searches using Bright Data SERP API with the unfancy-search pipeline (query expansion, SERP retrieval, RRF reranking).
32k GitHub stars~1.2k tokensUpdated today
Productivity & AutomationAuto-check: notes
Local Business
thedaviddias/Front-End-Checklist
A skill your agent uses when auditing a local business website's structured data.
74k GitHub stars~589 tokensUpdated yesterday
Marketing & SEOAuto-check passed

Questions about Warden Skill

What does Warden Skill do?

Guide for using Warden CLI locally to analyze code changes. An agent skill from getsentry/dotagents. Warden Skill is an agent skill from getsentry/dotagents, published by the product's own GitHub organization. Guide for using Warden CLI locally to analyze code changes.

When should I use Warden Skill?

Warden Skill fits situations like: running warden commands; configuring warden.toml; creating custom skills; understanding triggers.

How do I install Warden Skill in Claude Code?

Run `npx skills add getsentry/dotagents --skill warden-skill -a claude-code`. Or copy the skill folder (.agents/skills/warden-skill in getsentry/dotagents) into .claude/skills/warden-skill in your project. Claude Code loads it when a task matches its description.

How do I install Warden Skill in Codex?

Run `npx skills add getsentry/dotagents --skill warden-skill -a codex`. Or copy the skill folder (.agents/skills/warden-skill in getsentry/dotagents) into .agents/skills/warden-skill in your project. Codex loads it when a task matches its description.

Can I use Warden Skill in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add getsentry/dotagents --skill warden-skill -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/warden-skill, .gemini/skills/warden-skill, .github/skills/warden-skill and .opencode/skills/warden-skill in your project.

What does Warden Skill need to run?

Going by SKILL.md and its folder, Warden Skill needs credentials named WARDEN_ANTHROPIC_API_KEY. Our summary lists: A credential in WARDEN_ANTHROPIC_API_KEY.

Does Warden Skill access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Warden Skill safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Warden Skill use?

Warden Skill is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Warden Skill use?

About 1.4k tokens (SKILL.md is roughly 5.5k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 899 tokens, read only when the agent opens those files.

What are the alternatives to Warden Skill?

Skills that share tags, products or a category with Warden Skill: Localize (Donchitos/Claude-Code-Game-Studios, 26k stars), SEO Local (AgriciDaniel/claude-seo, 18k stars), Local Legal SEO Audit (sickn33/agentic-awesome-skills, 47k stars) and Local SEO (every-app/open-seo, 23k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Warden Skill?

getsentry (a GitHub organization, an official publisher) maintains it in getsentry/dotagents, which has 247 GitHub stars. The repository holds 3 skills in this directory. The repository was last updated on October 2, 2026.

Source: getsentry/dotagents on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.

Warden Skill

Install Warden Skill

Facts

At a glance

What it does

When your agent uses it

Example prompts

Requirements

What it can do on your machine

Tool permissions

Runs code

Network

Credentials

Context cost

Safety

SKILL.md

Warden Usage

Quick Start

CLI Reference

Configuration (warden.toml)

Creating Custom Skills

Remote Skills

Common Patterns

Troubleshooting

Files

Compare with similar skills

Similar skills

Localize

SEO Local

Local Legal SEO Audit

Local SEO

Brightdata Local Search

Local Business

More from getsentry/dotagents

Dotagents QA

Dotagents

Questions about Warden Skill