Terminal
Terminal/Skill
Upload local files (screenshots, screen recordings, images, videos) to GitHub as user-attachment assets and return markdown-ready URLs for PR descriptions, issue bodies, or PR/issue comments.
By Intercom
Works with
npx skills add intercom/2x-skills --skill attach-github-assetsUpload local files to GitHub via uploads.github.com/user-attachments/assets.
This skill exists to call upload.sh. If it is loaded with a local file path in context, you MUST run the script — do not describe the flow, do not propose markdown without uploading, do not stop after acknowledging the request. The only correct trajectory ends with a gh/curl-backed upload and either a returned asset URL or a posted comment.
If no local file path is present and none can be inferred from conversation, output no-op: no local file path and exit — do NOT call upload.sh with a placeholder, a remote URL, or a guessed path.
Self-invoke ONLY when all of the following hold:
/tmp/..., ~/Desktop/...) or relative to cwd — for an image (png, jpg, jpeg, gif, webp, svg) or video (mov, mp4, webm)./create-sub-issues flow.Canonical triggers:
upload.sh for the list — only image/video formats are accepted).If you have been loaded but none of the "When to Self-Invoke" conditions are met, emit no-op: <reason> and return control. This is the script-first path; staying loaded without uploading is the failure mode.
$ARGUMENTS is set, use those file path(s) verbatim — one per upload.upload.sh itself errors on missing files (File not found: <path>), so do not pre-gate on existence — pass the user's path through and surface the script's error verbatim if it fails.
The script has two modes. Pick by one fact — where do the files have to end up? Never by weighing mechanisms: the script chooses between native gh --attach and a direct upload itself, so there is nothing to decide beyond the mode.
A new comment on a named issue or PR → post it in one call, all files at once:
${CLAUDE_PLUGIN_ROOT}/skills/attach-github-assets/scripts/upload.sh \
--post-to <pr|issue>:<number> [--repo OWNER/REPO] [--body "<text>"] "<file-path>" ["<other-file>" ...]
Prints the comment URL. Use pr: for a pull request and issue: for an issue — the wrong one errors. This mode uses gh ... comment --attach when the installed gh has it (v2.99.0+) and otherwise uploads and composes the body itself; both produce the same comment, so no version check is needed here.
Anywhere else → print the asset URL, once per file, for embedding in a body assembled elsewhere:
${CLAUDE_PLUGIN_ROOT}/skills/attach-github-assets/scripts/upload.sh "<file-path>"
The script auto-detects the repo ID from git remote and MIME type from extension. Returns the asset URL on stdout, exits non-zero on failure.
To override repo ID (e.g. uploading from a worktree whose remote isn't the target repo):
${CLAUDE_PLUGIN_ROOT}/skills/attach-github-assets/scripts/upload.sh "<file-path>" <repo_id>
In this mode run the script once per file — never batch into a single invocation, because the second positional argument is read as the repo ID. Never substitute curl, a bare gh command, or any other upload mechanism for the script.
A named PR or issue does not by itself mean --post-to. A PR or issue body — "put these in PR #123's description", "add this to the issue body" — is this mode, not the comment mode: --post-to writes a separate comment and returns no URL, so the body it was meant for would stay unchanged. Use this mode for a body, and let whoever owns that body write the markdown from Step 3 into it.
Only for the no-target mode; --post-to has already written the comment.
![]() would break that./attach-github-assets ~/Desktop/screenshot.png/attach-github-assets /tmp/before.png /tmp/after.png