diff --git a/design-review/SKILL.md.tmpl b/design-review/SKILL.md.tmpl
index 6d503e1a..343981c2 100644
--- a/design-review/SKILL.md.tmpl
+++ b/design-review/SKILL.md.tmpl
@@ -231,6 +231,14 @@ After writing, register in manifest:
 ~/.claude/skills/gstack/bin/gstack-manifest-append design-audit "reports/$(basename "$FILE")" design-review "$BRANCH"
 ```
 
+**Screenshot upload:** After compiling the report, upload all screenshots:
+```bash
+for img in .gstack/design-reports/screenshots/*.png; do
+  [ -f "$img" ] && ~/.claude/skills/gstack/bin/gstack-upload "$img" 2>/dev/null
+done
+```
+If upload succeeds, update the report to use hosted URLs. If it fails, keep local paths and append: `(screenshot not uploaded — run gstack sync to share)`
+
 **Per-finding additions** (beyond standard design audit report):
 - Fix Status: verified / best-effort / reverted / deferred
 - Commit SHA (if fixed)
diff --git a/qa-only/SKILL.md.tmpl b/qa-only/SKILL.md.tmpl
index 262fe3f1..077c3b76 100644
--- a/qa-only/SKILL.md.tmpl
+++ b/qa-only/SKILL.md.tmpl
@@ -95,6 +95,14 @@ After writing, register in manifest:
 ~/.claude/skills/gstack/bin/gstack-manifest-append test-outcome "reports/$(basename "$FILE")" qa-only "$BRANCH"
 ```
 
+**Screenshot upload:** After compiling the report, upload all screenshots:
+```bash
+for img in .gstack/qa-reports/screenshots/*.png; do
+  [ -f "$img" ] && ~/.claude/skills/gstack/bin/gstack-upload "$img" 2>/dev/null
+done
+```
+If upload succeeds, update the report to use hosted URLs. If it fails, keep local paths and append: `(screenshot not uploaded — run gstack sync to share)`
+
 ### Output Structure
 
 ```
diff --git a/qa/SKILL.md.tmpl b/qa/SKILL.md.tmpl
index 289192b9..56945404 100644
--- a/qa/SKILL.md.tmpl
+++ b/qa/SKILL.md.tmpl
@@ -517,6 +517,14 @@ After writing, register in manifest:
 ~/.claude/skills/gstack/bin/gstack-manifest-append test-outcome "reports/$(basename "$FILE")" qa "$BRANCH"
 ```
 
+**Screenshot upload:** After compiling the report, upload all screenshots for team sharing:
+```bash
+for img in .gstack/qa-reports/screenshots/*.png; do
+  [ -f "$img" ] && ~/.claude/skills/gstack/bin/gstack-upload "$img" 2>/dev/null
+done
+```
+If upload succeeds, the output is a public URL. If it fails (no Supabase config), the local path is printed with a stderr warning. Either way, reference the screenshot path in the report. If URLs were returned, update the report to use hosted URLs instead of local paths. If local paths remain, append: `(screenshot not uploaded — run gstack sync to share)`
+
 **Per-issue additions** (beyond standard report template):
 - Fix Status: verified / best-effort / reverted / deferred
 - Commit SHA (if fixed)