#3402: docs(discord): clarify search doesn't support OR/AND operators
## Summary
Agents often mistakenly try to use boolean operators (OR/AND) in Discord search queries, expecting SQL-like or web-search behavior. Discord's search API matches queries literally as phrases.
## Changes
Added a note to the Discord skill's search section clarifying this limitation and suggesting separate calls for multiple terms.
## AI-assisted
- **Tool:** Claude
- **Testing level:** Lightly tested (documentation-only change)
- **Understanding:** Yes, this is a simple doc clarification based on observed agent behavior
<!-- greptile_comment -->
<h2>Greptile Overview</h2>
<h3>Greptile Summary</h3>
This PR updates the Discord skill documentation (`skills/discord/SKILL.md`) by adding a note in the message search section clarifying that Discord search does not support boolean operators like `OR`/`AND` and that queries are matched literally; it recommends issuing separate searches for multiple terms. This fits into the repo’s skill docs as guidance to reduce common agent/user misuse of `searchMessages` queries.
<h3>Confidence Score: 5/5</h3>
- This PR is safe to merge with minimal risk.
- Documentation-only change localized to the Discord skill docs; no code paths or tooling behavior are modified, and the added note is consistent with the described Discord search limitation.
- No files require special attention
<!-- greptile_other_comments_section -->
**Context used:**
- Context from `dashboard` - CLAUDE.md ([source](https://app.greptile.com/review/custom-context?memory=fd949e91-5c3a-4ab5-90a1-cbe184fd6ce8))
- Context from `dashboard` - AGENTS.md ([source](https://app.greptile.com/review/custom-context?memory=0d0c8278-ef8e-4d6c-ab21-f5527e322f13))
<!-- /greptile_comment -->
Most Similar PRs
#12808: docs(subagents): clarify allowAgents is per-agent only
by JBrady · 2026-02-09
69.5%
#12818: docs(messages): clarify message tool ordering vs inline replies
by JBrady · 2026-02-09
69.1%
#18134: feat(discord): add semantic search tool for Discord messages
by zerone0x · 2026-02-16
66.7%
#8873: fix: document skill loading locations in system prompt
by ytfh44 · 2026-02-04
66.5%
#15803: fix(skills/github): add GraphQL introspection guidance
by rixau · 2026-02-13
66.4%
#4767: fix(agents): handle read alias required schema
by RomeroYang · 2026-01-30
65.7%
#7656: docs(slack): improve skill documentation with thread support and AP...
by pswpswpsw · 2026-02-03
65.6%
#19658: feat(skills): add overlap-check — search before filing issues or PRs
by SeMmyT · 2026-02-18
65.6%
#13594: fix(skills): correct apple-notes SKILL.md memo -a syntax
by lailoo · 2026-02-10
65.6%
#8361: docs: Add subagent configuration and allowlist guide
by soilgrowerx · 2026-02-03
65.4%