Skip to content
cccskills
FreePublished on GitHub

workflow-progress-screenshots

Document visual work with real screenshots captured before a change, during key interactions, and after completion. Inspect each image and share captioned files throughout the task so users can review progress and redirect the work early.

OriginalShow the original description

Show the user real screenshots of the work as it progresses, without being asked. Capture the start, the key moment and the result of every visual change, send them as files with captions as soon as each is ready, and look at every image before sending it. Use on any task with a visible result (UI, pages, games, 3D, charts, motion), when the user says "show me", "screenshots", "keep giving me screenshots" or "where are the screenshots?", and before any report that claims a visual change works.

See how to install

Good for

  • Reviewing UI changes during implementation
  • Comparing a visual bug before and after a fix
  • Checking game and 3D scenes through screenshots
  • Showing animation progress with a sequence of frames

Files included (3)

  • SKILL.md4.1 KB
  • scripts/capture.mjs6.2 KB
  • scripts/compare.py1.9 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

Workflow: progress screenshots

The user judges visual work by looking at it, and asks for screenshots in almost every thread:

  • "keep giving me screenshots"
  • "send screenshots every pass"
  • "can you give me screenshots of those?"
  • "I still don't see the screenshots. Where are they?"

Describing a change is not showing it. A screenshot mentioned but not sent doesn't count.

Rules

  1. Send, don't describe. Use the host's file-sending tool (SendUserFile, or an inline image in the report) so the picture is in front of the user. A path in a sentence is not enough.

  2. Unasked, and as you go. Send a picture after each meaningful pass, so the user can redirect early:

    • the first working version;
    • each big fix;
    • each round of a scoring loop.

    Don't hold them all for the final report. Don't flood them either: one small batch per pass, not every save.

  3. Start, key moment, result. For any change with a before and after, capture all three with the same framing: the state before, the interaction (hovering, aiming, mid-animation, the panel opening), and the outcome. For fixes, show the bug, then the fix.

  4. Real renders only. Capture the actual page, game or app, not a mockup or an idea of it. Set up the state with a review fixture, a URL flag or a debug hook, rather than describing it.

  5. Look at every image before sending. Things that mean recapture:

    • stray toasts or hover pins;
    • half-loaded art or missing fonts;
    • the wrong scene, or stale numbers.

    If the picture doesn't show what the caption claims, it isn't evidence.

  6. Caption what it proves. One line per picture: what changed and what it verifies. For example, "Before: the hint reads 'out of range'. After: '90% hit · 5 damage'."

  7. Label honestly. Say "headless browser capture" or "browser viewport". A 390×844 viewport is a phone-sized browser check, not a device test. Scripted or staged moments are named as staged.

  8. Same framing for comparisons. Use the same viewport, camera and state for before and after. Put them side by side with compare.py.

How to capture

  • The in-app browser pane is fine while it's visible. A hidden pane stalls requestAnimationFrame and returns stale or black frames, so use headless capture then.
  • Headless: scripts/capture.mjs <url> <out.png>, with WIDTH/HEIGHT, MOBILE=1, WAIT_FOR="<ready expression>", SETTLE=<ms>, and JS steps to click, open or scroll. It prints page errors, so a broken page gets caught instead of photographed.
    • 1600×900 for desktop, MOBILE=1 for a 390×844 phone viewport.
    • SETTLE=3000–5000 for WebGL or 3D scenes; they render slowly headless, and an early shot misses models, fonts and icons.
    • Run captures one at a time. Parallel headless Chrome on a busy machine gives protocol errors and missed frames.
  • Side by side: scripts/compare.py out.jpg before.png "Before" after.png "After", or three panels for start, key moment and result.
  • Motion: a still misses what moves. Take a short burst of frames through the effect, and slow the page clock if the app exposes one. Or send a strip of frames.
  • If the project names a specific capture tool (for example "use the Codex browser"), use it.
  • Keep capture scripts and output in a gitignored folder inside the project (such as qa/captures/), not a scratchpad the app wipes on restart.

In the final report

  • The screenshots go inline, each with its caption, after the summary of what changed.
  • Say which were headless captures, and which viewport a phone check used.
  • If something couldn't be captured, say so and why. Don't substitute a description.

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

Build woven fabric in Three.js with visible threads, realistic sheen, seams, and thick hems. The skill covers folds that preserve texture proportions, light passing through thin cloth, and variations in dye and wear.

  • Creating backlit curtains
  • Differentiating linen, silk, and wool
  • Adding hems and stitches for close-up views
MengTo/Skills6.8KUpdated Oct 18, 2026

Build falling leaves in Three.js and similar 3D scenes, with visible front, edge, and back views as they tumble and drift. Coordinate wind, scene depth, camera-aware recycling, and performance checks for a convincing autumn effect.

  • Adding falling autumn leaves to a 3D scene
  • Coordinating leaf tumble, sideways drift, and wind
  • Managing leaves around buildings and camera movement
MengTo/Skills6.8KUpdated Oct 18, 2026

3d-four-seasons

FreeSummary

Add coordinated seasonal transitions to an existing 3D scene. Blend foliage, lighting, sky, ground, snow, and particles from one shared state while preserving camera controls and interactions, so the same place remains recognizable throughout spring, summer, fall, and winter.

  • Add a four-season selector to an outdoor 3D scene
  • Show seasonal changes in an architectural walkthrough
  • Coordinate foliage, sunlight, sky, and ground appearance
MengTo/Skills6.8KUpdated Oct 18, 2026

Create or integrate detailed 3D models with smooth outlines and believable edges for close-up views. Prepare lower-detail versions for distant viewing, prioritize loading, and measure rendering costs in the actual scene.

  • Creating a detailed 3D model for close-up views
  • Replacing visibly faceted curves with smoother geometry
  • Preparing detailed architectural assets for rendering
MengTo/Skills6.8KUpdated Oct 18, 2026

Prepare detailed 3D materials that remain clear in close-up views. The skill guides texture resolution, physically based material maps, surface mapping, filtering, and progressive loading while checking download size and GPU memory use.

  • Prepare wood, stone, and fabric materials for close-up views
  • Fix texture seams, grain direction, and normal map orientation
  • Preserve floor and foliage detail at oblique or distant views
MengTo/Skills6.8KUpdated Oct 18, 2026

Create realistic metal surfaces in Three.js by combining structured reflections, studio lighting, scratches, fingerprints, and beveled edges. Includes polished, brushed, and aged finishes for objects such as tools, rings, and metal product parts.

  • Fixing metal that looks like gray plastic
  • Creating polished or brushed metal finishes
  • Adding patina and worn edges
MengTo/Skills6.8KUpdated Oct 18, 2026

See all skills by MengTo

Report a problem with this skill