code-yeongyu/oh-my-openagent / packages/shared-skills/skills/visual-qa
visual-qa
VerifiedRuns rigorous visual QA across web, terminal, and paginated surfaces: an Apple HIG-based checklist, paired light/dark captures at phone and desktop widths, screenshot evidence, and a per-item PASS/FAIL verdict. Use for any UI build or change, or when asked whether a page, component, or TUI looks right or follows the platform's design guidelines.
| File | Kind | Size |
|---|---|---|
| AGENTS.md | markdown | 3.2 KB |
| SKILL.md | skill md | 45.7 KB |
| references/browser-setup.md | markdown | 5.6 KB |
| scripts/ansi.test.ts | script | 1.1 KB |
| scripts/ansi.ts | script | 496 B |
| scripts/cli.test.ts | script | 2.9 KB |
| scripts/cli.ts | script | 2.5 KB |
| scripts/east-asian-width.test.ts | script | 1.9 KB |
| scripts/east-asian-width.ts | script | 3.0 KB |
| scripts/image-diff.test.ts | script | 2.5 KB |
| scripts/image-diff.ts | script | 3.8 KB |
| scripts/png-crc.ts | script | 707 B |
| scripts/png-decode.test.ts | script | 1.5 KB |
| scripts/png-decode.ts | script | 5.5 KB |
| scripts/png-synth.ts | script | 1.7 KB |
| scripts/skill-doc-fields.test.ts | script | 1.6 KB |
| scripts/tui-grid.test.ts | script | 1.9 KB |
| scripts/tui-grid.ts | script | 2.7 KB |
| scripts/types.ts | script | 1.3 KB |
| scripts/visual-qa.mjs | script | 15.8 KB |
scripts/cli.test.ts
View on GitHubimport { describe, expect, onTestFinished, test } from "bun:test"
import { mkdtempSync, rmSync, writeFileSync } from "node:fs"
import { tmpdir } from "node:os"
import { join } from "node:path"
import { run, runImageDiff, runTuiCheck } from "./cli"
import { encodeRgbaPng, solidRgba } from "./png-synth"
function tempDir(): string {
const dir = mkdtempSync(join(tmpdir(), "visual-qa-"))
onTestFinished(() => rmSync(dir, { recursive: true, force: true }))
return dir
}
describe("runImageDiff", () => {
test("#given two identical PNG files #when diffed #then similarity is 100", () => {
// given
const dir = tempDir()
const reference = join(dir, "reference.png")
const actual = join(dir, "actual.png")
writeFileSync(reference, encodeRgbaPng(2, 2, solidRgba(2, 2, [1, 2, 3, 255])))
writeFileSync(actual, encodeRgbaPng(2, 2, solidRgba(2, 2, [1, 2, 3, 255])))
// when
const result = runImageDiff([reference, actual])
// then
expect(result.command).toBe("image-diff")
expect(result.similarityScore).toBe(100)
expect(result.dimensionsMatch).toBe(true)
})
test("#given missing arguments #when diffed #then it throws a usage error", () => {
// given / when / then
expect(() => runImageDiff([])).toThrow("usage")
})
})
describe("runTuiCheck", () => {
test("#given a CJK capture file #when checked #then widths count wide characters", () => {
// given
const dir = tempDir()
const file = join(dir, "capture.txt")
writeFileSync(file, "가나\nhello")
// when
const result = runTuiCheck([file, "--cols", "40"])
// then
expect(result.command).toBe("tui-check")
expect(result.expectedColumns).toBe(40)
expect(result.lineWidths).toEqual([4, 5])
})
})
describe("run dispatch", () => {
test("#given an unknown command #when run #then it throws", () => {
// given / when / then
expect(() => run(["bogus"])).toThrow("unknown command")
})
})
describe("cli entry", () => {
test("#given the Node bundle is spawned for image-diff without Bun on PATH #when it runs #then it prints JSON and exits zero", () => {
// given
const dir = tempDir()
const reference = join(dir, "reference.png")
const actual = join(dir, "actual.png")
writeFileSync(reference, encodeRgbaPng(2, 2, solidRgba(2, 2, [0, 0, 0, 255])))
writeFileSync(actual, encodeRgbaPng(2, 2, solidRgba(2, 2, [255, 255, 255, 255])))
const nodePath = Bun.which("node")
if (nodePath === null) throw new Error("node not found on PATH")
// when
const proc = Bun.spawnSync({
cmd: [nodePath, join(import.meta.dir, "visual-qa.mjs"), "image-diff", reference, actual],
env: { ...process.env, PATH: "/usr/bin:/bin" },
})
// then
expect(proc.exitCode).toBe(0)
const parsed: Record<string, unknown> = JSON.parse(proc.stdout.toString())
expect(parsed["command"]).toBe("image-diff")
expect(parsed["similarityScore"]).toBe(0)
})
})
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| finishing-a-development-branchobra/superpowersUse when implementation is complete, all tests pass, and you need to decide how to integrate the work | Stars: 321k | Updated | Claude CodeCodex | Verified | Install |
| systematic-debuggingobra/superpowersUse when encountering any bug, test failure, or unexpected behavior, before proposing fixes | Stars: 321k | Updated | Claude CodeCodex | Verified | Install |
| test-driven-developmentobra/superpowersUse when implementing any feature or bugfix, before writing implementation code | Stars: 321k | Updated | Claude CodeCodex | Verified | Install |
| skill-creatoranthropics/skillsCreate new skills, modify and improve existing skills, and measure skill performance. Use when users want to create a skill from scratch, edit, or optimize an existing skill, run evals to test a skill, benchmark skill performance with variance analysis, or optimize a skill's description for better triggering accuracy. | Stars: 197k | Updated | Claude CodeCodex | Verified | Install |