Menu
Use this skill when reviewing or updating tutorial screenshots.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
ALWAYS load when working in pwiz_tools/Osprey (C# port), on maccoss/osprey (Rust), or debugging Osprey-Rust parity issues.
ALWAYS load before git commit, push, or PR - team-specific commit format differs from standard conventions.
ALWAYS load when working on LabKey Server modules (MacCossLabModules, targetedms), in a LabKey enlistment directory, or on GitHub issues/PRs in LabKey repositories.
ALWAYS load when working in pwiz_tools/Skyline, on GitHub issues labeled 'skyline', or TODOs referencing Skyline code.
Invoke when starting an autonomous overnight session ("this is a nighttime autonomous session"). Sets a deep-investigation posture - premium on progress and high-definition findings, expects 5-8 hours of work without check-ins.
ALWAYS load when investigating bugs, failures, or unexpected behavior - ensures root cause analysis before attempting fixes.
| name | skyline-screenshots |
| description | Use this skill when reviewing or updating tutorial screenshots. |
When working with tutorial screenshot review or updates, consult ai/docs/screenshot-update-workflow.md.
ImageComparer location: pwiz_tools/Skyline/Executables/DevTools/ImageComparer/
Diff images saved to: ai\.tmp\{Tutorial}-{Locale}-s-{Number}-diff-{PixelCount}px.png
Key shortcuts: Ctrl+S save diff, Ctrl+Alt+C copy diff, F11 next diff, F12 revert
Decisions: Accept (valid change), Revert (restore original), Fix (BUG-XXX)
When developer says things like:
s-06 has an issue. look at the diff → Read diff image from ai.tmp, analyze changeDIA s-10 accepted → Update TODO, mark as accepteds-06, s-08 BUG-001 → Document bug affecting multiple screenshotsCheck ai\.tmp\ for recently saved diff images matching the screenshot pattern and analyze them.
Cover shots (cover.png) are composite images generated by TakeCoverShot() in tutorial tests.
Key pattern: Tests override ProcessCoverShot(Bitmap bmp) to overlay images. The base calls bmp.CleanupBorder(). On Win11, CleanupBorder() returns a new Bitmap — overrides MUST capture and return base.ProcessCoverShot(bmp), not the original bmp.
Tests with overrides: DdaTutorialTest, DiaUmpireTutorialTest, DiaSearchTutorialTest, AcquisitionComparisonTutorialTest, ExistingExperimentsTutorialTest.
Key files: TestUtil/TestFunctional.cs (ProcessCoverShot, TakeCoverShot), TestUtil/ScreenshotManager.cs (TakeShot).
See ai/docs/screenshot-update-workflow.md § "Cover Shot System" for full details.
For consistent screenshots on Windows 11:
ScreenshotProcessingExtensions.CleanupBorder11() redraws rounded corners on a white background. Uses GraphicsPath.AddArc with 8px radius (forms) or 4px (tool windows). A CONSIDER comment in the code notes that Gdi32.CreateRoundRectRgn() exists as a potential alternative but produced no meaningful visual difference when tested.