agent-events

Agent events must be an array with maximum 3 event names

pdugan20@pdugan20

GitHub

From plugin

claudelint

1113 skills13 agents1 command1 hook

Install

$ npx -y skills add pdugan20/claudelint --agent claude-code

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 events must be an array with maximum 3 event names

Agent definition

agent-events.md

description: "Agent events must be an array with maximum 3 event names"

agent-events

Rule Details

This rule validates the `events` field in agent frontmatter. Events must be an array of strings with a maximum of 3 items. This constraint keeps agents focused on a small set of triggers rather than responding to every possible event. The validation is enforced via the AgentFrontmatterWithRefinements schema.

Incorrect

Agent with too many events

---
name: my-agent
description: Monitors everything
events:
  - PreToolUse
  - PostToolUse
  - Stop
  - SessionStart
---

Correct

Agent with a focused set of events

---
name: my-agent
description: Validates tool usage
events:
  - PreToolUse
  - PostToolUse
---

How To Fix

Reduce the `events` array to at most 3 entries. If you need to respond to more events, consider splitting the logic across multiple focused agents.

Options

This rule does not have any configuration options.

Related Rules

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

Resources

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