Skip to content

AAK-POISON-005: Excessive tool description length

Severity
MEDIUM
Category
Tool Poisoning (tool-poisoning)
Scanner
agent_audit_kit/scanners/tool_poisoning.py
Auto-fixable
No.
SARIF name
ToolDescExcessiveLength

What it detects

Tool description exceeds 500 characters, which increases the surface area for hidden instructions.

How to fix

Keep tool descriptions concise and under 500 characters.

To confirm the finding is gone, report only this rule:

agent-audit-kit scan . --rules AAK-POISON-005

Limitations

The 500-character limit is applied to each description string on its own. A tool whose description and parameter descriptions each stay under it is not reported, however much instruction text they add up to.

References


All rules. This page is generated from the rule registry when the documentation is built; to change it, change the rule in agent_audit_kit/rules/builtin.py. To give the rule a hand-written write-up, add docs/rules/AAK-POISON-005.md: the page then shows that text, with the registry reference appended under it.