visual-qa
Complete visual QA - screenshots with full-page scroll to trigger animations, then analyze with Claude. Run after CSS/template changes.
Best use case
visual-qa is best used when you need a repeatable AI agent workflow instead of a one-off prompt.
Complete visual QA - screenshots with full-page scroll to trigger animations, then analyze with Claude. Run after CSS/template changes.
Teams using visual-qa should expect a more consistent output, faster repeated execution, less prompt rewriting.
When to use this skill
- You want a reusable workflow that can be run more than once with consistent structure.
When not to use this skill
- You only need a quick one-off answer and do not need a reusable workflow.
- You cannot install or maintain the underlying files, dependencies, or repository context.
Installation
Claude Code / Cursor / Codex
Manual Installation
- Download SKILL.md from GitHub
- Place it in
.claude/skills/visual-qa/SKILL.mdinside your project - Restart your AI agent — it will auto-discover the skill
How visual-qa Compares
| Feature / Agent | visual-qa | Standard Approach |
|---|---|---|
| Platform Support | Not specified | Limited / Varies |
| Context Awareness | High | Baseline |
| Installation Complexity | Unknown | N/A |
Frequently Asked Questions
What does this skill do?
Complete visual QA - screenshots with full-page scroll to trigger animations, then analyze with Claude. Run after CSS/template changes.
Where can I find the source code?
You can find the source code on GitHub using the link provided at the top of the page.
SKILL.md Source
# Visual QA Skill Automated visual testing that properly handles GSAP animations by scrolling through the entire page before capturing screenshots. ## Usage Ask Claude to run visual QA: - "Run visual QA on the CSR site" - "Take screenshots of all pages and analyze them" - "Check the visual state of the website" ## What This Skill Does 1. **Full-Page Scroll** - Scrolls through entire page in increments to trigger all GSAP/ScrollTrigger animations 2. **Multi-Device Screenshots** - Desktop (1920px), Tablet (768px), Mobile (375px) 3. **Parallel Processing** - Uses Haiku sub-agents to analyze multiple pages simultaneously 4. **Visual Analysis** - Reviews screenshots for issues ## Pages Tested | Page | URL | |------|-----| | Home | https://csrdevelopment.com/ | | About | https://csrdevelopment.com/about/ | | Portfolio | https://csrdevelopment.com/portfolio/ | | Contact | https://csrdevelopment.com/contact/ | | Privacy Policy | https://csrdevelopment.com/privacy-policy/ | | Terms | https://csrdevelopment.com/terms-of-service/ | ## Screenshot Script Location: `/root/.claude/skills/visual-qa/screenshot.py` ### Single Page ```bash python3 /root/.claude/skills/visual-qa/screenshot.py --url https://csrdevelopment.com/about/ ``` ### All Pages ```bash python3 /root/.claude/skills/visual-qa/screenshot.py --all ``` ### Output Screenshots saved to: `/home/dev/screenshots/` ## Parallel Analysis with Haiku When running full visual QA, launch multiple Haiku agents to analyze different pages simultaneously: ``` Agent 1: Analyze Home + About screenshots Agent 2: Analyze Portfolio + Contact screenshots Agent 3: Analyze Legal pages screenshots ``` ## Visual QA Checklist ### All Pages - [ ] Header visible and logo centered - [ ] Menu button works - [ ] Footer links present - [ ] No horizontal scroll - [ ] Text readable at all sizes ### Home Page - [ ] Hero video/image loaded - [ ] Hero text visible (not opacity 0) - [ ] Property cards show with images - [ ] Animations completed ### About Page - [ ] Team member photos loaded (not placeholders) - [ ] Bio text visible - [ ] Images have grayscale filter ### Portfolio - [ ] Property grid displays - [ ] Status badges visible - [ ] Different images for each property ### Contact - [ ] Form fields visible - [ ] Contact info displayed - [ ] Submit button styled ### Property Detail - [ ] Hero image loaded - [ ] Property details sidebar - [ ] Inquiry form present
Related Skills
visualization-best-practices
Visualization Best Practices - Auto-activating skill for Data Analytics. Triggers on: visualization best practices, visualization best practices Part of the Data Analytics skill category.
performing-visual-regression-testing
This skill enables Claude to execute visual regression tests using tools like Percy, Chromatic, and BackstopJS. It captures screenshots, compares them against baselines, and analyzes visual differences to identify unintended UI changes. Use this skill when the user requests visual testing, UI change verification, or regression testing for a web application or component. Trigger phrases include "visual test," "UI regression," "check visual changes," or "/visual-test".
tensorboard-visualizer
Tensorboard Visualizer - Auto-activating skill for ML Training. Triggers on: tensorboard visualizer, tensorboard visualizer Part of the ML Training skill category.
neurodivergent-visual-org
Creates ADHD-friendly visual organizational tools using Mermaid diagrams optimized for neurodivergent thinking patterns. Auto-detects overwhelm, provides compassionate task breakdowns with realistic time estimates. Use when creating visual task breakdowns, decision trees, or organizational diagrams for neurodivergent users or accessibility-focused projects. Trigger with 'neurodivergent', 'visual', 'org'.
database-schema-visualizer
Database Schema Visualizer - Auto-activating skill for Visual Content. Triggers on: database schema visualizer, database schema visualizer Part of the Visual Content skill category.
data-visualization-helper
Data Visualization Helper - Auto-activating skill for Visual Content. Triggers on: data visualization helper, data visualization helper Part of the Visual Content skill category.
creating-data-visualizations
This skill enables Claude to generate data visualizations, plots, charts, and graphs from provided data. It analyzes the data, selects the most appropriate visualization type, and creates a visually appealing and informative graphic. Use this skill when the user requests a visualization, plot, chart, or graph; when data needs to be presented visually; or when exploring data patterns. The skill is triggered by requests for "visualization", "plot", "chart", or "graph".
Inline Visualizer
Render rich visual content — SVG diagrams, HTML interactive widgets, charts — directly inline in a chat conversation. Output streams token-by-token into a sandboxed iframe. The result feels like a natural extension of the conversation, not an attachment.
visual-design-foundations
Apply typography, color theory, spacing systems, and iconography principles to create cohesive visual designs. Use when establishing design tokens, building style guides, or improving visual hierarchy and consistency.
ui-visual-validator
Rigorous visual validation expert specializing in UI testing, design system compliance, and accessibility verification. Masters screenshot analysis, visual regression testing, and component validation. Use PROACTIVELY to verify UI modifications have achieved their intended goals through comprehensive visual analysis.
azure-resource-visualizer
Analyze Azure resource groups and generate detailed Mermaid architecture diagrams showing the relationships between individual resources. USE FOR: create architecture diagram, visualize Azure resources, show resource relationships, generate Mermaid diagram, analyze resource group, diagram my resources, architecture visualization, resource topology, map Azure infrastructure DO NOT USE FOR: creating/modifying resources (use azure-deploy), security scanning (use azure-security), performance troubleshooting (use azure-diagnostics), code generation (use relevant service skill)
pitch-deck-visuals
Investor pitch deck structure with slide-by-slide framework, visual design rules, and data presentation. Covers the 12-slide framework, chart types, team slides, and common investor turn-offs. Use for: fundraising decks, investor presentations, startup pitch, demo day, grant proposals. Triggers: pitch deck, investor deck, startup pitch, fundraising deck, demo day, pitch presentation, investor presentation, seed deck, series a deck, pitch slides, startup presentation, vc pitch, investor meeting