agent-body-too-short

Agent body content should meet minimum length requirements

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 body content should meet minimum length requirements

Agent definition

agent-body-too-short.md

description: "Agent body content should meet minimum length requirements"

agent-body-too-short

Rule Details

This rule checks that the markdown body of an agent file (the content after frontmatter) contains enough substantive text. Very short body content typically indicates an incomplete agent definition that lacks the detailed instructions needed for effective agent behavior. The minimum length is configurable via the `minLength` option.

Incorrect

Agent body that is too short

---
name: code-review
description: Reviews code for quality
---

Review code.

Correct

Agent body with sufficient instructions

---
name: code-review
description: Reviews code for quality
---

## System Prompt

You are a code review agent. Analyze pull requests for correctness, performance, and style issues. Provide actionable feedback with specific suggestions.

How To Fix

Add more detailed instructions, guidelines, or context to the agent body content. Include a System Prompt section with clear behavioral directives.

Options

Default options:

{
  "minLength": 50
}

Require at least 100 characters of body content:

{
  "agent-body-too-short": [
    "warn",
    {
      "minLength": 100
    }
  ]
}

Use a lower threshold for simple agents:

{
  "agent-body-too-short": [
    "warn",
    {
      "minLength": 30
    }
  ]
}

When Not To Use It

Disable this rule if your agents use an external system prompt source and the agent file body is intentionally minimal.

Related Rules

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

Resources

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