skills.rest
Castrozan
CastrozanCOMMUNITY
Explore all skills by this author →
GitHub

claude-code-agents

Document YAML frontmatter requirements for Claude Code agent definitions.

3|Updated Jul 17, 2024
Search Tags:#automation#development#agents#yaml#claude-code#frontmatter
One-click install
npx skills add https://github.com/Castrozan/.dotfiles --skill claude-code-agents-castrozan
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: claude-code-agents
Source: https://github.com/Castrozan/.dotfiles/tree/main/agents/skills/create-claude-agents
Command: npx skills add https://github.com/Castrozan/.dotfiles --skill claude-code-agents-castrozan

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill documents the YAML frontmatter requirements for Claude Code agents, standardizing how agents are defined and discovered.

Core Features & Use Cases

  • YAML-frontmatter based agent definitions for Claude Code.
  • Clear guidance on required fields and optional resources (scripts/, references/, assets/).
  • Validation and maintenance workflow to ensure consistent agent definitions across a repo.

Quick Start

Place the Claude Code agent in a new skill directory with a SKILL.md containing name and description frontmatter. Include any optional resources under scripts/, references/, or assets/ as needed, and follow the formatting rules in the SKILL.md.

Frequently Asked Questions about claude-code-agents

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

FAQPage Schema
How do I define Claude Code agents using YAML frontmatter?▼

Claude Code agents are defined by creating a SKILL.md file with YAML frontmatter containing at minimum the name and description fields, plus optional model and color guidance for further configuration.

What fields are required in a SKILL.md file for Claude Code agents?▼

A SKILL.md file requires name and description fields in its YAML frontmatter. Model and color fields are optional guidance to include when applicable for your agent definitions.

How do I structure optional resources like scripts and references for Claude Code agents?▼

Optional resources for Claude Code agents are organized into scripts/, references/, and assets/ directories within the skill directory, coordinating with the SKILL.md formatting rules.

How do I validate and maintain consistent Claude Code agent definitions across a repository?▼

Agent definitions are validated and maintained by following the documented YAML frontmatter rules in SKILL.md files, ensuring consistent formatting and required fields across the repository.

Does Claude Code agent YAML formatting work without external dependencies?▼

Claude Code agent YAML formatting works without external dependencies, relying solely on properly structured SKILL.md files with frontmatter and optional resource directories.

Why do my Claude Code agent definitions fail validation in a repository?▼

Claude Code agent definitions fail validation when SKILL.md files omit required name and description frontmatter fields or improperly structure optional resource directories like scripts/ and references/.

Related Skills

Explore More Software Engineering Skills→
TorchedHatTorchedHat
6

skill-writer

Create and validate Claude Code Agent Skill definitions with SKILL.md structure.

Official
Intermediate
clawdataclawdata
24

test-skill

Validate AI prompt handling with repeatable test cases using YAML frontmatter.

Official
Basic
polsegupolsegu

skill-test

Validate YAML frontmatter, phase structure, and procedural hints in SKILL.md files.

Community
Advanced
nholder88nholder88
2

docs-config-authoring

Write and edit Markdown, YAML, JSON, TOML, and INI documentation files.

Community
Intermediate