visual-verification
Skill0 starsChanged 7 days agoMITView on GitHub
Visual self-correction for Vue UI through the Playwright MCP. After a layout or dashboard change, screenshot the Vite dev server and fix overlap, wrap, padding, and unstyled type before done. Uses browser_navigate, browser_resize, and browser_take_screenshot. Not Puppeteer. Not a substitute for @visual-auditor's recorded review.
6 other projects use a version of this.
Adopted by
Most recently taken up by
- imMamdouhaboammar/Mimeratheir own version, first seen Nov 8, 2026
- poooi/poitheir own version, first seen Oct 8, 2026
- nahid-sparktales/agent-dispatchertheir own version, first seen Sep 21, 2026
- LucaDominici/arbitertheir own version, first seen Sep 20, 2026
- AkshitIreddy/agent-skillstheir own version, first seen Sep 13, 2026
- SebastianKuehnau/sandbox-demotheir own version, first seen Aug 14, 2026
Other versions6 projects use a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 6
- poooi/poi★ 1.8ksame name
- nahid-sparktales/agent-dispatcher★ 59same name
- AkshitIreddy/agent-skills★ 1same name
- imMamdouhaboammar/Mimera★ 1same name
- LucaDominici/arbiter★ 0same name
- SebastianKuehnau/sandbox-demo★ 0same name
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository41 other files it gives its agents.
- AGENTS.mdAGENTS.md
- .cursor/rules/heyeddi-always-on.mdcCursor rule
- .cursor/rules/skill-authoring.mdcCursor rule
- aura-design-tokensSkill
- backend-type-bridgerSkill
- cli-interface-designSkill
- composable-patternsSkill
- dart-type-bridgerSkill
- design-handoff-flutterSkill
- design-system-generalizerSkill
- engineering-excellenceSkill
- fancy-ui-craftSkill
- flutter-engineeringSkill
- flutter-patternsSkill
- heyeddi-ci-configSkill
- heyeddi-ci-failsSkill
- heyeddi-ci-guideSkill
- heyeddi-ci-runnersSkill
- heyeddi-designSkill
- heyeddi-handoffSkill
- heyeddi-intakeSkill
- heyeddi-local-firstSkill
- heyeddi-orchestratorSkill
- heyeddi-productSkill
- heyeddi-pr-respondSkill
- heyeddi-pr-reviewSkill
- heyeddi-setupSkill
- heyeddiSkill
- layout-morphSkill
- motion-physicsSkill
- no-duplicate-uiSkill
- pre-merge-gateSkill
- primevue-auraSkill
- primevue-openprops-architectSkill
- project-engineeringSkill
- quasar-foundationSkill
- taste-penpotSkill
- ux-flow-auditorSkill
- verify-buildSkill
- visual-auditorSkill
- vue-design-systemSkill
The file
We split this skill into the rules it gives an agent
8 rules. 0 are common, 5 are distinctive, and 3 are very specific to this project.
0
Common
Most of the 5 edited versions we read keep these.
5
Distinctive
This author's own choices. Worth a look.
3
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Very specific: line 13
Do not use Puppeteer or @modelcontextprotocol/server-puppeteer.
- Distinctive: line 19
After any major UI component, layout change, or dashboard view.
- Very specific: line 20
After @motion-physics on a GUI surface.
- Distinctive: line 21
When checking a mobile drawer against the desktop layout.
- Distinctive: line 22
When contrast, overlap, or an unwanted scrollbar is in question.
- Very specific: line 24
Do not use this skill for a CLI.
- Distinctive: line 82
Read the saved PNG. Look for overlap, broken flex wrap, padding that does not match the token scale, unstyled fonts, and horizontal scroll …
- Distinctive: line 97
When you have finished the user's request for this skill, suggest what to run next:
“Common” is measured: kept by at least 6 in 10 of the 5 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Visual Verification Loop
@primevue/mcp and @quasar/mcp understand component code. They do not render pixels. This skill uses the Playwright MCP (@playwright/mcp) so the agent can see the live Vite page and fix what it sees.
Do not use Puppeteer or @modelcontextprotocol/server-puppeteer.
@visual-auditor still records the done review (contrast report, widths, fix log). Run this loop first, while the dev server is hot, and correct the code before that review.
When the agent activates this skill
- After any major UI component, layout change, or dashboard view.
- After
@motion-physicson a GUI surface. - When checking a mobile drawer against the desktop layout.
- When contrast, overlap, or an unwanted scrollbar is in question.
Do not use this skill for a CLI. Terminal alignment is @cli-interface-design (run the script, read stdout).
Feedback cycle
1. Agent writes Vue code to file
2. Vite dev server (localhost:5173) hot-reloads
3. browser_navigate, then browser_resize, then browser_take_screenshot
4. Agent inspects the rendered image
5. Agent fixes the flaw in codeRepeat until the screenshot has no overlap, broken wrap, misaligned padding, or raw unstyled type. Then stop. Do not declare the GUI task complete on an unread screenshot.
MCP server
{
"mcpServers": {
"playwright": {
"command": "npx",
"args": ["-y", "@playwright/mcp@latest"]
}
}
}Commands
The dev server must already be running at http://localhost:5173.
- Navigate. Hash routes stay on
#/…. History routes use the path with no hash.
browser_navigate
url: http://localhost:5173/#/dashboard- Resize, then screenshot. Repeat for both viewports.
browser_take_screenshotdoes not take width and height.browser_resizedoes.
| Surface | width | height | filename |
| Desktop | 1440 | 900 | .heyeddi/docs/visual-verification/dashboard-desktop.png |
| Mobile (iPhone 14) | 390 | 844 | .heyeddi/docs/visual-verification/dashboard-mobile.png |
browser_resize
width: 1440
height: 900
browser_take_screenshot
filename: .heyeddi/docs/visual-verification/dashboard-desktop.png
scale: css
fullPage: trueThen the same pair at 390×844 with dashboard-mobile.png.
- Read the saved PNG. Look for overlap, broken flex wrap, padding that does not match the token scale, unstyled fonts, and horizontal scroll that the layout did not intend.
- Edit the Vue or CSS. Wait for HMR. Screenshot again. One fix round is the default. A second round only if the first screenshot still shows a defect.
browser_snapshot is the accessibility tree. Use it to find a control. Use browser_take_screenshot when the question is visual.
Instructions
- Confirm
http://localhost:5173responds. If it does not, start the Vite server the project already uses, then navigate. - Capture desktop and mobile before calling the screen done.
- Fix code. Do not answer with a list of flaws and leave them.
@visual-auditorruns after this loop when the pipeline asks for a recorded review. Do not skip that gate by treating this screenshot as the audit file.
When the task is complete: suggest next skills
When you have finished the user's request for this skill, suggest what to run next:
Run:
python .agents/skills/heyeddi/scripts/suggest_next_skill.py --current-skill visual-verification --project-root .- Include the script's
### Next stepblock in your final reply.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

