[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7DGWCVDX2G04FPEJKVENDA6":3,"skill-same:01M7DGWCVDX2G04FPEJKVENDA6":86},{"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":26,"commitSha":27,"skillDirectory":28,"forksCount":29,"repositoryHtmlUrl":30,"repositoryHomepageUrl":31,"ownerHtmlUrl":32,"ownerBlogUrl":33,"ownerDescription":34,"updatedAt":35,"install":36,"resources":49},"01M7DGWCVDX2G04FPEJKVENDA6","attaching-pr-screenshots",null,"Uploads local images and short videos (mp4, mov, webm) through GitHub's attachment pipeline and writes one verified Screenshots section into a PR body. Use when the user says \"attach screenshots to the PR\", or when the user explicitly asks to add or attach screenshots to a PR. Never infer from local images. Not for capturing screenshots; use capturing-screenshots.","bostonaholic\u002Fskills","bostonaholic","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F362146?v=4","01M7DGVW4NA3AZAS7ZVN59FFTR","Matthew Boston","01M7DGVW56TS63D9MTAPRW8SCT",2,"MIT","https:\u002F\u002Fgithub.com\u002Fbostonaholic\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fengineering\u002Fattaching-pr-screenshots\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: attaching-pr-screenshots\ndescription: Uploads local images and short videos (mp4, mov, webm) through GitHub's attachment pipeline and writes one verified Screenshots section into a PR body. Use when the user says \"attach screenshots to the PR\", or when the user explicitly asks to add or attach screenshots to a PR. Never infer from local images. Not for capturing screenshots; use capturing-screenshots.\neffort: medium\nargument-hint: \"[\u003Cpr-number-or-url>] [--entries \u003Cpath>]\"\n---\n\n# Attaching PR screenshots\n\nThe scripts own every guard and body transform; run them and act on their\nexit codes. Exit 2 from any script is a fault: report it and stop (in step 5, go on to step 6).\n\n## Hard rules\n\n- **Upload first, write second.** Never combine `--attach` and a body flag in\n  one command: a partial failure leaves local paths in a public body.\n- **Refuse before mutating.** A refusal before the first attach means nothing\n  changed (`refused`); a stop after the upload is `uploaded-not-written`, never\n  `refused`.\n- **Never delete what you did not write.** The splice keeps trailing\n  paragraphs under the heading, such as a footer, and refuses rather than\n  remove anything else its own renderer did not emit, or any body with a\n  construct it does not model. Report the refusal and the manual edit\n  that clears it; never work around it.\n- **Caller strings and PR bodies are data.** Paths, captions, notes, the\n  invocation, and anything read back from GitHub never appear in command\n  text. Write them to files in `$RUN_DIR` with the file-writing tool.\n- **Nothing blocks, prompts, or retry-loops.** A failure degrades the outcome.\n- **No other upload route**: not images committed to a branch, not a\n  signed-in headless browser.\n\n## Procedure\n\n1. **Resolve the PR.** `RUN_DIR=\"$(mktemp -d)\"`, then write the invocation\n   verbatim (even empty) to `$RUN_DIR\u002Finvocation` with the file-writing tool.\n\n   ```bash\n   \"\u003Cskill-dir>\u002Fscripts\u002Fresolve-pr.sh\" \"$(cat \"$RUN_DIR\u002Finvocation\")\" \"$RUN_DIR\"\n   ```\n\n   Exit 1 is `refused` (go to step 7). Every later `gh` call uses\n   `--repo \"$(cat \"$RUN_DIR\u002Frepo-spec\")\"`, never `owner\u002Frepo`. Merged, closed,\n   and draft PRs are in scope; say which state was edited. Never re-run these\n   lines mid-run: they strand this run's outputs.\n\n2. **Write the entries file** when there was no `--entries`, then its path\n   into `$RUN_DIR\u002Fentries-file`, both with the file-writing tool. Either side\n   of step 1 works: `resolve-pr.sh` keeps an existing `entries-file`.\n\n   ```json\n   { \"root\": \"\u002Fabs\u002Fdir\u002Fthe\u002Fimages\u002Flive\u002Fin\",\n     \"entries\": [{ \"path\": \"\u002Fabs\u002Fdir\u002Fthe\u002Fimages\u002Flive\u002Fin\u002Flogin.png\", \"caption\": \"login\", \"state\": \"error\" }],\n     \"notes\": [\"2 states skipped\"] }\n   ```\n\n   `path` and `caption` are required. An entry may be an image (any\n   `image\u002F*`) or a video (`video\u002Fmp4`, `video\u002Fquicktime`, `video\u002Fwebm` only,\n   by content type); anything else fails as `not an image or a supported\n   video`. A video renders as its bare asset URL in its own paragraph under its\n   caption, which GitHub embeds as a player; it has no alt text and the\n   read-back matches its `\u003Cvideo>` element by asset id. `upload.sh` records\n   each landed asset's kind in `$RUN_DIR\u002Fkinds.tsv`. With no caption named, use the\n   basename without extension; never describe the image, since a guessed\n   description is a public claim.\n\n3. **Take the pre-image and check it.** Run `scripts\u002Fpre-image.sh \"$RUN_DIR\"`,\n   then `node \"\u003Cskill-dir>\u002Fscripts\u002Fsplice.mjs\" --check --body-file \"$RUN_DIR\u002Fpre-image.md\"`.\n   Exit 1 prints `refused: \u003Creason>`: go to step 7. Any `\u003C` followed by a\n   letter reads as raw HTML (fix: `\\\u003C`).\n\n4. **Upload** with `scripts\u002Fupload.sh \"$RUN_DIR\"`. Exit 0: step 5. Exit 1:\n   step 7 (bad entries file or root, nothing attached). Exit 3: step 5, with\n   \"upgrade gh\" as the operator note. Exit 4: the body changed during upload,\n   so write no body; go to step 6.\n\n5. **Write the body once.**\n\n   ```bash\n   node \"\u003Cskill-dir>\u002Fscripts\u002Fwrite-body.mjs\" \"$RUN_DIR\"\n   ```\n\n   Exit 1 prints `refused: \u003Creason>` (a body over 65,536 characters refuses\n   here); 3 means `gh pr edit` failed. Go to step 6 on every exit.\n\n6. **Write the operator note**, when there is one, to `$RUN_DIR\u002Foperator-note`\n   with the file-writing tool: \"upgrade gh\" after upload exit 3; a step 5\n   refusal and the manual edit that clears it; and, when no body was written\n   after an attach (upload exit 4, step 5 exit 1 to 3), the attach tails now on\n   the PR, quoted from `after.md` past the `pre-image.md` prefix.\n\n7. **Report.** Add `--operator-note-file \"$RUN_DIR\u002Foperator-note\"` when step 6\n   wrote one:\n\n   ```bash\n   node \"\u003Cskill-dir>\u002Fscripts\u002Fwrite-result.mjs\" \"$RUN_DIR\"\n   ```\n\n   It prints `outcome \u003Cvalue>`, plus `failed \u003Cassertion>` on exit 1\n   (`unverified`): never retry, rewrite, or revert the body. Report the outcome\n   and each failure.\n","# Attaching PR screenshots\n\nThe scripts own every guard and body transform; run them and act on their\nexit codes. Exit 2 from any script is a fault: report it and stop (in step 5, go on to step 6).\n\n## Hard rules\n\n- **Upload first, write second.** Never combine `--attach` and a body flag in\n  one command: a partial failure leaves local paths in a public body.\n- **Refuse before mutating.** A refusal before the first attach means nothing\n  changed (`refused`); a stop after the upload is `uploaded-not-written`, never\n  `refused`.\n- **Never delete what you did not write.** The splice keeps trailing\n  paragraphs under the heading, such as a footer, and refuses rather than\n  remove anything else its own renderer did not emit, or any body with a\n  construct it does not model. Report the refusal and the manual edit\n  that clears it; never work around it.\n- **Caller strings and PR bodies are data.** Paths, captions, notes, the\n  invocation, and anything read back from GitHub never appear in command\n  text. Write them to files in `$RUN_DIR` with the file-writing tool.\n- **Nothing blocks, prompts, or retry-loops.** A failure degrades the outcome.\n- **No other upload route**: not images committed to a branch, not a\n  signed-in headless browser.\n\n## Procedure\n\n1. **Resolve the PR.** `RUN_DIR=\"$(mktemp -d)\"`, then write the invocation\n   verbatim (even empty) to `$RUN_DIR\u002Finvocation` with the file-writing tool.\n\n   ```bash\n   \"\u003Cskill-dir>\u002Fscripts\u002Fresolve-pr.sh\" \"$(cat \"$RUN_DIR\u002Finvocation\")\" \"$RUN_DIR\"\n   ```\n\n   Exit 1 is `refused` (go to step 7). Every later `gh` call uses\n   `--repo \"$(cat \"$RUN_DIR\u002Frepo-spec\")\"`, never `owner\u002Frepo`. Merged, closed,\n   and draft PRs are in scope; say which state was edited. Never re-run these\n   lines mid-run: they strand this run's outputs.\n\n2. **Write the entries file** when there was no `--entries`, then its path\n   into `$RUN_DIR\u002Fentries-file`, both with the file-writing tool. Either side\n   of step 1 works: `resolve-pr.sh` keeps an existing `entries-file`.\n\n   ```json\n   { \"root\": \"\u002Fabs\u002Fdir\u002Fthe\u002Fimages\u002Flive\u002Fin\",\n     \"entries\": [{ \"path\": \"\u002Fabs\u002Fdir\u002Fthe\u002Fimages\u002Flive\u002Fin\u002Flogin.png\", \"caption\": \"login\", \"state\": \"error\" }],\n     \"notes\": [\"2 states skipped\"] }\n   ```\n\n   `path` and `caption` are required. An entry may be an image (any\n   `image\u002F*`) or a video (`video\u002Fmp4`, `video\u002Fquicktime`, `video\u002Fwebm` only,\n   by content type); anything else fails as `not an image or a supported\n   video`. A video renders as its bare asset URL in its own paragraph under its\n   caption, which GitHub embeds as a player; it has no alt text and the\n   read-back matches its `\u003Cvideo>` element by asset id. `upload.sh` records\n   each landed asset's kind in `$RUN_DIR\u002Fkinds.tsv`. With no caption named, use the\n   basename without extension; never describe the image, since a guessed\n   description is a public claim.\n\n3. **Take the pre-image and check it.** Run `scripts\u002Fpre-image.sh \"$RUN_DIR\"`,\n   then `node \"\u003Cskill-dir>\u002Fscripts\u002Fsplice.mjs\" --check --body-file \"$RUN_DIR\u002Fpre-image.md\"`.\n   Exit 1 prints `refused: \u003Creason>`: go to step 7. Any `\u003C` followed by a\n   letter reads as raw HTML (fix: `\\\u003C`).\n\n4. **Upload** with `scripts\u002Fupload.sh \"$RUN_DIR\"`. Exit 0: step 5. Exit 1:\n   step 7 (bad entries file or root, nothing attached). Exit 3: step 5, with\n   \"upgrade gh\" as the operator note. Exit 4: the body changed during upload,\n   so write no body; go to step 6.\n\n5. **Write the body once.**\n\n   ```bash\n   node \"\u003Cskill-dir>\u002Fscripts\u002Fwrite-body.mjs\" \"$RUN_DIR\"\n   ```\n\n   Exit 1 prints `refused: \u003Creason>` (a body over 65,536 characters refuses\n   here); 3 means `gh pr edit` failed. Go to step 6 on every exit.\n\n6. **Write the operator note**, when there is one, to `$RUN_DIR\u002Foperator-note`\n   with the file-writing tool: \"upgrade gh\" after upload exit 3; a step 5\n   refusal and the manual edit that clears it; and, when no body was written\n   after an attach (upload exit 4, step 5 exit 1 to 3), the attach tails now on\n   the PR, quoted from `after.md` past the `pre-image.md` prefix.\n\n7. **Report.** Add `--operator-note-file \"$RUN_DIR\u002Foperator-note\"` when step 6\n   wrote one:\n\n   ```bash\n   node \"\u003Cskill-dir>\u002Fscripts\u002Fwrite-result.mjs\" \"$RUN_DIR\"\n   ```\n\n   It prints `outcome \u003Cvalue>`, plus `failed \u003Cassertion>` on exit 1\n   (`unverified`): never retry, rewrite, or revert the body. Report the outcome\n   and each failure.\n",{"name":5,"effort":24,"description":7,"argument-hint":25},"medium","[\u003Cpr-number-or-url>] [--entries \u003Cpath>]","main","e8ff85fe8cec970c537bf34f0373fdff02834815","skills\u002Fengineering\u002Fattaching-pr-screenshots",0,"https:\u002F\u002Fgithub.com\u002Fbostonaholic\u002Fskills","https:\u002F\u002Fskills.bostonaholic.dev","https:\u002F\u002Fgithub.com\u002Fbostonaholic","https:\u002F\u002Fmatthewboston.com","agility. simplicity. value.","2026-11-15 04:51:36",{"source":8,"skillName":5,"commands":37,"prompt":47,"zipAvailable":48},[38,41,44],{"tool":39,"command":40},"npx","npx skills add bostonaholic\u002Fskills --skill attaching-pr-screenshots",{"tool":42,"command":43},"bunx","bunx skills add bostonaholic\u002Fskills --skill attaching-pr-screenshots",{"tool":45,"command":46},"pnpm","pnpm dlx skills add bostonaholic\u002Fskills --skill attaching-pr-screenshots","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fbostonaholic\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fengineering\u002Fattaching-pr-screenshots\u002FSKILL.md",true,[50,56,62,66,70,74,78,82],{"path":51,"resourceType":52,"resourceTypeDesc":53,"sizeBytes":54,"sourceHtmlUrl":55},"agents\u002Fopenai.yaml","REFERENCE","参考文档",231,"https:\u002F\u002Fgithub.com\u002Fbostonaholic\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fengineering\u002Fattaching-pr-screenshots\u002Fagents\u002Fopenai.yaml",{"path":57,"resourceType":58,"resourceTypeDesc":59,"sizeBytes":60,"sourceHtmlUrl":61},"scripts\u002Fasset-url.mjs","SCRIPT","脚本",4167,"https:\u002F\u002Fgithub.com\u002Fbostonaholic\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fengineering\u002Fattaching-pr-screenshots\u002Fscripts\u002Fasset-url.mjs",{"path":63,"resourceType":58,"resourceTypeDesc":59,"sizeBytes":64,"sourceHtmlUrl":65},"scripts\u002Fpre-image.sh",3859,"https:\u002F\u002Fgithub.com\u002Fbostonaholic\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fengineering\u002Fattaching-pr-screenshots\u002Fscripts\u002Fpre-image.sh",{"path":67,"resourceType":58,"resourceTypeDesc":59,"sizeBytes":68,"sourceHtmlUrl":69},"scripts\u002Fresolve-pr.sh",7529,"https:\u002F\u002Fgithub.com\u002Fbostonaholic\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fengineering\u002Fattaching-pr-screenshots\u002Fscripts\u002Fresolve-pr.sh",{"path":71,"resourceType":58,"resourceTypeDesc":59,"sizeBytes":72,"sourceHtmlUrl":73},"scripts\u002Fsplice.mjs",45998,"https:\u002F\u002Fgithub.com\u002Fbostonaholic\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fengineering\u002Fattaching-pr-screenshots\u002Fscripts\u002Fsplice.mjs",{"path":75,"resourceType":58,"resourceTypeDesc":59,"sizeBytes":76,"sourceHtmlUrl":77},"scripts\u002Fupload.sh",18207,"https:\u002F\u002Fgithub.com\u002Fbostonaholic\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fengineering\u002Fattaching-pr-screenshots\u002Fscripts\u002Fupload.sh",{"path":79,"resourceType":58,"resourceTypeDesc":59,"sizeBytes":80,"sourceHtmlUrl":81},"scripts\u002Fwrite-body.mjs",11545,"https:\u002F\u002Fgithub.com\u002Fbostonaholic\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fengineering\u002Fattaching-pr-screenshots\u002Fscripts\u002Fwrite-body.mjs",{"path":83,"resourceType":58,"resourceTypeDesc":59,"sizeBytes":84,"sourceHtmlUrl":85},"scripts\u002Fwrite-result.mjs",13146,"https:\u002F\u002Fgithub.com\u002Fbostonaholic\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fengineering\u002Fattaching-pr-screenshots\u002Fscripts\u002Fwrite-result.mjs",[87,94,101,108,115,122],{"skillNo":88,"name":89,"nameZh":6,"description":90,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":91,"categories":92,"keywords":93,"publishedAt":19},"01M7DH74HXXCFEZVAGZWETR4TY","writing-system-prompts","Writes and reviews system prompts for AI tools, agents, chatbots, and LLM products using a fixed section order and a quality checklist. Use when the user says \"write a system prompt\", or when drafting a system prompt or auditing one for missing stop criteria, tool rules, constraints, or examples. Not for compressing an existing prompt; use improving-prompts.","https:\u002F\u002Fgithub.com\u002Fbostonaholic\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fproductivity\u002Fwriting-system-prompts\u002FSKILL.md",[],[],{"skillNo":95,"name":96,"nameZh":6,"description":97,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":98,"categories":99,"keywords":100,"publishedAt":19},"01M7DH6ZJ1RFRCGM01CGMJ10RY","writing-prose","Writes and edits prose for people in a plain, conversational, short house style with no em dashes. Use when the user says \"write this up\", or when drafting or revising documentation, READMEs, explanations, blog posts, or other human-facing prose. Not for prompts written for agents; use writing-system-prompts or composing-agent-prompts.","https:\u002F\u002Fgithub.com\u002Fbostonaholic\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fproductivity\u002Fwriting-prose\u002FSKILL.md",[],[],{"skillNo":102,"name":103,"nameZh":6,"description":104,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":105,"categories":106,"keywords":107,"publishedAt":19},"01M7DH6TR43CYKY8VHFQWKNDWW","writing-acceptance-criteria","Writes or rewrites acceptance criteria until each is provable: one observable outcome with a named check that can fail. Use when the user says \"write acceptance criteria\", or asks to write, rewrite, or tighten acceptance criteria or a definition of done. Not for proving work meets them; use proving-claims.","https:\u002F\u002Fgithub.com\u002Fbostonaholic\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fproductivity\u002Fwriting-acceptance-criteria\u002FSKILL.md",[],[],{"skillNo":109,"name":110,"nameZh":6,"description":111,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":112,"categories":113,"keywords":114,"publishedAt":19},"01M7DH6P0PC857A3W7CAGJPXSM","summarizing-shipped-work","Summarizes the user's merged GitHub PRs for a timeframe into a grouped, linked shipped-work report with highlights, and offers to update a brag document. Use when the user says \"what shipped?\", or when asked what the user shipped (this week, last month, a quarter, since a date), for a status update, or to update a brag doc.","https:\u002F\u002Fgithub.com\u002Fbostonaholic\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fproductivity\u002Fsummarizing-shipped-work\u002FSKILL.md",[],[],{"skillNo":116,"name":117,"nameZh":6,"description":118,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":119,"categories":120,"keywords":121,"publishedAt":19},"01M7DH6H3YCJ59CZ0DMKHZ3N7S","running-retros","Mines a session transcript, past agent sessions, or named sources such as PR review comments for durable learnings, then proposes approval-gated edits to skills, AGENTS.md, or docs and tracker issues. Use when the user says \"retro\", or when the user explicitly asks for a retrospective. Never infer from session end or friction.","https:\u002F\u002Fgithub.com\u002Fbostonaholic\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fproductivity\u002Frunning-retros\u002FSKILL.md",[],[],{"skillNo":123,"name":124,"nameZh":6,"description":125,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":126,"categories":127,"keywords":128,"publishedAt":19},"01M7DH6C68WZB8Z6DD4MH770B7","learning-from-mistakes","Codifies the latest correction or mistake in the conversation as a short imperative rule in the project or global CLAUDE.md or AGENTS.md, after the user approves it. Use when the user says \"learn from this mistake\", or when the user asks to learn from a mistake, remember a lesson for next time, add a rule to CLAUDE.md, or not repeat a behavior. Not for a whole session; use running-retros.","https:\u002F\u002Fgithub.com\u002Fbostonaholic\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fproductivity\u002Flearning-from-mistakes\u002FSKILL.md",[],[]]