agent-identifier

Validates and standardizes Claude Skills agent frontmatter in SKILL.md files.

5|2|Updated Jul 2, 2026
One-click install
npx skills add https://github.com/Tx1207/hello-scholar --skill agent-identifier-tx1207
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: agent-identifier
Source: https://github.com/Tx1207/hello-scholar/tree/main/skills/meta/agent-identifier
Command: npx skills add https://github.com/Tx1207/hello-scholar --skill agent-identifier-tx1207

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill standardizes how agents are identified and named within Claude Code ecosystems, ensuring consistent discovery, namespace scoping, and reliable tooling interactions.

Core Features & Use Cases

  • Enforces naming rules: lowercase letters, digits, and hyphens, with length 3-50 characters
  • Validates mandatory fields (name, description) in SKILL.md and ensures a clear frontmatter structure
  • Generates a canonical tagline, frontmatter validations, and namespace guidance for agent docs
  • Provides guidance on optional components (scripts, references, assets) and a toxicity check to guard against unsafe content

Quick Start

Use this skill to create or verify the SKILL.md frontmatter for a new agent, ensuring the required fields exist and describe the agent clearly.

Frequently Asked Questions about agent-identifier

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

FAQPage Schema
How do I validate Claude Code agent metadata in SKILL.md frontmatter?

Validating agent frontmatter requires checking that mandatory fields like name and description exist in SKILL.md and follow standard formats. This skill enforces naming rules, field structures, and namespace guidance to ensure consistent agent discovery and tooling interactions.

What are the naming rules for Claude Code agent identifiers?

Claude Code agent identifiers must use lowercase letters, digits, and hyphens, with a length between 3 and 50 characters. This standardization ensures reliable namespace scoping and consistent discovery across the ecosystem.

How do I create a canonical tagline and namespace for a new agent?

Creating a canonical tagline and namespace involves generating standardized frontmatter that clearly describes the agent's purpose. This skill provides namespace guidance and tagline formulation rules to scope agents reliably within Claude Code ecosystems.

What fields are required in SKILL.md frontmatter for agent validation?

The required fields in SKILL.md frontmatter are name and description, which must clearly define the agent. Optional fields include namespace guidance, scripts, references, and assets, alongside a toxicity check to guard against unsafe content.

Does this agent metadata validator check for unsafe content?

Yes, the agent metadata validator includes a toxicity check to guard against unsafe content during the frontmatter validation process. This ensures that generated identifiers, taglines, and descriptions meet safety standards before namespace assignment.

Why does my Claude Code agent namespace validation fail?

Namespace validation fails when agent names violate formatting rules, such as using uppercase letters, special characters, or exceeding the 3-50 character limit. The validator enforces strict lowercase, digit, and hyphens-only naming conventions for reliable tooling.