agent-identifier

Define and validate agent frontmatter specifications for Claude Code plugins.

Updated Mar 27, 2026
One-click install
npx skills add https://github.com/EmaRimoldi/Claude-scholar-extended --skill agent-identifier-emarimoldi
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: agent-identifier
Source: https://github.com/EmaRimoldi/Claude-scholar-extended/tree/main/skills/agent-identifier
Command: npx skills add https://github.com/EmaRimoldi/Claude-scholar-extended --skill agent-identifier-emarimoldi

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill helps teams create consistent agent metadata for Claude Code plugins by defining a precise frontmatter schema and automated validation steps.

Core Features & Use Cases

  • Standardizes agent metadata fields (name, description, model, color, tools, dependencies, components, is_toxic, toxic_reason)
  • Provides templates and examples for triggering behavior and frontmatter validation
  • Integrates with existing validation scripts (e.g., scripts/validate-agent.sh) to ensure CLAUDE.md alignment
  • Assesses and records safety considerations, including toxicity checks for agent definitions

Quick Start

Create a validated SKILL frontmatter for a new Claude Code agent and craft a corresponding system prompt.

Frequently Asked Questions about agent-identifier

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

FAQPage Schema
How do I craft frontmatter for Claude Code agents?

To craft frontmatter for Claude Code agents, you define a rigorous schema covering name, description, model, color, tools, dependencies, and safety checks. This process enforces project conventions and integrates with validation scripts to ensure metadata correctness.

What is agent metadata validation in Claude Code plugins?

Agent metadata validation is the process of checking frontmatter fields like name, model, and tools against a defined schema. It uses validation scripts to ensure CLAUDE.md alignment, correctness, and safety across the repository.

How do I add toxicity checks to agent metadata YAML files?

To add toxicity checks to agent metadata YAML files, you include the is_toxic and toxic_reason fields in your frontmatter specification. This records safety considerations and assesses potential toxicity for Claude Code agent definitions.

Does the agent frontmatter specification support custom dependencies and components?

Yes, the agent frontmatter specification supports custom dependencies and components. It standardizes these metadata fields within YAML files to ensure all required project conventions are met and validated across the repository.

Why does my Claude Code agent validation script fail on missing frontmatter?

Your Claude Code agent validation script fails on missing frontmatter because the specification rigorously enforces required fields like name, description, and model. It checks YAML frontmatter alignment to ensure metadata correctness and safety before execution.

What's the best way to standardize agent metadata across a repository?

The best way to standardize agent metadata across a repository is to apply a precise frontmatter schema with automated validation scripts. This enforces consistent field definitions and safety checks for all Claude Code plugins.