argos-upload

Upload screenshots and screen recordings to Argos and embed them in pull requests.

Updated Sep 15, 2026
One-click install
npx skills add https://github.com/Nadav011/nadavai-claude --skill argos-upload-nadav011
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: argos-upload
Source: https://github.com/Nadav011/nadavai-claude/tree/main/plugins/nadavai/skills/argos-upload
Command: npx skills add https://github.com/Nadav011/nadavai-claude --skill argos-upload-nadav011

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? GitHub has no public API for attaching images to pull request comments, so an agent or developer working from a terminal cannot get a visual artifact in front of a reviewer. This Skill uploads screenshots and screen recordings to Argos and returns a shareable URL plus ready-to-paste Markdown, and can attach media to a branch or pull request where Argos posts and maintains the comment itself. ## Core Features & Use Cases - Media upload with PR integration: Upload images and videos with argos media upload, stage them on a branch with --branch so they attach automatically when a PR opens, or publish directly with --pr. - Before/after pairs and versioning: Files named -before/-after display side by side in the PR comment, and re-uploading the same name creates a new version under one stable URL so posted Markdown updates itself. - Reading visual feedback: List open comment threads pinned to exact pixel coordinates on a screenshot, reply to threads, and resolve them once fixed. - Use Case: You changed a checkout page UI on branch feat/checkout. Run argos media upload checkout-before.png checkout-after.png --branch feat/checkout, and when the PR opens the reviewer sees a side-by-side comparison without checking out your branch. ## Quick Start Use the argos-upload skill to upload my before and after screenshots and attach them to the current branch so they appear on the pull request.

Frequently Asked Questions about argos-upload

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I attach a screenshot to a GitHub pull request from the terminal?

Run argos media upload with the --pr flag to publish directly to a pull request, or --branch to stage the media so Argos attaches it automatically when a PR opens for that branch. Argos posts and maintains one comment per pull request listing all attached media.

How do I create a before/after screenshot comparison in a pull request?

Name the files with -before and -after suffixes, such as checkout-before.png and checkout-after.png, and upload them together. Argos treats them as two halves of one pair and shows them side by side in the pull request comment.

Does re-uploading a screenshot break the Markdown already posted in a PR?

No. Re-uploading the same name on the same branch or pull request adds a new version under the same share URL, which always shows the newest version. Byte-identical uploads are skipped entirely and cost nothing.

What file formats and sizes does Argos media upload support?

Accepted formats are PNG, JPEG, WebP, AVIF, GIF, MP4, WebM, and MOV. Size limits are 50 MB on the free plan and 500 MB on Pro. Images are converted to WebP before upload unless conversion would not help.

Why won't my staged media attach to a pull request?

Staged media never attaches to pull requests opened from a fork, because Argos does not match staged media against branch names chosen by outsiders. Also verify the project is connected to GitHub with pull request comments enabled via argos project get.

How do I read comments pinned to an uploaded screenshot?

Use argos media list to find the media ID, then argos media comment list <id> --json to see open threads. Each comment carries the pin as normalized 0-1 coordinates, and every comment command requires a personal access token.