From director-mode-lite
Validates .claude/agents/*.md files for YAML frontmatter format including required name/description/color/model, optional tools/skills/hooks/memory, valid values, and content structure. Use on specific file or all.
How this skill is triggered — by the user, by Claude, or both
Slash command
/director-mode-lite:agent-checkThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
Validate agent files in `.claude/agents/` for correct format.
Validate agent files in .claude/agents/ for correct format.
.claude/agents/*.md---
name: agent-name # Required: lowercase, hyphenated, 3-50 chars
description: > # Required: 10-5000 chars, include triggering conditions + <example> blocks
Use this agent when [conditions]. Examples:
<example>
Context: [situation]
user: "[request]"
assistant: "[response using this agent]"
</example>
color: cyan # Required: yellow, red, green, blue, magenta, cyan
model: sonnet # Required: inherit, haiku, sonnet, opus, best, sonnet[1m], opus[1m], opusplan
tools: # Optional: YAML list (omit = all tools available)
- Read
- Write
- Grep
# forkContext: "true" # Optional: run in forked context (string "true"/"false")
# maxTurns: 20 # Optional: max conversation turns (positive integer)
skills: # Optional: auto-load skills (array)
- linked-skill
memory: # Optional: memory scopes to load (array)
- user
- project
- local
mcpServers: # Optional: MCP server refs or objects (array)
- server-name
hooks: # Optional: agent-scoped lifecycle hooks
PreToolUse:
- matcher: Write
hooks:
- type: command
command: ./validate.sh
PostToolUse:
- matcher: Bash
hooks:
- type: command
command: ./log.sh
permissionMode: default # Optional: permission handling
disallowedTools: # Optional: explicit tool blocking
- NotebookEdit
---
Read, Write, Edit, Bash, Grep, Glob, Task,
WebFetch, WebSearch, TodoWrite, NotebookEdit
yellow, red, green, blue, magenta, cyan
inherit, haiku, sonnet, opus, best, sonnet[1m], opus[1m], opusplan
name exists (lowercase, hyphenated, 3-50 chars)description exists (10-5000 chars, recommend 200-1000 with <example> blocks)color is set (valid color name)model is set (inherit/haiku/sonnet/opus/best/sonnet[1m]/opus[1m]/opusplan)tools are valid tool names, YAML list format (omit = all tools available)skills references existing skills (array, if set)forkContext is string "true" or "false" (if set)maxTurns is positive integer (if set)memory is valid array of: user, project, local (if set)mcpServers is valid array of string refs or objects (if set)hooks has valid structure (if set)permissionMode is valid value (if set)disallowedTools are valid tool names (if set)# Agent Name heading## Activation sectiontools uses YAML list format (not [Read, Write] bracket array)## Agent Validation Report
### Files Checked
| File | Status | Issues |
|------|--------|--------|
| code-reviewer.md | OK | None |
| my-agent.md | WARN | Missing color, model |
### Summary
- Total: [N]
- Valid: [N]
- Needs fixes: [N]
color field (default: cyan)model field (default: inherit)npx claudepluginhub claude-world/director-mode-liteAudits Claude subagent configurations in .claude/agents/ for frontmatter completeness, tool assignment security, privilege risks, and naming consistency.
Lints agent-facing configuration files including SKILL.md, CLAUDE.md, hooks, MCP servers, plugin manifests, and subagent files. Validates frontmatter, required fields, JSON shape, XML balance, and dangerous commands.
Validates Copilot Studio agent YAML files using LSP binary diagnostics for YAML structure, Power Fx expressions, schema compliance, cross-file references, and environment checks. Useful when checking or verifying agent workspaces.