From 67af931ab845194db5db816e24f7e8e32cd675c0 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Greg=20Berg=C3=A9?= <berge.greg@gmail.com>
Date: Thu, 29 Oct 2026 16:23:41 +0100
Subject: [PATCH 1/2] fix(skills): say a video's poster follows the upload

The argos-upload skill said a video's Markdown embed is correct the
moment the upload finishes, because the CDN derives the poster frame on
request. On 2026-10-29 ImageKit answered two posters with a `202` HTML
page for more than a quarter of an hour, and the embed rendered as a
broken image in the pull request.

Argos now gives a video a plain link to its share page until the poster
is ready (argos-ci/argos#2716), and rebuilds its own pull request comment
once it is. Say so, and point at `argos media get` for anyone pasting the
Markdown by hand.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
---
 skills/argos-upload/SKILL.md | 15 +++++++++++----
 1 file changed, 11 insertions(+), 4 deletions(-)

diff --git a/skills/argos-upload/SKILL.md b/skills/argos-upload/SKILL.md
index 8c4f2944..2fdafd28 100644
--- a/skills/argos-upload/SKILL.md
+++ b/skills/argos-upload/SKILL.md
@@ -101,7 +101,12 @@ checkout.png (after)
 - For a **video**, it is the **poster frame wrapped in a link** to the share
   page. GitHub renders an inline player only for media it hosts itself, so a
   `<video>` tag or a bare `.mp4` link pointing at Argos renders as a dead link.
-  The poster-in-a-link is the form that actually shows something.
+  The poster-in-a-link is the form that actually shows something. The image CDN
+  extracts the poster after the upload, and until it has, the Markdown is a
+  plain `[▶ name](url)` link instead. Pasting it yourself? Run
+  `argos media get <id>` a little later to get the one with the poster. With
+  `--pr` or `--branch` there is nothing to do: Argos updates its comment once
+  the poster is ready.
 
 `URL` is the share page, for a human. `File` is the image or video itself, for
 you: fetch it when you want to look at what you just uploaded. Use `--json` when
@@ -253,6 +258,8 @@ broken image.
   the H.264 that screen recorders produce; ProRes and some HEVC exports won't play
   inline and the viewer gets a download. Export to H.264 if you need playback.
 - **Comment size** — the managed pull request comment lists up to 20 media.
-- **No waiting** — a media is fully usable the moment the upload finishes. The
-  poster frame is derived by the CDN on request, so a video's Markdown embed is
-  correct immediately.
+- **No waiting, except for a video's poster** — the share URL and the file work
+  the moment the upload finishes. A video's poster frame follows: the CDN
+  extracts it after the upload, usually within seconds, and much later when its
+  video processing is backed up. Until then the video's Markdown is a plain link
+  rather than a picture.

From 3a832cbb1c934bea91236b5375d63988fb2c770f Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Greg=20Berg=C3=A9?= <berge.greg@gmail.com>
Date: Thu, 29 Oct 2026 16:50:57 +0100
Subject: [PATCH 2/2] fix(skills): say a video's embed shows a placeholder
 until its frame exists

Argos now serves a video's poster through its own endpoint while the
image CDN is still extracting the frame (argos-ci/argos#2716): the
Markdown is final at upload, and its picture is a placeholder until the
frame exists. Replaces the previous wording, written for a plain-link
fallback that was dropped in favour of this.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
---
 skills/argos-upload/SKILL.md | 18 +++++++-----------
 1 file changed, 7 insertions(+), 11 deletions(-)

diff --git a/skills/argos-upload/SKILL.md b/skills/argos-upload/SKILL.md
index 2fdafd28..ac95e401 100644
--- a/skills/argos-upload/SKILL.md
+++ b/skills/argos-upload/SKILL.md
@@ -101,12 +101,10 @@ checkout.png (after)
 - For a **video**, it is the **poster frame wrapped in a link** to the share
   page. GitHub renders an inline player only for media it hosts itself, so a
   `<video>` tag or a bare `.mp4` link pointing at Argos renders as a dead link.
-  The poster-in-a-link is the form that actually shows something. The image CDN
-  extracts the poster after the upload, and until it has, the Markdown is a
-  plain `[▶ name](url)` link instead. Pasting it yourself? Run
-  `argos media get <id>` a little later to get the one with the poster. With
-  `--pr` or `--branch` there is nothing to do: Argos updates its comment once
-  the poster is ready.
+  The poster-in-a-link is the form that actually shows something. Right after
+  the upload the image CDN may not have extracted the frame yet: the embed then
+  shows a placeholder, which turns into the frame by itself once it exists.
+  Paste it straight away; it never needs updating.
 
 `URL` is the share page, for a human. `File` is the image or video itself, for
 you: fetch it when you want to look at what you just uploaded. Use `--json` when
@@ -258,8 +256,6 @@ broken image.
   the H.264 that screen recorders produce; ProRes and some HEVC exports won't play
   inline and the viewer gets a download. Export to H.264 if you need playback.
 - **Comment size** — the managed pull request comment lists up to 20 media.
-- **No waiting, except for a video's poster** — the share URL and the file work
-  the moment the upload finishes. A video's poster frame follows: the CDN
-  extracts it after the upload, usually within seconds, and much later when its
-  video processing is backed up. Until then the video's Markdown is a plain link
-  rather than a picture.
+- **No waiting** — a media is fully usable the moment the upload finishes, and
+  its Markdown is final. A video's poster frame is extracted by the CDN after
+  the upload, usually within seconds; until then its embed shows a placeholder.