schemas

Validate YAML frontmatter schemas for Claude Code agent and command definitions.

7|4|Updated Feb 26, 2026
One-click install
npx skills add https://github.com/MadAppGang/magus --skill schemas-madappgang
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: schemas
Source: https://github.com/MadAppGang/magus/tree/main/plugins/agentdev/skills/schemas
Command: npx skills add https://github.com/MadAppGang/magus --skill schemas-madappgang

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill provides clear, structured schemas and validation rules for creating and maintaining Claude Code agents and commands, ensuring consistency and preventing errors.

Core Features & Use Cases

  • YAML Frontmatter Schemas: Defines the required and optional fields for agent and command configurations.
  • Field Reference Tables: Details each field's purpose, requirements, and valid values.
  • Validation Checklist: A step-by-step guide to ensure frontmatter correctness.
  • Common Errors Guide: Illustrates typical mistakes and their corrections.
  • Use Case: When developing a new agent, use these schemas to ensure your SKILL.md file is correctly formatted and includes all necessary parameters like name, description, and model.

Quick Start

Use the schemas skill to validate the frontmatter for a new agent configuration file.

Frequently Asked Questions about schemas

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

FAQPage Schema
How do I validate YAML frontmatter for Claude Code agent configurations?

YAML frontmatter validation for Claude Code agents enforces required fields like `name`, `description`, and `model` using defined schema guidelines. This checks structure and valid values to prevent configuration errors in your `SKILL.md` file.

What fields are required when defining Claude Code commands?

Defining Claude Code commands requires specific YAML frontmatter fields structured by schemas to ensure correctness. The skill provides field reference tables detailing required parameters, optional configurations, and valid values for command workflows and agent tool usage.

How do I fix common YAML schema errors in agent definitions?

Fix common YAML schema errors in agent definitions by referencing the common errors guide provided by the schemas skill. It illustrates typical frontmatter mistakes and shows their corrections, ensuring your agent configuration meets structural validation rules.

Can I use custom model selections in Claude Code agent configurations?

Custom model selections in Claude Code agent configurations are supported through valid values defined in the schemas skill. The schema enforces correct model selection parameters within the YAML frontmatter to maintain consistency across agent definitions.

What is the best way to structure YAML frontmatter for Claude Code?

The best way to structure YAML frontmatter for Claude Code is using the provided schemas and validation checklists. This approach enforces required fields, valid values for tool usage, and correct command workflows, preventing structural inconsistencies.