agent-validate-config

Validate agent YAML frontmatter and configuration files.

18|5|Updated Nov 3, 2025
One-click install
npx skills add https://github.com/mvillmow/ml-odyssey --skill agent-validate-config
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: agent-validate-config
Source: https://github.com/mvillmow/ml-odyssey/tree/main/.claude/skills/agent-validate-config
Command: npx skills add https://github.com/mvillmow/ml-odyssey --skill agent-validate-config

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve? This Skill automatically validates agent configuration files (YAML frontmatter) for correct structure, required fields, and proper tool specifications, ensuring the integrity and functionality of the agent system. It automates configuration checks, saving time and preventing errors.

Core Features & Use Cases:

  • YAML Frontmatter Validation: Checks for mandatory fields like name, role, level, phase, and description for complete configurations.
  • Field Value Checks: Validates data types and ranges for fields like level and phase, ensuring correct system behavior.
  • Use Case: After creating a new agent configuration, use this skill to validate its YAML frontmatter. This catches syntax errors or missing fields locally, preventing agent loading issues in your AI system and ensuring smooth operation.

Quick Start: Use the agent-validate-config skill to validate the agent configuration file '.claude/agents/implementation-specialist.md'.

Frequently Asked Questions about agent-validate-config

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I validate YAML agent configuration files?

Validate YAML agent configuration by running the agent-validate-config skill on your .claude/agents files. It checks YAML syntax, required fields like name, role, level, phase, and description, field data types, valid tool names, and proper agent references in delegates_to and escalates_to, catching errors before deployment.

What fields are required in agent YAML frontmatter?

Agent YAML frontmatter requires mandatory fields: name, role, level, phase, and description. The validation skill ensures these fields are present, correctly typed, and contain valid values for system integrity and proper agent functionality.

When should I validate agent configuration in my CI/CD pipeline?

Run configuration validation at pre-commit and CI/CD stages to catch YAML syntax errors, missing fields, invalid tool references, and structural problems before agents load into production, preventing runtime failures and ensuring system reliability.

Can I validate agent delegate and escalation references?

Yes, the validation skill verifies that agents referenced in delegates_to and escalates_to fields exist and are correctly specified, ensuring proper agent routing and preventing broken escalation chains in your system.

What happens if my agent YAML configuration has invalid field types?

The validator rejects configurations with incorrect field types or out-of-range values for level and phase, halting agent creation or modification until the configuration meets schema requirements and ensures consistent system behavior.