Skip to content
cccskills
FreePublished on GitHub

agent-validate-config

Validate agent YAML frontmatter and configuration. Use before committing agent changes or in CI.

The English summary is being prepared. Showing the original description.

See how to install

Files included (2)

  • SKILL.md1.8 KB
  • metadata.json1.4 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

Agent Configuration Validation

Verify agent configurations meet ML Odyssey requirements.

When to Use

  • Creating or modifying agent configurations
  • Before committing agent config changes
  • CI/CD validation before merge
  • Troubleshooting agent loading issues

Quick Reference

# Validate all agents
python3 tests/agents/validate_configs.py .claude/agents/

# Validate single agent
./scripts/validate_agent.sh .claude/agents/agent-name.md

Validation Checklist

Required YAML frontmatter fields:

---
name: agent-name              # kebab-case identifier
description: "Brief desc"     # One sentence purpose
mcp_fallback: none
category: agent               # Classification
level: 0-5                    # Hierarchy level
phase: Plan|Test|Implementation|Package|Cleanup
---

Validation includes:

  • YAML syntax correctness
  • All required fields present
  • Correct field types and values
  • Valid tool names (Read, Write, Bash, Grep, Glob)
  • Valid agent references in delegates_to/escalates_to
  • Correct directory structure

Error Handling

ErrorFix
No YAML frontmatterEnsure file starts/ends with ---
Invalid phase valueUse: Plan, Test, Implementation, Package, Cleanup
Delegation target not foundVerify agent name or create referenced agent
Duplicate keysRemove duplicate entries in frontmatter
Wrong level typeMust be integer 0-5, not string

References

  • /agents/templates/ - Agent configuration templates
  • .claude/agents/ - All agent configurations
  • CLAUDE.md - Agent system guidelines

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

[00] TnR ABSOLUTE RIGOR — Systemic Verification Doctrine. Forced cognitive exertion for high-stakes investigations. Mandates absolute deconstruction, mathematical proof chains, and ≥95% derived certainty. Zero-tolerance for heuristics or sentiment-based reasoning. Shortcuts are defined as intentional hallucinations.

The English summary is being prepared. Showing the original description.

diegosouzapw/awesome-omni-skill64Updated Mar 2, 2026

2agent

Free

Configures 2-Agent workflow between PM and implementation roles. Use when user mentions 2-Agent, 2エージェント, PM連携設定, Cursor設定, Cursor連携, 2-agent運用. Do NOT load for: 単独運用, ワークフロー実行, ハンドオフ処理.

The English summary is being prepared. Showing the original description.

diegosouzapw/awesome-omni-skill64Updated Mar 2, 2026

Appends relevant hashtags to journal entries based on content analysis. Intended for LLM execution.

The English summary is being prepared. Showing the original description.

diegosouzapw/awesome-omni-skill64Updated Mar 2, 2026

Add a new AI coding agent to Agent Sandbox. Creates all required files (Dockerfile, templates, CI, docs) and wires the agent into the CLI, proxy, and build system.

The English summary is being prepared. Showing the original description.

diegosouzapw/awesome-omni-skill64Updated Mar 2, 2026

Add a new property to the AI agents database. Use when the user wants to add, create, or introduce a new column, property, field, or feature to track across all agents in the comparison matrix. Handles all four required steps - database updates, groups.json, table display, and GitHub issue templates.

The English summary is being prepared. Showing the original description.

diegosouzapw/awesome-omni-skill64Updated Mar 2, 2026

Add new Agent templates to the meta-agent-skills framework.

The English summary is being prepared. Showing the original description.

diegosouzapw/awesome-omni-skill64Updated Mar 2, 2026

See all skills by diegosouzapw

Report a problem with this skill