How do I format the 'tools' field in the YAML?

Tools must be provided as a comma-separated list with a space following each comma, such as: 'tools: TodoWrite, Read, Write'.

Why does the agent description require three or more examples?

Providing 3-5 specific usage examples helps the orchestrator understand the exact scenarios where the agent should be triggered, improving task accuracy.

What are the recommended tool patterns for different agent types?

The skill defines specific patterns: Implementers get 'Write' and 'Edit' tools, while Reviewers and Orchestrators are typically restricted from direct writing to maintain workflow integrity.

What is the purpose of the 'schemas' skill?

It provides standardized YAML templates and validation rules to ensure that custom Claude Code agents and commands are configured correctly and perform predictably.

Which AI models are supported in the agent frontmatter?

The current schema supports the 'sonnet', 'opus', and 'haiku' models.

Claude Agent & Command Schemas

Name: Claude Agent & Command Schemas
Author: MadAppGang

byMadAppGang

•

177

Productivity & Workflow

Standardizes the creation and validation of YAML frontmatter for Claude Code agents and commands.

About

The Schemas skill provides a comprehensive framework for defining custom Claude Code agents and command workflows using structured YAML frontmatter. By enforcing specific schemas for fields like toolsets, model selection, and usage examples, it ensures consistency and reliability across your automation ecosystem. It includes built-in validation checklists and color-coding guidelines to help developers distinguish between planning, implementation, and review roles while preventing common syntax errors during configuration.

Key Features

Standardized YAML frontmatter schemas for Agents and Commands
Prescriptive tool patterns for orchestrators, planners, and implementers
Structured usage example requirements to improve agent routing and clarity
Role-based color coding system for visual agent identification
Strict validation checklists to prevent YAML syntax and formatting errors
177 GitHub stars

Use Cases

Creating multi-phase command workflows with strictly defined tool permissions
Architecting a new custom agent with specific tool access and model constraints
Validating existing agent configurations to ensure compliance with Claude Code best practices

About

Key Features

Standardized YAML frontmatter schemas for Agents and Commands
Prescriptive tool patterns for orchestrators, planners, and implementers
Structured usage example requirements to improve agent routing and clarity
Role-based color coding system for visual agent identification
Strict validation checklists to prevent YAML syntax and formatting errors
177 GitHub stars

Use Cases

Creating multi-phase command workflows with strictly defined tool permissions
Architecting a new custom agent with specific tool access and model constraints
Validating existing agent configurations to ensure compliance with Claude Code best practices