{
  "practice": {
    "id": "prc_examples_in_description",
    "title": "Include example usage directly in the description",
    "category": "examples",
    "description": "Concrete input/output examples embedded in a tool's description reduce ambiguity far more efficiently than more prose -- showing the model one or two realistic calls (and, where useful, one call that should NOT be made) often resolves edge cases prose alone leaves open.",
    "example_good": "\"Example: get_stock_price(ticker_symbol=\"\"AAPL\"\") returns the latest closing price in USD.\"",
    "example_bad": "A tool description that only states the parameter types with no example call shown.",
    "source_note": "General tool-description best practice; mirrors how this repo's own real skill descriptions (see subagentskills.com) fold trigger-phrase examples directly into the description field, not a separate doc.",
    "created_at": "2026-07-02 08:28:30",
    "cite_as": "https://subagentdescriptions.com/api/practices/prc_examples_in_description"
  }
}