{
  "schema_version": 2,
  "kind": "shortening-method",
  "format": "agent-skill",
  "id": "glossary-definition",
  "name": "Glossary definition",
  "category": "Writing",
  "summary": "Shorten a term explanation while keeping the distinction that defines it.",
  "use_cases": [
    "Product glossaries",
    "Terminology lists",
    "Short domain definitions"
  ],
  "word_count": 142,
  "url": "https://sho.rten.it/methods/glossary-definition/",
  "instructions_url": "https://sho.rten.it/methods/glossary-definition/SKILL.md",
  "skill_url": "https://sho.rten.it/methods/glossary-definition/SKILL.md",
  "json_url": "https://sho.rten.it/methods/glossary-definition/llms.txt",
  "plain_text_url": "https://sho.rten.it/methods/glossary-definition/prompt.txt",
  "license": "MIT",
  "sources_url": "https://sho.rten.it/sources/#glossary-definition",
  "skill_name": "glossary-definition",
  "skill_description": "Shorten a term explanation while keeping the distinction that defines it. Use for Product glossaries, Terminology lists, Short domain definitions.",
  "agents_md_url": "https://sho.rten.it/methods/glossary-definition/AGENTS.md",
  "sources": [],
  "instructions": "Condense the supplied explanation into a glossary entry for the stated domain. Begin with the term, then identify what kind of thing it is and the feature that distinguishes it from related concepts. Use the meaning supported by the source rather than a broader dictionary meaning.\n\nKeep a necessary scope restriction, contrast, unit, or exception. Include one short example only if the definition would otherwise be difficult to understand. Define an unfamiliar supporting term briefly or use an accurate familiar alternative. Avoid circular definitions that repeat the term without explaining it.\n\nRemove history, repeated synonyms, sales language, and examples that do not change understanding. Do not add a formal threshold, guarantee, acronym expansion, or technical equivalence absent from the source. Preserve uncertainty where the source gives a provisional definition. Prefer one or two sentences. Return only the glossary entry, without an introduction.",
  "example": {
    "context": "Monitoring glossary entry",
    "before": "In this monitoring guide, a false positive is an alert that says a fault is present when there is no fault. It is different from a false negative, which misses a fault that is actually present. For example, a temperature sensor might raise an overheating alert because of a faulty reading even though the equipment temperature is normal. False positives can consume time because someone has to investigate them. The term here describes an incorrect positive alert, not every alert that turns out to be low priority.",
    "after": "False positive: an alert that incorrectly reports a fault when none is present. It is not merely a low-priority alert; a false negative instead misses a real fault.",
    "must_preserve": [
      "Alert reports a fault that is absent",
      "Different from a false negative",
      "Low priority alone does not mean false positive"
    ],
    "omitted": [
      "Cuts an illustrative sensor scenario and an operational consequence that do not define the term."
    ],
    "kind": "illustrative"
  }
}