Update to Matt Skills Curated

{
  "description": "Shape raw notes, transcript fragments, and research into a structured, coherent article draft. Use when assembling collected fragments into narrative sections, establishing flow, and building a draft block by block — even if the user says \"turn these notes into a draft\". Do NOT use for initial fragment generation.",
  "included_files": [
    {
      "relative_path": "agents/openai.yaml",
      "size_in_bytes": 101
    }
  ],
  "name": "writing-shape",
  "skill_md_contents": "---\nname: writing-shape\ndescription: \"Shape raw notes, transcript fragments, and research into a structured, coherent article draft. Use when assembling collected fragments into narrative sections, establishing flow, and building a draft block by block — even if the user says \\\"turn these notes into a draft\\\". Do NOT use for initial fragment generation.\"\n---\n\n# Writing Shape\n\nMine raw notes, transcript fragments, and research piles into a structured, coherent article draft by enforcing concept grounding, candidate opening hooks, and deliberate block-level formatting.\n\n---\n\n## Core Invariants\n\n1. **Input Immutability**: The raw material file is strictly read-only; shape the article into a new separate document.\n2. **Strict Concept Grounding**: Every concept must be grounded (either as a predefined reader prerequisite or introduced in an earlier block) before any subsequent paragraph leans on it.\n3. **Multi-Opening Selection**: Always present 2–3 distinct opening hooks representing different angles/theses before building the body.\n4. **Deliberate Block Formatting**: Formally justify the format of every block (prose vs. list, callout vs. inline, table vs. text, quote vs. paraphrase).\n5. **Incremental Persistence**: Append and refine the article draft file paragraph-by-paragraph with live disk re-reads before every write.\n\n---\n\n## Architecture & Map of Content (MOC)\n\n```\n[ Raw Notes / Fragment Pile (Read-Only) ] ──► [ Establish Reader Prerequisites ] ──► [ Select Opening Hook (2-3 Options) ] ──► [ Block-by-Block Construction ]\n```\n\n| Decision Area | Tradeoff Analysis | Rule |\n|---|---|---|\n| **Prose vs. List** | Argumentative flow vs. scannable items | Prose carries thesis; lists carry strictly parallel items |\n| **Inline vs. Callout** | Mainline continuity vs. aside context | Use callouts (`> [!NOTE]`) only if inline disrupts thesis |\n| **Table vs. Paragraphs** | Repetitive structured schemas | 3+ items with matching keys $\\rightarrow$ Table |\n| **Quote vs. Paraphrase** | Historical phrasing vs. core idea | Quote when exact words matter; paraphrase for clarity |\n\n---\n\n## Step-by-Step Procedure (TWI)\n\n### Step 1: Ingest Pile & Settle Prerequisites\n- **Action**: Read the raw fragment pile end-to-end and establish what foundational knowledge the reader brings to the article.\n- **Key Point**: Keep a live register of grounded concepts throughout the session.\n- **Why**: Prevents cognitive gaps where articles lean on unintroduced jargon.\n\n### Step 2: Draft 2–3 Candidate Openings\n- **Action**: Present 2–3 distinct openings with different angles and force a selection.\n- **Key Point**: The chosen opening sets the explicit contract for the rest of the draft.\n- **Inline Checklist**:\n  - [ ] Raw pile untouched\n  - [ ] Prerequisites recorded\n  - [ ] Opening agreed and written to target draft file\n\n### Step 3: Grow Draft Paragraph-by-Paragraph\n- **Action**: Ask \"Given this block, what does the reader need next?\", pull material from the pile, and debate the block format.\n- **Key Point**: Re-read file before writing and append immediately.\n- **Why**: Step-by-step composition ensures seamless transitions and eliminates fluff.\n\n---\n\n## Anti-Rationalization Guardrails\n\n| Tempting Rationalization | Binding Rule | Engineering Rationale |\n|---|---|---|\n| *\"Generate the entire article all at once in one big turn.\"* | **Draft and debate block by block with the user.** | Single-shot generation produces generic prose and ignores user tone preferences. |\n| *\"Edit the raw notes file directly during shaping.\"* | **Raw material is read-only; write to a separate draft.** | Altering the source pile destroys raw fragments needed for future articles. |\n| *\"Use jargon before introducing the underlying concept.\"* | **Enforce prerequisite grounding before leaning on terms.** | Ungrounded concepts alienate readers and weaken argumentative structure. |\n\n"
}