agent-validate-config

Validate agent YAML frontmatter and configuration files against schema requirements.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill ensures that agent configuration files adhere to the required structure and content, preventing errors and improving reliability.

Core Features & Use Cases

  • YAML Validation: Checks for correct YAML syntax and presence of all mandatory fields.
  • Field Validation: Verifies correct data types and acceptable values for fields like level and phase.
  • Tool & Reference Validation: Ensures valid tool names and correct references to other agents.
  • Use Case: Before committing a new agent configuration, run this validation to catch potential errors early in the development cycle.

Quick Start

Use the agent-validate-config skill to validate the agent configuration file located at .claude/agents/my-new-agent.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 agent YAML configuration files before committing?

Validate agent YAML configuration files by checking them against predefined schema requirements to verify YAML syntax, required fields, data types, valid tool names, and agent references before committing.

What does YAML frontmatter validation check for in agent development?

YAML frontmatter validation checks for correct YAML syntax and verifies the presence of all mandatory fields, correct data types for fields like level and phase, valid tool names, and correct references to other agents.

Can I use agent config validation in a CI/CD pipeline?

Yes, you can use agent config validation in CI/CD pipelines to ensure configuration integrity by catching potential YAML syntax and schema errors early in the development cycle before new agents are deployed.

What is the best way to ensure agent configuration integrity and prevent errors?

The best way to ensure agent configuration integrity is to validate configuration files against a predefined schema, checking YAML syntax, required fields, data types, valid tool names, and agent references to prevent errors early.

Why does my agent configuration fail validation on required fields?

Agent configuration validation fails when the YAML file lacks mandatory fields, contains incorrect data types for fields like level and phase, uses invalid tool names, or includes incorrect references to other agents.