validation-and-qa

Defines evidence standards, test-writing runbooks, and acceptance criteria for verifying code changes.

Updated Jul 3, 2026
One-click install
npx skills add https://github.com/MarineTeam/fable-video --skill validation-and-qa-marineteam
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: validation-and-qa
Source: https://github.com/MarineTeam/fable-video/tree/main/.claude/skills/validation-and-qa
Command: npx skills add https://github.com/MarineTeam/fable-video --skill validation-and-qa-marineteam

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? It prevents unverified claims like "tests pass" or "this fixes it" by enforcing a strict evidence discipline: predictions written before running commands, fresh command output compared against predictions, and honest labeling of anything unobserved. ## Core Features & Use Cases - Evidence Bar: A four-part test that separates real evidence (predicted, run, compared, pasteable output) from reasoning-as-evidence or pasted expectations. - Three Gates: Documents the repo's lint, vitest, and Next.js build gates with exact predicted outputs and known baselines. - Test-Writing Runbook: Step-by-step instructions for adding vitest files under lib/tests, including env snapshot/restore patterns and placement verification with npx vitest list. - Use Case: Before writing "this fixes the share TTL bug" in a PR description, use this Skill to write the done-criteria, add a regression test for clampShareHours, run the gates, and paste the actual output as evidence. ## Quick Start Ask the AI to define done-criteria and the exact verification commands with predicted outputs for the change you are about to make.

Frequently Asked Questions about validation-and-qa

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I add a unit test to a Next.js lib module with vitest?

Create the file at lib/__tests__/<module>.test.js so it matches the vitest include glob, import describe/expect/it from vitest, and assert on pure function return values. Verify collection with npx vitest list, then run npx vitest run on the single file before the full suite.

What counts as evidence that a code change works?

Evidence requires four things: a written prediction of exact output before running, a fresh run of the real command in the current checkout, a match between prediction and actual output, and pasteable command output. Reading code or recalling earlier runs counts as assertion, not evidence.

Can I unit test modules that import Redis or Auth0?

Not with the current setup. Modules importing lib/redis.js, lib/bunny.js, lib/auth0.js, lib/guard.js, lib/audit.js, lib/ratelimit.js, or lib/store.js are not unit-testable because the repo has no mocking harness. A vi.mock-based fake Redis client is sketched as an unproven starting point.

Why does my new test file not run with npm test?

The vitest config only collects files matching lib/__tests__/**/*.test.js. Tests placed in a root __tests__ folder, a test/ directory, or colocated next to source files are silently never collected, and npm test still reports success without running them.

When should a regression test be required for a bug fix?

Any production bug in pure lib/*.js logic gets a regression test in the same fix PR asserting the exact input that broke. Bugs in Redis, bunny.net, or Auth0-touching code rely on the manual verification checklist instead, and that limitation must be stated explicitly.