skills.rest
lifegenieai
lifegenieaiCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

agent-validation

Validate Claude Code agent files against the official specification.

1|Updated Jan 15, 2026
Search Tags:#developer tools#linting#claude code#spec compliance#configuration check#agent validation
One-click install
npx skills add https://github.com/lifegenieai/lifegenie-claude-marketplace --skill agent-validation
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: agent-validation
Source: https://github.com/lifegenieai/lifegenie-claude-marketplace/tree/main/plugins/agent-reviewer/skills/agent-validation
Command: npx skills add https://github.com/lifegenieai/lifegenie-claude-marketplace --skill agent-validation

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill validates Claude Code agent files, ensuring they adhere to the official specification by checking frontmatter fields, system prompts, and structural integrity, preventing agent malfunction and improving discoverability.

Core Features & Use Cases

  • Frontmatter Validation: Checks for presence and correctness of name, description, model, color, and tools fields.
  • System Prompt Analysis: Validates prompt length and adherence to 2nd-person voice.
  • Structural Integrity Checks: Detects duplicate agent names and incorrect tools formatting.
  • Use Case: Before deploying a new agent, use this skill to automatically audit its configuration against the latest Claude Code standards, catching critical errors like missing required fields or incorrect tool definitions.

Quick Start

Use the agent-validation skill to check the configuration of the agent file located at /path/to/my/agent.md.

Frequently Asked Questions about agent-validation

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

FAQPage Schema
How do I validate my Claude Code agent configuration against the official spec?▼

Validating Claude Code agent configuration requires checking frontmatter fields, system prompt structure, and overall integrity. This skill audits agent files against official standards, identifying critical, important, and nice-to-have issues with suggested fixes to ensure correct functionality and discoverability.

What frontmatter fields are required for a Claude Code agent file?▼

Required frontmatter fields for a Claude Code agent file include name, description, model, color, and tools. The validation process checks for the presence and correctness of these fields to prevent agent malfunction and ensure the configuration meets discoverability standards.

Why does my Claude Code agent fail to meet discoverability standards?▼

Claude Code agents fail discoverability standards due to missing required frontmatter fields, incorrect tools formatting, or duplicate agent names. The validation skill detects these structural integrity issues and provides suggested fixes to align the agent with the official specification.

How do I check if my agent's system prompt follows the correct structure?▼

Checking system prompt structure involves validating prompt length and verifying adherence to 2nd-person voice conventions. The skill analyzes the system prompt content within the agent file to ensure it meets the structural requirements defined by the Claude Code specification.

Can I audit multiple agent files for duplicate names and incorrect tools formatting?▼

Auditing multiple agent files for duplicate names and incorrect tools formatting is supported through structural integrity checks. The validation process scans the provided agent file path to detect configuration conflicts and formatting errors, categorizing them by severity with recommended fixes.

Related Skills

Explore More Software Engineering Skills→
victorjoshi9victorjoshi9
1

agent-development

Create Claude Code agent files with YAML frontmatter and validation scripts.

Community
Advanced
venikmanvenikman

fpf-generate-pattern

Convert E.8 FPF patterns into validated Agent Skill packages.

Community
Intermediate
shanyan-wcxshanyan-wcx
96

trellis-check

Run lint, type checks, tests, and spec synchronization on codebases.

Community
Intermediate
Sanery1Sanery1

unknown-field

Detect and correct non-standard frontmatter fields in SKILL.md files.

Community
Basic