{
  "schema_version": 2,
  "kind": "shortening-method",
  "format": "agent-skill",
  "id": "error-message",
  "name": "Error message",
  "category": "Technical",
  "summary": "Shorten a product error while keeping its cause, consequence, and recovery.",
  "use_cases": [
    "Validation messages",
    "Import and upload errors"
  ],
  "word_count": 146,
  "url": "https://sho.rten.it/methods/error-message/",
  "instructions_url": "https://sho.rten.it/methods/error-message/SKILL.md",
  "skill_url": "https://sho.rten.it/methods/error-message/SKILL.md",
  "json_url": "https://sho.rten.it/methods/error-message/llms.txt",
  "plain_text_url": "https://sho.rten.it/methods/error-message/prompt.txt",
  "license": "MIT",
  "sources_url": "https://sho.rten.it/sources/#error-message",
  "skill_name": "error-message",
  "skill_description": "Shorten a product error while keeping its cause, consequence, and recovery. Use for Validation messages, Import and upload errors.",
  "agents_md_url": "https://sho.rten.it/methods/error-message/AGENTS.md",
  "sources": [],
  "instructions": "Rewrite the supplied user-facing error as the shortest useful message. This is for a single failed operation, not a bug report or an incident update.\n\nStart with what failed. State the known reason in terms the intended user can act on. Follow with one supplied recovery step, if there is one. Retain any consequence the user needs to know, such as whether changes were saved, a payment was made, or an operation can safely be retried.\n\nRemove apologies, blame, internal narration, and repeated instructions. Keep exact limits, file formats, field names, and error codes when they help recovery or support. Do not expose extra implementation details. Do not replace a specific diagnosis with a generic failure.\n\nReturn only the message. Use one or two short sentences where possible. Preserve uncertainty, and never invent a cause, a retry guarantee, or an action the product does not support.",
  "example": {
    "context": "CSV import validation",
    "before": "Unfortunately, we were unable to complete the import of the records in the file you selected. The CSV file uses UTF-16 encoding, but this importer only accepts CSV files that use UTF-8 encoding. Please save the file again using UTF-8 encoding and then upload that file. No records from this file have been added to your account.",
    "after": "Import failed: this CSV uses UTF-16. Save it as UTF-8 and upload it again. No records were added.",
    "must_preserve": [
      "Import failed because CSV is UTF-16",
      "Importer requires UTF-8",
      "Save as UTF-8 and upload again",
      "No records were added"
    ],
    "kind": "illustrative",
    "omitted": [
      "Apologetic wording and repeated references to the selected file and encoding."
    ]
  }
}