# Visual Evidence

> Visual Evidence is an Agent Skill for documents published in the iamfakeguru/agent-md repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

Use for UI changes in an agent-md repository; captures a screenshot and writes the structured markdown evidence required by the visual hook.

- Skill name: `visual-evidence`
- Category: [Documents](https://www.openparable.com/skill/documents/1)
- Source: https://github.com/iamfakeguru/agent-md/blob/HEAD/.agents/skills/visual-evidence/SKILL.md
- Repository: iamfakeguru/agent-md (961 GitHub stars when collected)

## SKILL.md

# Visual Evidence

Use this skill for any UI-facing change.

1. Build or start the app in the normal project-specific way.
2. Capture the changed route with:

```bash
./.agent-md/bin/playwright-capture.sh <url> .agent/visual/<name>.png
```

3. Write a markdown note next to the image under `.agent/visual/`.
4. The note must reference the image filename and include these fields:

```markdown
# Visual Check

Changed files:
- <path>

Route: <url or route>
Viewport: <width>x<height>
Artifact: <image filename>
Observed result: <what was verified>
```

5. Use an independent verifier when possible: another agent, a browser screenshot inspection, or the human.
6. Do not self-grade visual correctness from code alone.

---

Source: https://www.openparable.com/skill/documents/visual-evidence (OpenParable). Cite the canonical URL above.