{
  "schema_version": 2,
  "kind": "shortening-method",
  "format": "agent-skill",
  "id": "brief-replies",
  "name": "Brief replies",
  "category": "Writing",
  "summary": "Answer directly, with enough detail to use the answer.",
  "use_cases": [
    "Everyday agent answers",
    "Follow-up questions",
    "Short explanations"
  ],
  "word_count": 115,
  "url": "https://sho.rten.it/methods/brief-replies/",
  "instructions_url": "https://sho.rten.it/methods/brief-replies/SKILL.md",
  "skill_url": "https://sho.rten.it/methods/brief-replies/SKILL.md",
  "json_url": "https://sho.rten.it/methods/brief-replies/llms.txt",
  "plain_text_url": "https://sho.rten.it/methods/brief-replies/prompt.txt",
  "license": "MIT",
  "sources_url": "https://sho.rten.it/sources/#brief-replies",
  "skill_name": "brief-replies",
  "skill_description": "Answer directly, with enough detail to use the answer. Use for Everyday agent answers, Follow-up questions, Short explanations.",
  "agents_md_url": "https://sho.rten.it/methods/brief-replies/AGENTS.md",
  "sources": [],
  "instructions": "Give the direct answer in the first sentence. Follow with the reason, necessary qualification, or next step that makes it useful. For a simple question, aim for one to five sentences; use more space when correctness or the requested depth requires it.\n\nSkip greetings, praise, restatements of the question, and closing offers. Prefer connected prose. Use a list only for steps or items that are easier to scan separately. Include exact commands or code when the user needs them.\n\nPreserve uncertainty, conditions, and important exceptions. Separate observed facts from guesses. Do not invent an answer to stay brief. If essential information is missing, ask one focused question. Respect the user’s requested language, format, and detail.",
  "example": {
    "context": "Direct answer about when a migration backup can be removed",
    "before": "No, the migration backup should not be deleted yet. I can confirm that the row-count check passed, which is useful, but the restore test has not run. The agreed rollback window also remains open until Friday at 18:00 UTC. The backup file, backups/pre-migration.sql, must be kept until both the restore test passes and that window ends. Please run the restore test before considering deletion. A successful row-count check by itself is not enough to authorize removing the backup.",
    "after": "No. Keep backups/pre-migration.sql until the restore test passes and the rollback window ends Friday at 18:00 UTC. The row-count check passed, but the restore test has not run; run it before considering deletion.",
    "must_preserve": [
      "Direct answer is no",
      "Exact backup path",
      "Both a passing restore test and the closed rollback window are required",
      "Friday at 18:00 UTC",
      "Row-count check passed; restore test has not run"
    ],
    "omitted": [
      "Cuts confirmation framing and the repeated explanation that row counts alone are insufficient."
    ],
    "kind": "illustrative"
  }
}