{
  "practice": {
    "id": "prc_extremely_detailed",
    "title": "Write extremely detailed, unambiguous descriptions",
    "category": "clarity",
    "description": "A tool description should explain exactly what the tool does, what each parameter means, what the tool returns, and any important caveats -- err on the side of more detail rather than less, since the model has no other context about the tool beyond its name, description, and schema.",
    "example_good": "\"Get the current weather in a given location. Returns temperature in the unit specified. If no unit is given, defaults to the location's local convention (Celsius outside the US, Fahrenheit within it).\"",
    "example_bad": "\"Gets weather.\"",
    "source_note": "Anthropic's published tool-use / function-calling guidance on writing clear, complete tool descriptions.",
    "created_at": "2026-07-02 08:28:30",
    "cite_as": "https://subagentdescriptions.com/api/practices/prc_extremely_detailed"
  }
}