{
  "schema_version": 2,
  "kind": "shortening-method",
  "format": "agent-skill",
  "id": "diff-summary",
  "name": "Diff summary",
  "category": "Technical",
  "summary": "Describe a diff with a commit-style title and short change bullets.",
  "use_cases": [
    "Commit messages",
    "Code review",
    "Change summaries"
  ],
  "word_count": 115,
  "url": "https://sho.rten.it/methods/diff-summary/",
  "instructions_url": "https://sho.rten.it/methods/diff-summary/SKILL.md",
  "skill_url": "https://sho.rten.it/methods/diff-summary/SKILL.md",
  "json_url": "https://sho.rten.it/methods/diff-summary/llms.txt",
  "plain_text_url": "https://sho.rten.it/methods/diff-summary/prompt.txt",
  "license": "MIT",
  "sources_url": "https://sho.rten.it/sources/#diff-summary",
  "skill_name": "diff-summary",
  "skill_description": "Describe a diff with a commit-style title and short change bullets. Use for Commit messages, Code review, Change summaries.",
  "agents_md_url": "https://sho.rten.it/methods/diff-summary/AGENTS.md",
  "sources": [
    {
      "title": "Fabric · summarize_git_diff",
      "url": "https://github.com/danielmiessler/Fabric/blob/b682dad740f24e85ce9a48d23babc6780dd476ac/data/patterns/summarize_git_diff/system.md",
      "repository": "https://github.com/danielmiessler/Fabric",
      "revision": "b682dad740f24e85ce9a48d23babc6780dd476ac",
      "path": "data/patterns/summarize_git_diff/system.md",
      "license": "MIT",
      "license_url": "https://github.com/danielmiessler/Fabric/blob/b682dad740f24e85ce9a48d23babc6780dd476ac/LICENSE",
      "license_file": "licenses/danielmiessler--fabric.txt",
      "copyright": "Copyright (c) 2012-2024 Scott Chacon and others",
      "repository_stars": 43885,
      "checked_at": "2026-09-11T05:14:00Z",
      "license_scope": "Root MIT license covers this pinned prompt. No nested license or NOTICE applies.",
      "adaptation": "Retains the 100-character conventional-commit title, imperative mood, and short CHANGES bullets. Drops unnecessary HTML-link formatting and dependence on an external commit guide; adds evidence limits."
    }
  ],
  "instructions": "Read the supplied Git diff and describe its main changes in human-readable Markdown.\n\nStart with an imperative title of at most 100 characters. Use an appropriate conventional commit prefix: build, chore, ci, docs, feat, fix, perf, refactor, revert, style, or test.\n\nThen add a CHANGES section with a few concise bullets, usually seven to ten words each. Describe the resulting behavior in imperative present tense, such as \"Reject empty input before sending the request.\"\n\nPrioritize meaningful changes over line-by-line narration. Preserve important identifiers exactly. Explain relevant context in the text rather than relying on outside links. Do not claim tests passed, a bug was reproduced, or a change was deployed unless the input establishes it.",
  "example": {
    "context": "Supplied Git diff and review context; no execution results",
    "before": "This diff changes saveNote so whitespace-only input returns false before storage is called. Nonempty input still reaches storage.write unchanged. The added test covers the new guard; no test execution results accompany the diff.\n\ndiff --git a/src/notes.ts b/src/notes.ts\n@@\n export async function saveNote(body) {\n+  if (body.trim() === \"\") return false;\n   await storage.write(body);\n   return true;\n }\n\ndiff --git a/tests/notes.test.ts b/tests/notes.test.ts\n@@\n+it(\"rejects whitespace-only notes\", async () => {\n+  expect(await saveNote(\"   \")).toBe(false);\n+  expect(storage.write).not.toHaveBeenCalled();\n+});",
    "after": "fix: reject whitespace-only notes before storage\n\nCHANGES\n- Return false from saveNote for whitespace-only input before storage.write.\n- Store nonempty note bodies unchanged through storage.write.\n- Add a test for false return and skipped storage.",
    "must_preserve": [
      "Imperative conventional title under 100 characters",
      "CHANGES section with concise bullets",
      "Whitespace-only input returns false before storage.write",
      "Nonempty input unchanged",
      "Test added for false return and no write",
      "No claim that the added test passed"
    ],
    "omitted": [
      "Summarizes the behavior and coverage instead of repeating diff scaffolding; makes no execution claim."
    ],
    "kind": "illustrative"
  }
}