pr-evidence
Health Warn
- License — License: MIT
- Description — Repository has a description
- Active repo — Last push 0 days ago
- Low visibility — Only 8 GitHub stars
Code Pass
- Code scan — Scanned 4 files during light audit, no dangerous patterns found
Permissions Pass
- Permissions — No dangerous permissions requested
No AI report is available for this listing yet.
Agent skill that makes every pull request show its change instead of describing it. Works in Claude Code, Codex, Gemini CLI, GitHub Copilot, Cursor, and other Agent Skills–compatible agents.
pr-evidence
Make every pull request show its change, not describe it.
An Agent Skills skill: before/after screenshots for UI work,
one snippet for everything else.
| Without the skill | With the skill |
|---|---|
|
|
The same change, pull request #3, written up both ways.
The right side is an excerpt of its real description, rendered with GitHub's Markdown styles.
What it teaches your agent
| Rule | Why |
|---|---|
| UI change → before and after screenshots, same screen, device, and state | The reviewer sees what moved without reading the diff |
| Any other change → one snippet, the lines that carry it | A tour of every file hides the change |
| Capture "before" first, on the base branch | Rebuilding the old version later costs a second build |
| Clean environment: emulator, simulator, or fresh browser profile, throwaway account | Real names, hostnames, and messages stay out of a public repo |
Images on a non-merging pr-assets branch, a fresh path per capture |
GitHub has no upload API, and its cache keeps serving overwritten images |
| Six-section PR body, unless the repo has its own template | Every PR reads the same way |
The image-hosting rules are GitHub-specific; the rest applies to GitLab merge requests too.
How it works
flowchart TD
change{UI change?}
change -- yes --> before[Capture before]
before --> build[Build]
build --> after[Capture after]
after --> assets[Push to pr-assets]
assets --> table[Before/after table]
change -- no --> snippet[One snippet]
Example
This README's own redesign in pull request #3,
laid out the way the skill writes a screenshots section:
| Before | After |
|---|---|
|
|
The images live on the repository's non-merging pr-assets branch, one fresh folder per capture:
## Screenshots
| Before | After |
| --- | --- |
| ![Before][before] | ![After][after] |
[before]: https://github.com/ArefMozafari/pr-evidence/blob/pr-assets/3/1/readme-before-light.png?raw=true
[after]: https://github.com/ArefMozafari/pr-evidence/blob/pr-assets/3/1/readme-after-light.png?raw=true
Install
| Agent | Command |
|---|---|
/plugin marketplace add ArefMozafari/pr-evidence/plugin install pr-evidence@pr-evidence |
|
gemini extensions install https://github.com/ArefMozafari/pr-evidence |
|
copilot plugin marketplace add ArefMozafari/pr-evidencecopilot plugin install pr-evidence@pr-evidence |
|
npx skills add ArefMozafari/pr-evidence |
|
gh skill install ArefMozafari/pr-evidence |
Copy the skills/pr-evidence folder into your agent's skills directory:
| Agent | Directory |
|---|---|
| Claude Code | ~/.claude/skills/ |
| Codex, Gemini CLI, GitHub Copilot, Cursor, Windsurf, OpenCode, Goose, Amp | ~/.agents/skills/ |
| Cline | ~/.cline/skills/ |
Every push is checked by .github/workflows/validate.yml.
To run the same checks locally from the repository root:
uvx --from skills-ref==0.1.1 agentskills validate skills/pr-evidence
claude plugin validate --strict .claude-plugin/marketplace.json
claude plugin validate --strict .claude-plugin/plugin.json
License
MIT. See LICENSE.
Reviews (0)
Sign in to leave a review.
Leave a reviewNo results found