proof-of-fix

Captures before/after Playwright screenshots and posts them as Jira ticket evidence.

Updated May 11, 2026
One-click install
npx skills add https://github.com/thachrocky12345/local-agent-train-workstation --skill proof-of-fix-thachrocky12345
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: proof-of-fix
Source: https://github.com/thachrocky12345/local-agent-train-workstation/tree/main/.claude/skills/proof-of-fix
Command: npx skills add https://github.com/thachrocky12345/local-agent-train-workstation --skill proof-of-fix-thachrocky12345

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires playwright.

What problem does it solve? Verifying a bug fix and documenting it for stakeholders requires manually switching branches, rebuilding the app, taking screenshots, uploading attachments, and writing a Jira comment. This Skill automates that entire evidence-gathering workflow so the ticket contains verifiable before/after proof. ## Core Features & Use Cases - Before/After Screenshot Capture: Checks out main and the fix branch, rebuilds the Docker frontend, and captures full-page Playwright screenshots of the affected URLs, flagging pages that crash with JS errors. - Jira Attachment Upload: Uploads every screenshot as a Jira attachment via the REST API with the required XSRF bypass header. - Structured Evidence Comment: Posts a formatted markdown comment to the ticket with a before/after comparison table, description of what was broken, and the code changes that fixed it. - Use Case: After merging a fix for console errors on RGDEV-165, run the Skill with the ticket key, fix branch, and affected URLs to automatically attach visual proof and update the ticket. ## Quick Start Run the proof-of-fix skill with a Jira ticket key, the fix branch name, and the URLs to capture, for example: prove the fix for RGDEV-165 on branch RGDEV-165/fix-console-errors covering /en and /en/victorpayne.

Frequently Asked Questions about proof-of-fix

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I attach before and after screenshots to a Jira ticket?

Capture screenshots with Playwright on both the main branch and the fix branch, then upload each PNG via the Jira REST API attachments endpoint with the X-Atlassian-Token: no-check header. Finish by posting a markdown comment with a comparison table linking the attachment URLs.

How to take Playwright screenshots across two git branches?

Check out main, rebuild the frontend, and run the capture script with mode=before, then check out the fix branch, rebuild, and run it with mode=after. The script saves full-page screenshots to separate before-*.png and after-*.png files per URL.

Why does Playwright networkidle timeout on some pages?

Pages with polling requests, such as calls to ipapi.co or ipinfo.io, never reach network idle. Use waitUntil: domcontentloaded followed by a fixed waitForTimeout of about 4 seconds to let React hydration complete before screenshotting.

Can I screenshot authenticated pages with patient or private data?

No. The workflow explicitly forbids capturing authenticated routes containing patient data, appointment records, or provider notes because they may contain PHI. Only capture public-facing pages or generic empty-state dashboard shells.

What happens if a page crashes with a JavaScript error during capture?

The capture script listens for pageerror events and detects ReferenceError or TypeError crashes. It still takes the screenshot and saves it with a -CRASHED suffix, since a crashed page is itself valid before-state evidence.