{
  "practice": {
    "id": "prc_avoid_jargon_unclear_abbrev",
    "title": "Avoid unexplained jargon or abbreviations in descriptions",
    "category": "clarity",
    "description": "A tool description is read by the model with no additional context beyond what is written -- internal codenames, uncommon abbreviations, or jargon specific to one team should be spelled out or avoided, the same way a new team member would need it explained.",
    "example_good": "\"CSL (Citation Style Language) JSON\" spelled out on first use.",
    "example_bad": "\"Returns CSL data.\" with no expansion anywhere in the tool description or schema.",
    "source_note": "General clarity best practice, consistent with this repo's own style-citations skill spelling out CSL on first use.",
    "created_at": "2026-07-02 08:28:30",
    "cite_as": "https://subagentdescriptions.com/api/practices/prc_avoid_jargon_unclear_abbrev"
  }
}