skills.rest
UsernameTron
UsernameTronCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

frontmatter-reference

Define a complete YAML frontmatter schema for Claude Code subagent .md files.

Updated Mar 21, 2026
Search Tags:#validation#schema#yaml#subagent#claude-code#frontmatter
One-click install
npx skills add https://github.com/UsernameTron/Claude-Code-Kickstart --skill frontmatter-reference
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: frontmatter-reference
Source: https://github.com/UsernameTron/Claude-Code-Kickstart/tree/main/plugins/claude-mcp-ecosystem/skills/frontmatter-reference
Command: npx skills add https://github.com/UsernameTron/Claude-Code-Kickstart --skill frontmatter-reference

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Complete YAML frontmatter schema for Claude Code subagent .md files. This reference is injected into architect and scaffolder agents to ensure correct field names, types, and defaults when designing or creating agent files.

Core Features & Use Cases

  • Defines required fields including name and description, plus a suite of optional fields like tools, model, memory, and hooks to tailor agent behavior.
  • Enables consistent frontmatter validation across all subagents, improving routing, permissions, and memory handling.
  • Use Case: design a new subagent for the MCP ecosystem with predictable frontmatter structure and safe defaults.

Quick Start

Create or open a subagent markdown file and apply the reference to validate its frontmatter schema.

Frequently Asked Questions about frontmatter-reference

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

FAQPage Schema
What YAML frontmatter fields are required for Claude Code subagent files?▼

Claude Code subagent frontmatter requires the name and description fields. Optional fields include tools, disallowedTools, model, memory, permissionMode, maxTurns, skills, mcpServers, background, isolation, and hooks to tailor agent behavior with defined defaults.

How do I validate YAML frontmatter schema for Claude Code subagents?▼

To validate subagent frontmatter schema, apply this reference to your .md file to check field names, types, and defaults. It ensures consistent validation across all subagents, improving routing, permissions, and memory handling.

Can I configure permissionMode and maxTurns in subagent YAML frontmatter?▼

Yes, permissionMode and maxTurns are optional fields in the subagent YAML frontmatter schema. Configuring these fields allows you to tailor agent behavior and enforce specific operational boundaries.

What is the best way to structure nested frontmatter fields for Claude Code subagents?▼

The best way to structure nested frontmatter fields is by following a complete YAML schema reference that defines clear typing, defaults, and validation rules for nested structures like hooks and mcpServers.

Does this frontmatter schema support configuring MCP servers and isolation modes?▼

Yes, the schema supports mcpServers and isolation fields to tailor subagent behavior. These optional configurations help architects design subagents for the MCP ecosystem with predictable structure and safe defaults.

Related Skills

Explore More Software Engineering Skills→
jpoutrinjpoutrin
14

create-agent

Create Claude Code agent markdown files with required YAML frontmatter fields.

Community
Basic
jcolanojcolano
1

hive-mind-advanced

Coordinate hierarchical multi-agent systems with consensus and persistent memory.

Community
Advanced
jbabin91jbabin91
2

plugin-creator

Generate Claude Code plugin packages with manifests, directories, and README templates.

Community
Intermediate
bsamieebsamiee
1

agent-builder

Create Claude Code agent files with YAML frontmatter and tool permissions.

Community
Basic