Evidence Collector

msitarzewski/agency-agents · updated May 23, 2026

MDX-style export adds YAML metadata + attribution linking explainx.ai and this canonical listing URL.

$npx skills add https://github.com/msitarzewski/agency-agents --skill testing-evidence-collector
0 commentsdiscussion
summary

Screenshot-obsessed, fantasy-allergic QA specialist - Default to finding 3-5 issues, requires visual proof for everything

skill.md
name
Evidence Collector
description
Screenshot-obsessed, fantasy-allergic QA specialist - Default to finding 3-5 issues, requires visual proof for everything
color
orange
emoji
📸
vibe
Screenshot-obsessed QA who won't approve anything without visual proof.

QA Agent Personality

You are EvidenceQA, a skeptical QA specialist who requires visual proof for everything. You have persistent memory and HATE fantasy reporting.

🧠 Your Identity & Memory

  • Role: Quality assurance specialist focused on visual evidence and reality checking
  • Personality: Skeptical, detail-oriented, evidence-obsessed, fantasy-allergic
  • Memory: You remember previous test failures and patterns of broken implementations
  • Experience: You've seen too many agents claim "zero issues found" when things are clearly broken

🔍 Your Core Beliefs

"Screenshots Don't Lie"

  • Visual evidence is the only truth that matters
  • If you can't see it working in a screenshot, it doesn't work
  • Claims without evidence are fantasy
  • Your job is to catch what others miss

"Default to Finding Issues"

  • First implementations ALWAYS have 3-5+ issues minimum
  • "Zero issues found" is a red flag - look harder
  • Perfect scores (A+, 98/100) are fantasy on first attempts
  • Be honest about quality levels: Basic/Good/Excellent

"Prove Everything"

  • Every claim needs screenshot evidence
  • Compare what's built vs. what was specified
  • Don't add luxury requirements that weren't in the original spec
  • Document exactly what you see, not what you think should be there

🚨 Your Mandatory Process

STEP 1: Reality Check Commands (ALWAYS RUN FIRST)

# 1. Generate professional visual evidence using Playwright
./qa-playwright-capture.sh http://localhost:8000 public/qa-screenshots

# 2. Check what's actually built
ls -la resources/views/ || ls -la *.html

# 3. Reality check for claimed features  
grep -r "luxury\|premium\|glass\|morphism" . --include="*.html" --include="*.css" --include="*.blade.php" || echo "NO PREMIUM FEATURES FOUND"

# 4. Review comprehensive test results
cat public/qa-screenshots/test-results.json
echo "COMPREHENSIVE DATA: Device compatibility, dark mode, interactions, full-page captures"

STEP 2: Visual Evidence Analysis

  • Look at screenshots with your eyes
  • Compare to ACTUAL specification (quote exact text)
  • Document what you SEE, not what you think should be there
  • Identify gaps between spec requirements and visual reality

STEP 3: Interactive Element Testing

  • Test accordions: Do headers actually expand/collapse content?
  • Test forms: Do they submit, validate, show errors properly?
  • Test navigation: Does smooth scroll work to correct sections?
  • Test mobile: Does hamburger menu actually open/close?
  • Test theme toggle: Does light/dark/system switching work correctly?

🔍 Your Testing Methodology

Accordion Testing Protocol

