Update to AI Review Skills

{
  "description": "Formatting rules for quoting external sources inside Markdown. Use fenced code blocks, pair original and translation, and place labeled source references after the fence. Use whenever writing or editing quotation blocks.",
  "included_files": [],
  "name": "writing-quotation",
  "skill_md_contents": "---\nname: writing-quotation\ndescription: Formatting rules for quoting external sources inside Markdown. Use fenced code blocks, pair original and translation, and place labeled source references after the fence. Use whenever writing or editing quotation blocks.\n---\n\n# Writing Quotation\n\nFormatting rules for quoting external sources inside a Markdown document. Other skills that produce sourced deliverables (`survey`, `paper-details`, and similar) reference this one.\n\n## 1. Why quote the original\n\nA summary alone does not let the reader judge whether the writer's reading of the source is correct. Placing the original alongside lets the reader cross-check the writer's interpretation against the source itself. Quotations and prose (the writer's own summary or interpretation) must stay visually and structurally distinct.\n\n## 2. Quotations always go inside code blocks\n\nQuote external sources inside a fenced code block, regardless of content type — prose, prompt templates, code, XML-tagged text, anything. Do not use the blockquote syntax (`>`).\n\n## 3. Structure of a quotation block\n\nA quotation block has the following shape.\n\n- Opening code fence\n- Original text\n- One blank line\n- Translation into the writer's working language (only when the source is in a different language)\n- Closing code fence\n- The source reference `[label (YYYY/MM), location]` on the line immediately after the closing fence\n\nRules:\n\n- Original and translation sit together inside the same code block.\n- One blank line separates them.\n- Do not insert a horizontal rule (`---`) between original and translation.\n- Do not move the translation outside the code block. Do not put it in parentheses next to the original.\n- The source reference belongs on the line after the closing fence as an independent line. Never inside the code block.\n\n## 4. Examples\n\n### 4.1 Same-language quotation\n\nWhen the source and the writer share a working language, no translation is needed:\n\n```\nComposability is the property by which a system's behaviour is determined by the behaviour of its parts and the rules under which they are combined.\n```\n\n[example-handbook (2026/04), Section 2.1]\n\n### 4.2 Cross-language quotation\n\nWhen the source is in a language other than the writer's working language, place the translation as a separate paragraph inside the same code block:\n\n```\nLe sens d'une expression complexe est déterminé par le sens de ses constituants et par les règles qui les combinent.\n\nThe meaning of a complex expression is determined by the meaning of its constituents and the rules that combine them.\n```\n\n[example-handbook (2026/04), Section 2.1]\n\n### 4.3 Prompt-template quotation\n\nPrompt templates use the same rule. Wrap inside a code block; place the source reference after the fence.\n\n```\nHuman: You are an assistant who summarises research papers. The paper is enclosed in <paper> tags. Produce a summary enclosed in <summary> tags. <paper>P</paper> Assistant:\n```\n\n[example-prompt-library (2026/04), template 03]\n\n### 4.4 Short-form role markers in translations\n\nWhen translating a prompt template (Human/Assistant style), the translation side may abbreviate role markers to reduce cognitive load and to make it easier to tell original from translation at a glance.\n\n- `Human:` → `H:`\n- `Assistant:` → `A:`\n\nKeep the original side unabbreviated (`Human:` / `Assistant:` in full). The trailing `Assistant:` at the very end of a chat template (the position that signals where the response begins) carries structural meaning and may be left as `Assistant:` on the translation side as well.\n\n## 5. Source-reference format\n\nFormat: `[label (YYYY/MM), location]`.\n\n- `label`: an identifier for the source. The calling skill decides the convention (author short-form, publication name, etc.).\n- `(YYYY/MM)`: year and month. Do not include the day. If only the year is known, use `(YYYY)`.\n- `location`: where in the source the cited passage lives (`p.4`, `Section 3.1`, `Figure 2`, `(15)`, `opening`, `final paragraph`, etc.). Omit when it cannot be pinned down.\n\nIf there is no location, write `[label (YYYY/MM)]`.\n\n### 5.1 No bare numeric references\n\nDo not use bare numeric references like `[1]` or `[2]`. The reader has to bounce between text and bibliography to learn what each number means. Use a label-based form that identifies the subject directly inside the text.\n\n## 6. Anti-patterns\n\nAnti-pattern 1 — using blockquote syntax (`>`):\n\nA line starting with `>` is not acceptable for an external quotation. Always wrap inside a code block (see Section 2).\n\nAnti-pattern 2 — translation outside the code block:\n\n```\nComposability is the property by which ...\n```\n\nThe translation appears here as prose, outside the code block. [example-handbook (2026/04), Section 2.1]\n\nFix: place original and translation inside the same code block, separated by one blank line.\n\nAnti-pattern 3 — translation in parentheses next to the original:\n\n```\nComposability is the property by which ... (Inline translation in parentheses ...)\n```\n\n[example-handbook (2026/04), Section 2.1]\n\nFix: original and translation are independent paragraphs inside the same code block, separated by one blank line.\n\nAnti-pattern 4 — source reference inside the code block:\n\n```\nComposability is the property by which ...\n\nTranslation here ...\n[example-handbook (2026/04), Section 2.1]\n```\n\nFix: the source reference goes on the line after the closing fence as an independent line.\n\nAnti-pattern 5 — bare numeric source reference:\n\n```\nComposability is the property by which ...\n\nTranslation here ...\n```\n\n[1]\n\nFix: use a label that identifies the source directly (author short-form or publication name).\n\nAnti-pattern 6 — horizontal rule between original and translation:\n\n```\nComposability is the property by which ...\n---\nTranslation here ...\n```\n\n[example-handbook (2026/04), Section 2.1]\n\nFix: separate original and translation with one blank line. No horizontal rule.\n\n## 7. Scope\n\nThis skill defines the format of quotations only. *When* to quote (Assertion-Evidence ordering, what label to use, etc.) is decided by the calling skill.\n\n- `survey`: Assertion-Evidence ordering — state the claim in prose first, then back it up with a quotation. The `label` slot holds the publication or source name.\n- `paper-details`: References to the paper under review omit the author and use position only (`[p.X, Section Y.Z]`). References to other works use `[author-short (YYYY/MM)]`.\n"
}