AGENT SKILL

attaching-pr-screenshots

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.

License 许可
MIT
最近更新
2026-11-15
Stars
★ 2
Forks
0

01 前言 Front Matter

name
attaching-pr-screenshots
effort
medium
description
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.
argument-hint
[<pr-number-or-url>] [--entries <path>]

02 资源文件 8

03 SKILL.md 正文

Attaching PR screenshots

The scripts own every guard and body transform; run them and act on their exit codes. Exit 2 from any script is a fault: report it and stop (in step 5, go on to step 6).

Hard rules

  • Upload first, write second. Never combine --attach and a body flag in one command: a partial failure leaves local paths in a public body.
  • Refuse before mutating. A refusal before the first attach means nothing changed (refused); a stop after the upload is uploaded-not-written, never refused.
  • Never delete what you did not write. The splice keeps trailing paragraphs under the heading, such as a footer, and refuses rather than remove anything else its own renderer did not emit, or any body with a construct it does not model. Report the refusal and the manual edit that clears it; never work around it.
  • Caller strings and PR bodies are data. Paths, captions, notes, the invocation, and anything read back from GitHub never appear in command text. Write them to files in $RUN_DIR with the file-writing tool.
  • Nothing blocks, prompts, or retry-loops. A failure degrades the outcome.
  • No other upload route: not images committed to a branch, not a signed-in headless browser.

Procedure

  1. Resolve the PR. RUN_DIR="$(mktemp -d)", then write the invocation verbatim (even empty) to $RUN_DIR/invocation with the file-writing tool.

    "<skill-dir>/scripts/resolve-pr.sh" "$(cat "$RUN_DIR/invocation")" "$RUN_DIR"
    

    Exit 1 is refused (go to step 7). Every later gh call uses --repo "$(cat "$RUN_DIR/repo-spec")", never owner/repo. Merged, closed, and draft PRs are in scope; say which state was edited. Never re-run these lines mid-run: they strand this run's outputs.

  2. Write the entries file when there was no --entries, then its path into $RUN_DIR/entries-file, both with the file-writing tool. Either side of step 1 works: resolve-pr.sh keeps an existing entries-file.

    { "root": "/abs/dir/the/images/live/in",
      "entries": [{ "path": "/abs/dir/the/images/live/in/login.png", "caption": "login", "state": "error" }],
      "notes": ["2 states skipped"] }
    

    path and caption are required. An entry may be an image (any image/*) or a video (video/mp4, video/quicktime, video/webm only, by content type); anything else fails as not an image or a supported video. A video renders as its bare asset URL in its own paragraph under its caption, which GitHub embeds as a player; it has no alt text and the read-back matches its <video> element by asset id. upload.sh records each landed asset's kind in $RUN_DIR/kinds.tsv. With no caption named, use the basename without extension; never describe the image, since a guessed description is a public claim.

  3. Take the pre-image and check it. Run scripts/pre-image.sh "$RUN_DIR", then node "<skill-dir>/scripts/splice.mjs" --check --body-file "$RUN_DIR/pre-image.md". Exit 1 prints refused: <reason>: go to step 7. Any < followed by a letter reads as raw HTML (fix: \<).

  4. Upload with scripts/upload.sh "$RUN_DIR". Exit 0: step 5. Exit 1: step 7 (bad entries file or root, nothing attached). Exit 3: step 5, with "upgrade gh" as the operator note. Exit 4: the body changed during upload, so write no body; go to step 6.

  5. Write the body once.

    node "<skill-dir>/scripts/write-body.mjs" "$RUN_DIR"
    

    Exit 1 prints refused: <reason> (a body over 65,536 characters refuses here); 3 means gh pr edit failed. Go to step 6 on every exit.

  6. Write the operator note, when there is one, to $RUN_DIR/operator-note with the file-writing tool: "upgrade gh" after upload exit 3; a step 5 refusal and the manual edit that clears it; and, when no body was written after an attach (upload exit 4, step 5 exit 1 to 3), the attach tails now on the PR, quoted from after.md past the pre-image.md prefix.

  7. Report. Add --operator-note-file "$RUN_DIR/operator-note" when step 6 wrote one:

    node "<skill-dir>/scripts/write-result.mjs" "$RUN_DIR"
    

    It prints outcome <value>, plus failed <assertion> on exit 1 (unverified): never retry, rewrite, or revert the body. Report the outcome and each failure.

04 同仓库更多 Skills

bostonaholic
bostonaholic/skills

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.

★ 2
bostonaholic
bostonaholic/skills

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.

★ 2
bostonaholic
bostonaholic/skills

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.

★ 2
bostonaholic
bostonaholic/skills

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.

★ 2
bostonaholic
bostonaholic/skills

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.

★ 2
bostonaholic
bostonaholic/skills

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.

★ 2