agent-disallowed-tools

Agent disallowedTools must be an array of tool names

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 disallowedTools must be an array of tool names

Agent definition

agent-disallowed-tools.md

description: "Agent disallowedTools must be an array of tool names"

agent-disallowed-tools

Rule Details

This rule enforces that the `disallowedTools` field in agent markdown frontmatter is a valid array of strings. Each entry should be a tool name that the agent is prohibited from using. Validation is delegated to the AgentFrontmatterSchema Zod schema. Proper formatting prevents runtime errors when the agent framework parses tool restrictions.

Incorrect

disallowedTools as a single string instead of array

---
name: safe-agent
description: Agent with tool restrictions
disallowedTools: Bash
---

disallowedTools with non-string entries

---
name: safe-agent
description: Agent with tool restrictions
disallowedTools:
  - 123
  - true
---

Correct

disallowedTools as a valid array of tool names

---
name: safe-agent
description: Agent with tool restrictions
disallowedTools:
  - Bash
  - Write
---

How To Fix

Ensure `disallowedTools` is formatted as a YAML array of strings. Each entry should be a valid tool name like Bash, Write, Edit, or WebFetch.

Options

This rule does not have any configuration options.

Related Rules

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

Resources

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