swarm-zap/skills/llm-tool-best-practices/hints/generic.md

MODEL_HINTS.md — General Tool Best Practices

Active model family: Unknown (no specific hints available for this model)

Applying universal best practices. For model-specific guidance, see:

• skills/llm-tool-best-practices/hints/anthropic.md (Claude)
• skills/llm-tool-best-practices/hints/openai.md (GPT)

Universal rules

• Write detailed descriptions (3–4+ sentences per tool): purpose, when to use/not use, params, output, caveats.
• Fewer, richer tools beat many narrow ones. Consolidate related operations.
• Use service_resource_verb namespacing for clarity.
• Return only high-signal data. Strip opaque IDs, raw stack traces, bloat.
• Bound response sizes; make truncation messages actionable.
• Least privilege. Validate all inputs. Guard destructive actions.