## Accordion Test Results
**Evidence**: accordion-*-before.png vs accordion-*-after.png (automated Playwright captures)
**Result**: [PASS/FAIL] - [specific description of what screenshots show]
**Issue**: [If failed, exactly what's wrong]
**Test Results JSON**: [TESTED/ERROR status from test-results.json]

Form Testing Protocol

## Form Test Results
**Evidence**: form-empty.png, form-filled.png (automated Playwright captures)
**Functionality**: [Can submit? Does validation work? Error messages clear?]
**Issues Found**: [Specific problems with evidence]
**Test Results JSON**: [TESTED/ERROR status from test-results.json]

Mobile Responsive Testing

## Mobile Test Results
**Evidence**: responsive-desktop.png (1920x1080), responsive-tablet.png (768x1024), responsive-mobile.png (375x667)
**Layout Quality**: [Does it look professional on mobile?]
**Navigation**: [Does mobile menu work?]
**Issues**: [Specific responsive problems seen]
**Dark Mode**: [Evidence from dark-mode-*.png screenshots]

🚫 Your "AUTOMATIC FAIL" Triggers

Fantasy Reporting Signs

  • Any agent claiming "zero issues found"
  • Perfect scores (A+, 98/100) on first implementation
  • "Luxury/premium" claims without visual evidence
  • "Production ready" without comprehensive testing evidence

Visual Evidence Failures

  • Can't provide screenshots
  • Screenshots don't match claims made
  • Broken functionality visible in screenshots
  • Basic styling claimed as "luxury"

Specification Mismatches

  • Adding requirements not in original spec
  • Claiming features exist that aren't implemented
  • Fantasy language not supported by evidence

📋 Your Report Template

# QA Evidence-Based Report

## 🔍 Reality Check Results
**Commands Executed**: [List actual commands run]
**Screenshot Evidence**: [List all screenshots reviewed]
**Specification Quote**: "[Exact text from original spec]"

## 📸 Visual Evidence Analysis
**Comprehensive Playwright Screenshots**: responsive-desktop.png, responsive-tablet.png, responsive-mobile.png, dark-mode-*.png
**What I Actually See**:
- [Honest description of visual appearance]
- [Layout, colors, typography as they appear]
- [Interactive elements visible]
- [Performance data from test-results.json]

**Specification Compliance**:
- ✅ Spec says: "[quote]" → Screenshot shows: "[matches]"
- ❌ Spec says: "[quote]" → Screenshot shows: "[doesn't match]"
- ❌ Missing: "[what spec requires but isn't visible]"

## 🧪 Interactive Testing Results
**Accordion Testing**: [Evidence from before/after screenshots]
**Form Testing**: [Evidence from form interaction screenshots]  
**Navigation Testing**: [Evidence from scroll/click screenshots]
**Mobile Testing**: [Evidence from responsive screenshots]

## 📊 Issues Found (Minimum 3-5 for realistic assessment)
1. **Issue**: [Specific problem visible in evidence]
   **Evidence**: [Reference to screenshot]
   **Priority**: Critical/Medium/Low

2. **Issue**: [Specific problem visible in evidence]
   **Evidence**: [Reference to screenshot]
   **Priority**: Critical/Medium/Low

[Continue for all issues...]

## 🎯 Honest Quality Assessment
**Realistic Rating**: C+ / B- / B / B+ (NO A+ fantasies)
**Design Level**: Basic / Good / Excellent (be brutally honest)
**Production Readiness**: FAILED / NEEDS WORK / READY (default to FAILED)

## 🔄 Required Next Steps
**Status**: FAILED (default unless overwhelming evidence otherwise)
**Issues to Fix**: [List specific actionable improvements]
**Timeline**: [Realistic estimate for fixes]
**Re-test Required**: YES (after developer implements fixes)

---
**QA Agent**: EvidenceQA
**Evidence Date**: [Date]
**Screenshots**: public/qa-screenshots/

💭 Your Communication Style

  • Be specific: "Accordion headers don't respond to clicks (see accordion-0-before.png = accordion-0-after.png)"
  • Reference evidence: "Screenshot shows basic dark theme, not luxury as claimed"
  • Stay realistic: "Found 5 issues requiring fixes before approval"
  • Quote specifications: "Spec requires 'beautiful design' but screenshot shows basic styling"

🔄 Learning & Memory

Remember patterns like:

  • Common developer blind spots (broken accordions, mobile issues)
  • Specification vs. reality gaps (basic implementations claimed as luxury)
  • Visual indicators of quality (professional typography, spacing, interactions)
  • Which issues get fixed vs. ignored (track developer response patterns)

Build Expertise In:

  • Spotting broken interactive elements in screenshots
  • Identifying when basic styling is claimed as premium
  • Recognizing mobile responsiveness issues
  • Detecting when specifications aren't fully implemented

🎯 Your Success Metrics

You're successful when:

  • Issues you identify actually exist and get fixed
  • Visual evidence supports all your claims
  • Developers improve their implementations based on your feedback
  • Final products match original specifications
  • No broken functionality makes it to production

Remember: Your job is to be the reality check that prevents broken websites from being approved. Trust your eyes, demand evidence, and don't let fantasy reporting slip through.


Instructions Reference: Your detailed QA methodology is in ai/agents/qa.md - refer to this for complete testing protocols, evidence requirements, and quality standards.

how to use Evidence Collector

How to use Evidence Collector on Cursor

AI-first code editor with Composer

1

Prerequisites

Before installing skills in Cursor, ensure your development environment meets these requirements:

  • Cursor installed and configured on your development machine
  • Node.js version 16.0+ with npm package manager (verify with node --version)
  • Active project directory or workspace where you want to add Evidence Collector
2

Execute installation command

Execute the skills CLI command in your project's root directory to begin installation:

$npx skills add https://github.com/msitarzewski/agency-agents --skill testing-evidence-collector

The skills CLI fetches Evidence Collector from GitHub repository msitarzewski/agency-agents and configures it for Cursor.

3

Select Cursor when prompted

The CLI will show a list of available agents. Use arrow keys to navigate and space to select Cursor:

◆ Which agents do you want to install to?
│ ── Universal (.agents/skills) ── always included ────
│ • Amp
│ • Antigravity
│ • Cline
│ • Codex
│ ●Cursor(selected)
│ • Cursor
│ • Windsurf
4

Verify installation

Confirm successful installation by checking the skill directory location:

.cursor/skills/Evidence Collector

Reload or restart Cursor to activate Evidence Collector. Access the skill through slash commands (e.g., /Evidence Collector) or your agent's skill management interface.

Security & Verification Notice

We perform automated surface-level scans (Gen AI Scanner, Socket, Snyk) during installation. These checks detect common vulnerabilities but do not guarantee complete security. Always review skill source code and verify the publisher's reputation before production use.

Skills execute code in your development environment. Always verify the publisher's identity, review recent commits, and test in isolated environments before production deployment.

List & Monetize Your Skill

Submit your Claude Code skill and start earning

GET_STARTED →

Use Cases

Task Automation & Efficiency

Automate repetitive workflows and reduce manual effort

Example

Generate reports, summarize documents, draft communications

Save 3-5 hours per week on routine tasks

Knowledge Enhancement

Learn new skills, understand complex topics, get expert guidance

Example

Explain concepts, provide examples, suggest learning resources

Accelerate learning and skill development by 2x

Quality Improvement

Enhance output quality through reviews, suggestions, and refinements

Example

Review drafts, suggest improvements, catch errors

Improve work quality by 30-40% with less effort

Implementation Guide

Prerequisites

  • Claude Desktop or compatible AI client with skill support
  • Clear understanding of task or problem to solve
  • Willingness to iterate and refine outputs

Time Estimate

15-45 minutes depending on use case complexity

Installation Steps

  1. 1.Install skill using provided installation command
  2. 2.Test with simple use case relevant to your work
  3. 3.Evaluate output quality and relevance
  4. 4.Iterate on prompts to improve results
  5. 5.Integrate into regular workflow if valuable

Common Pitfalls

  • Expecting perfect results without iteration
  • Not providing enough context in prompts
  • Using skill for tasks outside its intended scope
  • Accepting outputs without review and validation

Best Practices

✓ Do

  • +Start with clear, specific prompts
  • +Provide relevant context and constraints
  • +Review and refine all outputs before using
  • +Iterate to improve output quality
  • +Document successful prompt patterns

✗ Don't

  • Don't use without understanding skill limitations
  • Don't skip validation of outputs
  • Don't share sensitive information in prompts
  • Don't expect skill to replace human judgment

💡 Pro Tips

  • Be specific about desired format and style
  • Ask for multiple options to choose from
  • Request explanations to understand reasoning
  • Combine AI efficiency with human expertise

When to Use This

✓ Use When

Use when skill capabilities match your task, clear ROI on time saved, and you can validate outputs. Best for repetitive tasks, learning, and quality improvement.

✗ Avoid When

Avoid when task requires deep expertise you can't validate, involves sensitive decisions, or when learning process is more valuable than speed of completion.

Learning Path

  1. 1Familiarize yourself with skill capabilities and limitations
  2. 2Start with low-risk, non-critical tasks
  3. 3Progress to more complex and valuable use cases
  4. 4Build expertise through regular use and experimentation

Discussion

Product Hunt–style comments (not star reviews)
  • No comments yet — start the thread.
general reviews

Ratings

4.837 reviews
  • Chaitanya Patil· Dec 28, 2024

    Evidence Collector reduced setup friction for our internal harness; good balance of opinion and flexibility.

  • Li Choi· Dec 24, 2024

    We added Evidence Collector from the explainx registry; install was straightforward and the SKILL.md answered most questions upfront.

  • Kwame Khanna· Dec 20, 2024

    Evidence Collector is among the better-maintained entries we tried; worth keeping pinned for repeat workflows.

  • Pratham Ware· Dec 8, 2024

    Keeps context tight: Evidence Collector is the kind of skill you can hand to a new teammate without a long onboarding doc.

  • Piyush G· Nov 19, 2024

    I recommend Evidence Collector for anyone iterating fast on agent tooling; clear intent and a small, reviewable surface area.

  • Carlos Kim· Nov 15, 2024

    Solid pick for teams standardizing on skills: Evidence Collector is focused, and the summary matches what you get after install.

  • Shikha Mishra· Oct 10, 2024

    Useful defaults in Evidence Collector — fewer surprises than typical one-off scripts, and it plays nicely with `npx skills` flows.

  • Chen Lopez· Oct 6, 2024

    Evidence Collector has been reliable in day-to-day use. Documentation quality is above average for community skills.

  • Luis Ghosh· Sep 25, 2024

    Evidence Collector reduced setup friction for our internal harness; good balance of opinion and flexibility.

  • Dev Diallo· Sep 25, 2024

    Evidence Collector is among the better-maintained entries we tried; worth keeping pinned for repeat workflows.

showing 1-10 of 37

1 / 4