{
  "practices": [
    {
      "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"
    }
  ]
}