Update to Matt Skills Curated

{
  "description": "Compact current conversation context, decisions, evidence, and next actions into a portable markdown handoff for a fresh agent session. Use when ending a session, transferring work to another agent, switching workspaces, or preparing a resume point — even if the user just says \"save progress\". Do NOT use for committing code to git or creating branch PRs.",
  "included_files": [
    {
      "relative_path": "agents/openai.yaml",
      "size_in_bytes": 98
    }
  ],
  "name": "handoff",
  "skill_md_contents": "---\nname: handoff\ndescription: \"Compact current conversation context, decisions, evidence, and next actions into a portable markdown handoff for a fresh agent session. Use when ending a session, transferring work to another agent, switching workspaces, or preparing a resume point — even if the user just says \\\"save progress\\\". Do NOT use for committing code to git or creating branch PRs.\"\n---\n\n# Handoff\n\nCompact complex conversational history, locked architectural decisions, unblocked next actions, and verification evidence into a self-contained markdown handoff document for a fresh agent session.\n\n---\n\n## Core Invariants\n\n1. **External Temp Storage**: Save handoff documents to the OS temporary directory (`/tmp/handoff-<timestamp>.md`) or designated scratch folder—never pollute the project root repository files.\n2. **Context Pointer Economy**: Point directly to repository artifacts, issue URLs, commit SHAs, and test suites rather than duplicating walls of text.\n3. **Suggested Skills Routing**: Explicitly declare the `## Suggested Skills` block indicating which specialized skills the resuming agent should invoke first.\n4. **Strict Secret Redaction**: Ensure zero credentials, tokens, API keys, or private auth headers are leaked into the handoff file.\n5. **Exact Next Command**: Provide the exact command line or next prompt required to continue execution without ambiguity.\n\n---\n\n## Architecture & Map of Content (MOC)\n\n```\n[ Active Multi-Turn Session ] ──► [ Extract Invariants, Decisions & Blockers ] ──► [ Write `/tmp/handoff-*.md` ] ──► [ Output Resume Command ]\n```\n\n| Section | Purpose | Example Content |\n|---|---|---|\n| **Goal & Scope** | What this initiative accomplishes | Spec boundary, user requirements |\n| **Decisions & Invariants** | Hard architectural contracts settled | Domain model choices, ADR pointers |\n| **Current State & Diff** | Exact working tree status | Git status, modified files, passing tests |\n| **Suggested Skills** | Tools the next session needs | `[skills/implement-spec/SKILL.md](file:///...)` |\n| **Exact Next Action** | Atomic next step | Command or task frontier claim |\n\n---\n\n## Step-by-Step Procedure (TWI)\n\n### Step 1: Synthesize Session Delta & Decisions\n- **Action**: Extract the critical path decisions settled, active files modified, and outstanding questions.\n- **Key Point**: Check that all decisions link to their primary ADRs or specs.\n- **Why**: Resuming agents need the \"why\" behind choices without re-litigating settled discussions.\n\n### Step 2: Format Handoff Document & Redact Secrets\n- **Action**: Structure the markdown document with Goal, Completed Work, Active Blockers, Suggested Skills, and Next Actions.\n- **Key Point**: Scan the text to ensure no private tokens or environment secrets are included.\n- **Inline Checklist**:\n  - [ ] Saved in `/tmp/` (e.g. `/tmp/handoff-2026-08-30.md`)\n  - [ ] Suggested skills explicitly listed\n  - [ ] Zero secrets present\n\n### Step 3: Emit Resume Instructions\n- **Action**: Output a clean completion summary to the user with the exact path to the handoff file and how the next agent can ingest it.\n- **Why**: Allows instant session resumption without context loss.\n\n---\n\n## Anti-Rationalization Guardrails\n\n| Tempting Rationalization | Binding Rule | Engineering Rationale |\n|---|---|---|\n| *\"Write the handoff directly into the project repository root.\"* | **Save handoffs to `/tmp/` or temporary OS directory.** | Ephemeral session dumps pollute git history and clutter repo source trees. |\n| *\"Paste full file contents into the handoff document.\"* | **Use concise context pointers and file paths.** | Pasting entire files consumes context budget on the resuming agent session. |\n| *\"Omit suggested skills and let the next agent guess.\"* | **Mandatory 'Suggested Skills' section.** | Direct skill guidance prevents the resuming agent from drifting into generic workflows. |\n\n"
}