git404hub

what is proof-skill fr?

uda-eth/proof-skill — explained in plain English

Analysis updated 2026-05-18

3JavaScriptAudience · developerComplexity · 2/5LicenseSetup · easy

tl;dr

A Claude Code skill that proves a coding task actually works by driving your real app through user journeys and recording screenshots and video as evidence.

vibe map

mindmap
  root((proof-skill))
    What it does
      Drives real app as a user
      Screenshots every state
      Writes proof report
    Tech stack
      JavaScript
      Playwright
      Node.js
    Use cases
      Prove PR is done
      Catch hidden UI bugs
      Viewport sweep
    Audience
      Developers
      Code reviewers
    Setup
      Copy skill folder
      Run slash proof command
      Needs Node and Playwright

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

what do people make with this?

VIBE 1

Generate screenshot and video evidence that a feature works before merging a pull request.

VIBE 2

Catch bugs that pass automated tests but fail for real users, like hidden onboarding screens.

VIBE 3

Sweep a feature across five screen widths to check for responsive design issues.

VIBE 4

Compare before and after screenshots against the code on the merge base branch.

what's the stack?

JavaScriptNode.jsPlaywrightPostgres

how it stacks up fr

uda-eth/proof-skillabhagsain/bayut-maps-ratingsabhishek-kumar09/who-is-imposter
Stars333
LanguageJavaScriptJavaScriptJavaScript
Last pushed2021-04-12
MaintenanceDormant
Setup difficultyeasymoderateeasy
Complexity2/52/53/5
Audiencedevelopergeneralgeneral

Figures from each repo's GitHub metadata at analysis time.

how do i run it?

Difficulty · easy time til it works · 5min

Copy the skill folder into your Claude Code skills directory, Node.js and Playwright are required, Postgres is optional.

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

in plain english

proof-skill adds a skill called /proof to Claude Code, the AI coding assistant, so that instead of just saying a task's tests pass, it can show a real user completing the journey the ticket promised. When you run /proof, Claude figures out the user journeys implied by your ticket or code diff, writes a test runner from a bundled template, and drives your actual running app in a real Chrome browser against your real dev server and real database, rather than mocking anything. The README explains why this matters with three real examples of bugs that slipped through despite passing tests: a stale dev server that made every test pass against old code, a feature that worked but was hidden behind an onboarding screen nobody dismissed, and an empty state whose button linked nowhere useful. A journey suite that actually clicks through the app the way a user would catches these kinds of problems that assertions alone miss. Each run produces a folder of evidence next to your pull request: the Playwright test scripts themselves, a machine readable results file, a short markdown report with a pass or fail verdict for each step, and a self contained HTML report page with a screen recording player, before and after screenshots compared against the code before your change, and a five viewport responsiveness sweep from phone to desktop width. The skill enforces a small set of rules, including never mocking the network layer, pairing every screenshot with an assertion, testing negative cases like permissions and filters, and treating anything short of a fully passing suite as not done. Installation is copying the skill folder into your personal or per-project Claude Code skills directory. A demo pomodoro timer app is included to show the full proof pack it generates. It requires Node.js and Playwright, with an optional Postgres database for setting up test users directly, and is released under the MIT license.

prompts (copy fr)

prompt 1
Install the /proof skill into my Claude Code skills directory and explain how to run it.
prompt 2
Run /proof on this pull request and show me the journey verdicts and screenshots.
prompt 3
Walk me through the demo pomodoro app and its generated proof pack.
prompt 4
Explain the five rules /proof enforces, like never mocking the network layer.

Frequently asked questions

what is proof-skill fr?

A Claude Code skill that proves a coding task actually works by driving your real app through user journeys and recording screenshots and video as evidence.

What language is proof-skill written in?

Mainly JavaScript. The stack also includes JavaScript, Node.js, Playwright.

What license does proof-skill use?

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

How hard is proof-skill to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is proof-skill for?

Mainly developer.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.