[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M74F9G3W1ANPSBB844APRYJM":3,"skill-same:01M74F9G3W1ANPSBB844APRYJM":48},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":24,"commitSha":25,"skillDirectory":26,"forksCount":27,"repositoryHtmlUrl":28,"repositoryHomepageUrl":29,"ownerHtmlUrl":30,"ownerBlogUrl":31,"ownerDescription":32,"updatedAt":33,"install":34,"resources":47},"01M74F9G3W1ANPSBB844APRYJM","handoff",null,"Prepare a clean cross-session handoff so the next agent can pick up where you left off. Saves a focused Work Checkpoint with `gsd_checkpoint_save` and ensures summary artifacts are current. Use when asked to \"hand off\", \"prepare handoff\", \"pause work\", \"bookmark this\", \"I'll come back to this later\", before running out of context budget, or ending a long session with unfinished work.","open-gsd\u002Fgsd-pi","open-gsd","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F286935422?v=4","01M74F5F0MKW0B81YZHRVJMMWR","Open GSD","01M74F5F1782D325EYEM5GNXNC",1369,"MIT","https:\u002F\u002Fgithub.com\u002Fopen-gsd\u002Fgsd-pi\u002Fblob\u002Fmain\u002Fsrc\u002Fresources\u002Fskills\u002Fhandoff\u002FSKILL.md",[],[],"2026-11-11 15:11:14",false,"---\nname: handoff\ndescription: Prepare a clean cross-session handoff so the next agent can pick up where you left off. Saves a focused Work Checkpoint with `gsd_checkpoint_save` and ensures summary artifacts are current. Use when asked to \"hand off\", \"prepare handoff\", \"pause work\", \"bookmark this\", \"I'll come back to this later\", before running out of context budget, or ending a long session with unfinished work.\n---\n\n\u003Cobjective>\nLeave the project in a state where a fresh agent with no memory of this session can be productive within one minute. The deliverable is a Work Checkpoint saved with `gsd_checkpoint_save` plus up-to-date summary artifacts — not a chat recap.\n\u003C\u002Fobjective>\n\n\u003Ccontext>\nGSD already renders `STATE.md` (from the database, after every lifecycle tool call) and summary files (`M###-SUMMARY.md`, `S##-SUMMARY.md`, `T##-SUMMARY.md`). The gap is the *mid-task* handoff: you're partway through a task, context is getting long, and the next session shouldn't start by re-deriving your mental state.\n\nThe Work Checkpoint exists for exactly this. It is a database row. The next session of the task gets it as the \"Resume State\" section of its prompt, and `\u002Fgsd` offers \"Resume\" instead of \"Execute\" for a task that has one. `CONTINUE.md` in the slice directory is rendered from the row for people to read; it is never read back. Do not write `continue.md`, `CONTINUE.md` or `HANDOFF.md` yourself.\n\nInvocation points:\n\n- User says \"pause\", \"hand off\", \"I'll come back later\", \"this is a good stopping point\"\n- Context usage nearing budget — better to hand off cleanly than truncate mid-thought\n- Before a risky operation (dependency upgrade, major refactor) where you want a known-good checkpoint\n- End of a long session, multi-day work\n\u003C\u002Fcontext>\n\n\u003Ccore_principle>\n**WRITE FOR A STRANGER.** The next reader is not you. They do not have this conversation. They have the project snapshot (`gsd_project_snapshot`), the checkpoint, the last summary, and the code. That has to be enough.\n\n**CURRENT STATE ONLY.** The checkpoint says \"pick up HERE.\" It is not a log of what you did; that goes in summaries. It is not a plan for future work; that lives in the plan files.\n\n**NO SECRETS, NO STALE PATHS.** Do not inline env values, tokens, or paths that only exist in your working directory. Cite artifacts by relative path from the project root.\n\u003C\u002Fcore_principle>\n\n\u003Cprocess>\n\n## Step 1: Identify what's in flight\n\nAnswer briefly:\n\n1. What task (`T##`) am I on? What's its current plan file?\n2. What have I completed since the last summary?\n3. What's the next concrete action? (Not a goal — an action: \"Run X. If Y, do Z.\")\n4. What, if anything, is blocking or uncertain?\n\n## Step 2: Update the summaries, not the handoff\n\nBefore saving the checkpoint:\n\n- **Any task that's actually done?** Use `gsd_task_complete` (or the equivalent tool) to toggle state. Do NOT edit checkboxes by hand. This triggers `STATE.md` rebuild and `T##-SUMMARY.md` generation.\n- **Any slice-level decisions worth preserving?** Save them with `gsd_decision_save`.\n- **Any patterns or traps future agents should know about?** Record each one with `capture_thought`.\n\nThis shrinks what the checkpoint has to carry.\n\n## Step 3: Save the checkpoint\n\nCall `gsd_checkpoint_save` with the fields below. Keep it tight — one screenful max.\n\n- `milestoneId`, `sliceId`, `taskId` — the unit in flight. Pass `taskId` when a task is in progress; without it the next session of the task does not get the checkpoint.\n- `kind` — `handoff`.\n- `confirmedContext` — the last action, with evidence, and why the next step follows.\n  Example: \"Ran `npm test` after editing `src\u002Fauth\u002Fsession.ts`; 2 failures in `session.test.ts` — both complain about a missing `expiresAt` field in the mock fixture. The session refactor moved `expiresAt` from optional to required in `Session`; fixtures were never updated.\"\n- `nextAction` — one concrete action the next agent should take.\n  Example: \"Update `fixtures\u002Fsessions.ts` to include `expiresAt: Date.now() + 3600_000` on every fixture, then re-run `npm test`.\"\n- `unresolved` — open threads you noticed but deliberately didn't act on, and traps the next agent might stumble into.\n  Example: \"Validator in `src\u002Fauth\u002Fvalidator.ts` still accepts unbounded session lengths — file as a separate issue after T03 lands. Do NOT revert the `Session` interface change — it's required for T04. Do NOT run `npm run db:reset` in this branch; dev data is still needed for manual UAT.\"\n- `evidence` — optional: commands, files and results that support the confirmed context. List modified, uncommitted files here.\n\n## Step 4: Sanity check\n\nCall `gsd_project_snapshot`, then read the checkpoint you saved + the most recent summary as if you were a fresh agent. Ask:\n\n1. Do I know what to do next?\n2. Do I know why?\n3. Do I know what not to do?\n\nIf any answer is no, the handoff is incomplete. Save a new checkpoint; the newest one is the resume state.\n\n## Step 5: Stop cleanly\n\n- Do not leave in-flight `async_bash` or `bg_shell` jobs. Cancel or wait for them.\n- Do not leave uncommitted changes without flagging them in the checkpoint — note which files are modified and why.\n- Do not push mid-task commits to remote unless that was the plan — they create noise for reviewers.\n\n\u003C\u002Fprocess>\n\n\u003Canti_patterns>\n\n- **Chat-log handoffs.** \"First I did X, then Y, then Z…\" The next agent doesn't need the journey.\n- **A checkpoint that summarizes the whole slice.** That's what `S##-SUMMARY.md` is for, at slice completion.\n- **No `nextAction`.** A handoff without a concrete next action is a journal entry.\n- **Implicit assumptions.** \"Obviously the next thing is…\" — write it down.\n- **Leaving background processes running.** They'll be orphaned when the session ends.\n- **Handoff without updating summaries.** The checkpoint should be thin because the summaries carry the weight.\n- **Writing `continue.md` or `HANDOFF.md` by hand.** Nothing reads those files; only the checkpoint row selects the resume path.\n\n\u003C\u002Fanti_patterns>\n\n\u003Csuccess_criteria>\n\n- [ ] `gsd_checkpoint_save` succeeded for the unit in flight.\n- [ ] The `nextAction` is concrete and executable without this session's context.\n- [ ] Completed tasks were marked done via `gsd_*` tools, not by hand-edited checkboxes.\n- [ ] Anything notable that was learned is saved with `capture_thought` or `gsd_decision_save`.\n- [ ] Background processes are not orphaned.\n- [ ] A cold-read of the project snapshot + the checkpoint + latest summary would produce the right next action.\n\n\u003C\u002Fsuccess_criteria>\n","\u003Cobjective>\nLeave the project in a state where a fresh agent with no memory of this session can be productive within one minute. The deliverable is a Work Checkpoint saved with `gsd_checkpoint_save` plus up-to-date summary artifacts — not a chat recap.\n\u003C\u002Fobjective>\n\n\u003Ccontext>\nGSD already renders `STATE.md` (from the database, after every lifecycle tool call) and summary files (`M###-SUMMARY.md`, `S##-SUMMARY.md`, `T##-SUMMARY.md`). The gap is the *mid-task* handoff: you're partway through a task, context is getting long, and the next session shouldn't start by re-deriving your mental state.\n\nThe Work Checkpoint exists for exactly this. It is a database row. The next session of the task gets it as the \"Resume State\" section of its prompt, and `\u002Fgsd` offers \"Resume\" instead of \"Execute\" for a task that has one. `CONTINUE.md` in the slice directory is rendered from the row for people to read; it is never read back. Do not write `continue.md`, `CONTINUE.md` or `HANDOFF.md` yourself.\n\nInvocation points:\n\n- User says \"pause\", \"hand off\", \"I'll come back later\", \"this is a good stopping point\"\n- Context usage nearing budget — better to hand off cleanly than truncate mid-thought\n- Before a risky operation (dependency upgrade, major refactor) where you want a known-good checkpoint\n- End of a long session, multi-day work\n\u003C\u002Fcontext>\n\n\u003Ccore_principle>\n**WRITE FOR A STRANGER.** The next reader is not you. They do not have this conversation. They have the project snapshot (`gsd_project_snapshot`), the checkpoint, the last summary, and the code. That has to be enough.\n\n**CURRENT STATE ONLY.** The checkpoint says \"pick up HERE.\" It is not a log of what you did; that goes in summaries. It is not a plan for future work; that lives in the plan files.\n\n**NO SECRETS, NO STALE PATHS.** Do not inline env values, tokens, or paths that only exist in your working directory. Cite artifacts by relative path from the project root.\n\u003C\u002Fcore_principle>\n\n\u003Cprocess>\n\n## Step 1: Identify what's in flight\n\nAnswer briefly:\n\n1. What task (`T##`) am I on? What's its current plan file?\n2. What have I completed since the last summary?\n3. What's the next concrete action? (Not a goal — an action: \"Run X. If Y, do Z.\")\n4. What, if anything, is blocking or uncertain?\n\n## Step 2: Update the summaries, not the handoff\n\nBefore saving the checkpoint:\n\n- **Any task that's actually done?** Use `gsd_task_complete` (or the equivalent tool) to toggle state. Do NOT edit checkboxes by hand. This triggers `STATE.md` rebuild and `T##-SUMMARY.md` generation.\n- **Any slice-level decisions worth preserving?** Save them with `gsd_decision_save`.\n- **Any patterns or traps future agents should know about?** Record each one with `capture_thought`.\n\nThis shrinks what the checkpoint has to carry.\n\n## Step 3: Save the checkpoint\n\nCall `gsd_checkpoint_save` with the fields below. Keep it tight — one screenful max.\n\n- `milestoneId`, `sliceId`, `taskId` — the unit in flight. Pass `taskId` when a task is in progress; without it the next session of the task does not get the checkpoint.\n- `kind` — `handoff`.\n- `confirmedContext` — the last action, with evidence, and why the next step follows.\n  Example: \"Ran `npm test` after editing `src\u002Fauth\u002Fsession.ts`; 2 failures in `session.test.ts` — both complain about a missing `expiresAt` field in the mock fixture. The session refactor moved `expiresAt` from optional to required in `Session`; fixtures were never updated.\"\n- `nextAction` — one concrete action the next agent should take.\n  Example: \"Update `fixtures\u002Fsessions.ts` to include `expiresAt: Date.now() + 3600_000` on every fixture, then re-run `npm test`.\"\n- `unresolved` — open threads you noticed but deliberately didn't act on, and traps the next agent might stumble into.\n  Example: \"Validator in `src\u002Fauth\u002Fvalidator.ts` still accepts unbounded session lengths — file as a separate issue after T03 lands. Do NOT revert the `Session` interface change — it's required for T04. Do NOT run `npm run db:reset` in this branch; dev data is still needed for manual UAT.\"\n- `evidence` — optional: commands, files and results that support the confirmed context. List modified, uncommitted files here.\n\n## Step 4: Sanity check\n\nCall `gsd_project_snapshot`, then read the checkpoint you saved + the most recent summary as if you were a fresh agent. Ask:\n\n1. Do I know what to do next?\n2. Do I know why?\n3. Do I know what not to do?\n\nIf any answer is no, the handoff is incomplete. Save a new checkpoint; the newest one is the resume state.\n\n## Step 5: Stop cleanly\n\n- Do not leave in-flight `async_bash` or `bg_shell` jobs. Cancel or wait for them.\n- Do not leave uncommitted changes without flagging them in the checkpoint — note which files are modified and why.\n- Do not push mid-task commits to remote unless that was the plan — they create noise for reviewers.\n\n\u003C\u002Fprocess>\n\n\u003Canti_patterns>\n\n- **Chat-log handoffs.** \"First I did X, then Y, then Z…\" The next agent doesn't need the journey.\n- **A checkpoint that summarizes the whole slice.** That's what `S##-SUMMARY.md` is for, at slice completion.\n- **No `nextAction`.** A handoff without a concrete next action is a journal entry.\n- **Implicit assumptions.** \"Obviously the next thing is…\" — write it down.\n- **Leaving background processes running.** They'll be orphaned when the session ends.\n- **Handoff without updating summaries.** The checkpoint should be thin because the summaries carry the weight.\n- **Writing `continue.md` or `HANDOFF.md` by hand.** Nothing reads those files; only the checkpoint row selects the resume path.\n\n\u003C\u002Fanti_patterns>\n\n\u003Csuccess_criteria>\n\n- [ ] `gsd_checkpoint_save` succeeded for the unit in flight.\n- [ ] The `nextAction` is concrete and executable without this session's context.\n- [ ] Completed tasks were marked done via `gsd_*` tools, not by hand-edited checkboxes.\n- [ ] Anything notable that was learned is saved with `capture_thought` or `gsd_decision_save`.\n- [ ] Background processes are not orphaned.\n- [ ] A cold-read of the project snapshot + the checkpoint + latest summary would produce the right next action.\n\n\u003C\u002Fsuccess_criteria>\n",{"name":5,"description":7},"main","c0bc9c4e7e0a8581aeac3af397031dc3a63d012e","src\u002Fresources\u002Fskills\u002Fhandoff",118,"https:\u002F\u002Fgithub.com\u002Fopen-gsd\u002Fgsd-pi","https:\u002F\u002Fwww.opengsd.net","https:\u002F\u002Fgithub.com\u002Fopen-gsd","opengsd.net","Most AI coding setups rot as the context window fills. Open GSD keeps the context clean, the work verified, and the git history honest — ship more, worry less.","2026-11-15 00:38:19",{"source":8,"skillName":5,"commands":35,"prompt":45,"zipAvailable":46},[36,39,42],{"tool":37,"command":38},"npx","npx skills add open-gsd\u002Fgsd-pi --skill handoff",{"tool":40,"command":41},"bunx","bunx skills add open-gsd\u002Fgsd-pi --skill handoff",{"tool":43,"command":44},"pnpm","pnpm dlx skills add open-gsd\u002Fgsd-pi --skill handoff","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fopen-gsd\u002Fgsd-pi\u002Fblob\u002Fmain\u002Fsrc\u002Fresources\u002Fskills\u002Fhandoff\u002FSKILL.md",true,[],[49,56,63,70,77,84],{"skillNo":50,"name":51,"nameZh":6,"description":52,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":53,"categories":54,"keywords":55,"publishedAt":19},"01M74FAXPHS0QT1S067QDKYDBX","write-milestone-brief","Synthesize the current conversation into a milestone brief (PRD). Saves it as the milestone CONTEXT (`gsd_summary_save`) by default, or files a GitHub issue only with explicit user confirmation. Use when asked to \"turn this into a PRD\", \"draft a milestone brief\", \"capture this context\", \"write it up\", or when enough has been discussed to commit the plan to paper. Does not interview — it synthesizes what is already known.","https:\u002F\u002Fgithub.com\u002Fopen-gsd\u002Fgsd-pi\u002Fblob\u002Fmain\u002Fsrc\u002Fresources\u002Fskills\u002Fwrite-milestone-brief\u002FSKILL.md",[],[],{"skillNo":57,"name":58,"nameZh":6,"description":59,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":60,"categories":61,"keywords":62,"publishedAt":19},"01M74FATJT7WZX5CSSG8RJDCF1","write-docs","Collaborative authoring workflow for proposals, technical specs, decision docs, READMEs, ADRs, and long-form prose that must work for fresh readers. Three stages: gather context, iterate on structure, reader-test for a stranger. Use when asked to \"write the docs\", \"draft a proposal\", \"write a spec\", \"write an RFC\", \"write the README\", or when a doc must be understandable without this session's context.","https:\u002F\u002Fgithub.com\u002Fopen-gsd\u002Fgsd-pi\u002Fblob\u002Fmain\u002Fsrc\u002Fresources\u002Fskills\u002Fwrite-docs\u002FSKILL.md",[],[],{"skillNo":64,"name":65,"nameZh":6,"description":66,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":67,"categories":68,"keywords":69,"publishedAt":19},"01M74FAQ8HKNVGCZ5ZBHW03A76","web-quality-audit","Comprehensive web quality audit covering performance, accessibility, SEO, and best practices. Use when asked to \"audit my site\", \"review web quality\", \"run lighthouse audit\", \"check page quality\", or \"optimize my website\".","https:\u002F\u002Fgithub.com\u002Fopen-gsd\u002Fgsd-pi\u002Fblob\u002Fmain\u002Fsrc\u002Fresources\u002Fskills\u002Fweb-quality-audit\u002FSKILL.md",[],[],{"skillNo":71,"name":72,"nameZh":6,"description":73,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":74,"categories":75,"keywords":76,"publishedAt":19},"01M74FAMZ7WP4RPAG20F448MVF","web-design-guidelines","Review UI code for Web Interface Guidelines compliance. Use when asked to \"review my UI\", \"check accessibility\", \"audit design\", \"review UX\", or \"check my site against best practices\".","https:\u002F\u002Fgithub.com\u002Fopen-gsd\u002Fgsd-pi\u002Fblob\u002Fmain\u002Fsrc\u002Fresources\u002Fskills\u002Fweb-design-guidelines\u002FSKILL.md",[],[],{"skillNo":78,"name":79,"nameZh":6,"description":80,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":81,"categories":82,"keywords":83,"publishedAt":19},"01M74FAHYM672GKGGS8KMY9CKC","verify-before-complete","Block completion claims until verification evidence has been produced in the current message. Use before marking a task\u002Fslice\u002Fmilestone complete, before creating a commit or PR, before saying \"it works\" or \"tests pass\", and any time you are about to claim work is done. The rule is: evidence before claims, always — running the verification must happen now, not \"earlier in the session\". Fresh output or no claim.","https:\u002F\u002Fgithub.com\u002Fopen-gsd\u002Fgsd-pi\u002Fblob\u002Fmain\u002Fsrc\u002Fresources\u002Fskills\u002Fverify-before-complete\u002FSKILL.md",[],[],{"skillNo":85,"name":86,"nameZh":6,"description":87,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":88,"categories":89,"keywords":90,"publishedAt":19},"01M74FADG78GX090P4YE5ZHR2A","userinterface-wiki","UI\u002FUX best practices for web interfaces. Use when reviewing animations, CSS, audio, typography, UX patterns, prefetching, or icon implementations. Covers 11 categories from animation principles to typography. Outputs file:line findings.","https:\u002F\u002Fgithub.com\u002Fopen-gsd\u002Fgsd-pi\u002Fblob\u002Fmain\u002Fsrc\u002Fresources\u002Fskills\u002Fuserinterface-wiki\u002FSKILL.md",[],[]]