Skip to content

Add visual-pr plugin — screenshot capture, annotation, and PR embedding#1804

Open
nohwnd wants to merge 4 commits into
github:stagedfrom
nohwnd:visual-pr-skills
Open

Add visual-pr plugin — screenshot capture, annotation, and PR embedding#1804
nohwnd wants to merge 4 commits into
github:stagedfrom
nohwnd:visual-pr-skills

Conversation

@nohwnd
Copy link
Copy Markdown
Contributor

@nohwnd nohwnd commented May 22, 2026

Four skills + one plugin that teach Copilot to capture UI screenshots, annotate them with algorithmic label placement, embed before/after images in PR descriptions, and record animated GIF demos.

Skills

  • ui-screenshots — Playwright capture, PIL crop, interactive states, non-web screenshots (mss, Electron)
  • image-annotations — algorithmic annotation with ring search, contrast scoring, overlap avoidance, GIF annotations
  • pr-screenshots — PR description before/after pattern, image upload (AzDO + GitHub)
  • screen-recording — GIF creation with variable timing, mss desktop recording, diff-based change detection

Plugin

visual-pr bundles all four. README includes a demo showing the annotation engine on GitHub Issues — before/after screenshots, multipurpose callouts from a single prompt, and the debug heatmap view.

Needs a vision-capable model. Demo images were generated with Claude Opus 4.6.

…nd screen recording

Four skills that teach Copilot to capture UI screenshots (Playwright + PIL),
annotate them with algorithmic label placement, embed before/after images
in PR descriptions, and record animated GIF demos.

Includes demo images showing the annotation engine on GitHub Issues.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Copilot AI review requested due to automatic review settings May 22, 2026 16:19
@nohwnd nohwnd requested a review from aaronpowell as a code owner May 22, 2026 16:19
@github-actions github-actions Bot added new-submission PR adds at least one new contribution plugin PR touches plugins skills PR touches skills labels May 22, 2026
@github-actions
Copy link
Copy Markdown
Contributor

github-actions Bot commented May 22, 2026

🔍 Skill Validator Results

⚠️ Warnings or advisories found

Scope Checked
Skills 4
Agents 1
Total 5
Severity Count
--- ---:
❌ Errors 0
⚠️ Warnings 1
ℹ️ Advisories 0

Summary

Level Finding
ℹ️ Found 4 skill(s)
ℹ️ [image-annotations] 📊 image-annotations: 6,966 BPE tokens [chars/4: 5,956] (comprehensive ✗), 29 sections, 8 code blocks
ℹ️ [image-annotations] ⚠ Skill is 6,966 BPE tokens (chars/4 estimate: 5,956) — "comprehensive" skills hurt performance by 2.9pp on average. Consider splitting into 2–3 focused skills.
ℹ️ [pr-screenshots] 📊 pr-screenshots: 1,120 BPE tokens [chars/4: 1,220] (detailed ✓), 13 sections, 5 code blocks
ℹ️ [screen-recording] 📊 screen-recording: 1,999 BPE tokens [chars/4: 2,003] (detailed ✓), 22 sections, 9 code blocks
ℹ️ [ui-screenshots] 📊 ui-screenshots: 1,810 BPE tokens [chars/4: 1,867] (detailed ✓), 16 sections, 8 code blocks
ℹ️ ✅ All checks passed (4 skill(s))
Full validator output ```text Found 4 skill(s) [image-annotations] 📊 image-annotations: 6,966 BPE tokens [chars/4: 5,956] (comprehensive ✗), 29 sections, 8 code blocks [image-annotations] ⚠ Skill is 6,966 BPE tokens (chars/4 estimate: 5,956) — "comprehensive" skills hurt performance by 2.9pp on average. Consider splitting into 2–3 focused skills. [pr-screenshots] 📊 pr-screenshots: 1,120 BPE tokens [chars/4: 1,220] (detailed ✓), 13 sections, 5 code blocks [screen-recording] 📊 screen-recording: 1,999 BPE tokens [chars/4: 2,003] (detailed ✓), 22 sections, 9 code blocks [ui-screenshots] 📊 ui-screenshots: 1,810 BPE tokens [chars/4: 1,867] (detailed ✓), 16 sections, 8 code blocks ✅ All checks passed (4 skill(s)) ```

Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Note

Copilot was unable to run its full agentic suite in this review.

Adds a new “visual PR” plugin and supporting skills documentation to help developers capture UI screenshots, annotate images, create GIF demos, and embed before/after visuals in PR descriptions.

Changes:

  • Added 4 new skills guides: UI screenshots, image annotations, screen recording, and PR screenshot embedding
  • Added Visual PR plugin README and plugin manifest (plugin.json)
  • Included code snippets/workflows for Playwright, Pillow, imageio, and (Windows) desktop capture via mss + Win32 APIs

Reviewed changes

Copilot reviewed 6 out of 10 changed files in this pull request and generated 9 comments.

Show a summary per file
File Description
skills/ui-screenshots/SKILL.md New guide for Playwright screenshots + PIL cropping + desktop window capture notes
skills/screen-recording/SKILL.md New guide for capturing frames and assembling animated GIF demos
skills/pr-screenshots/SKILL.md New guide for embedding screenshots in PRs (AzDO + GitHub)
skills/image-annotations/SKILL.md New guide for annotating images/GIFs with Pillow
plugins/visual-pr/README.md Plugin overview and examples linking the new skills
plugins/visual-pr/.github/plugin/plugin.json Plugin manifest wiring the plugin to skill directories

Comment thread skills/ui-screenshots/SKILL.md Outdated
Comment thread skills/screen-recording/SKILL.md
Comment thread skills/screen-recording/SKILL.md Outdated
Comment thread skills/screen-recording/SKILL.md Outdated
Comment thread skills/ui-screenshots/SKILL.md
Comment thread skills/screen-recording/SKILL.md
Comment thread skills/image-annotations/SKILL.md
Comment thread plugins/visual-pr/.github/plugin/plugin.json
Comment thread skills/pr-screenshots/SKILL.md Outdated
nohwnd and others added 2 commits May 22, 2026 18:24
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
The full working module (annotate_image, grid_image, diff_images) is now
included as a code block so users can save it as annotate.py and import
directly. Scrubbed project-specific labels from examples.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
@github-actions github-actions Bot added the skill-check-warning Skill validator reported warnings label May 22, 2026
…consistent placeholder

- Use mss.mss() context manager instead of mss.MSS() (ui-screenshots, screen-recording)
- Fix broken RECT struct in window+GIF combining example (screen-recording)
- Consistent projectId placeholder in AzDO upload example (pr-screenshots)

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

new-submission PR adds at least one new contribution plugin PR touches plugins skill-check-warning Skill validator reported warnings skills PR touches skills

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants