agent-name

Agent name must be lowercase-with-hyphens, under 64 characters, with no XML tags

Boost this agent

pdugan20@pdugan20

GitHub

From plugin

claudelint

1213 skills13 agents1 command1 hook

Install

> /plugin marketplace add pdugan20/claudelint
> /plugin install claudelint@claudelint

How it fires

How this agent gets triggered: by you, by Claude, or both.

Fires itselfAuto-invocation. Claude auto-loads it when your prompt matches the work.
You can call itInvoke it directly when you want it.

Context preview

The summary Claude sees to decide when to auto-load this agent.

Agent name must be lowercase-with-hyphens, under 64 characters, with no XML tags

Agent definition

agent-name.md

description: "Agent name must be lowercase-with-hyphens, under 64 characters, with no XML tags"

agent-name

Rule Details

This rule enforces naming constraints on the name field in agent markdown frontmatter. The name must be lowercase with hyphens, under 64 characters, and must not contain XML tags. Validation is delegated to the AgentFrontmatterSchema.shape.name Zod schema. Consistent naming ensures agents are easily discoverable and avoids conflicts with reserved syntax.

Incorrect

Agent name with uppercase letters

---
name: My-Agent
description: Handles code reviews
---

Agent name containing XML tags

---
name: <agent>helper</agent>
description: Handles code reviews
---

Correct

Agent name using lowercase and hyphens

---
name: code-review-agent
description: Handles code reviews for pull requests
---

How To Fix

Rename the agent to use only lowercase letters, digits, and hyphens. Ensure the name is under 64 characters and does not include any XML-style tags.

Options

This rule does not have any configuration options.

Related Rules

[`agent-description`](/rules/agents/agent-description)

Resources

[Rule Implementation](https://github.com/pdugan20/claudelint/blob/main/src/rules/agents/agent-name.ts)
[Rule Tests](https://github.com/pdugan20/claudelint/blob/main/tests/rules/agents/agent-name.test.ts)