Fingerprint CI Gate
Gate your CI build on browser-fingerprint regressions using liarjs baselines and score floors.
Dev & CodingIntermediate★ 237⑂ 0AI score 8/10Last updated: Aug 6, 2026
What it does
- Runs the
liarjsCLI to scan a headless browser's fingerprint and writes the result to JSON. - Offers two gating mechanisms: an absolute floor (
--min-score) and a baseline diff between two saved scans. - Produces ready-to-use snippets for GitHub Actions, GitLab CI, Docker images and Playwright assertions.
- Wires exit codes (0 clean, 1 below floor, 2 error) into the pipeline so jobs fail at the right moment.
- Covers network policy:
--offlinefor air-gapped runners,--endpointfor a self-hosted worker.
Who it's for
- Teams running scraping harnesses or automation bots who want to catch rising block rates early.
- Engineers shipping custom Chromium builds who need fingerprint regressions caught pre-release.
- DevOps folks asked to add a headless-detection check to an existing pipeline.
Examples
- "Add a step to our GitHub Actions that fails if the fingerprint score drops below 60" → generates setup-node,
npx liarjs@0.3 --headless --json scan.json --min-score 60, and an artifact upload. - "Our datacenter IP always fails the tz check — how do I gate on that?" → switches to a
baseline.jsondiff instead of an absolute floor. - "Track how the score moves per commit" → stores scan.json as an artifact and sets a convention for deliberate baseline-refresh commits.
· · · Install guide · · ·
Try it now, no install
Paste this into Claude to use the skill without installing anything.
Read the instructions in this file and follow them to help me: https://raw.githubusercontent.com/liarjsdev/liarjs-skills/HEAD/skills/fingerprint-ci-gate/SKILL.md What I want: (describe your task here)
If Claude can't open the link, open it yourself and paste the contents instead.
↓ If it works for you, download the ZIP below and install it. Then it runs on its own — no pasting each time.
Install in the Claude app (no terminal)
- Download the ZIP with the button below.
- In Claude, open Settings → Capabilities and turn on 'Code execution and file creation'. (one time)
- Go to Customize → Skills → + → 'Upload a skill' and upload the ZIP.
Install in Claude Code
Let Claude do it — paste this into Claude Code
Install the skill I found on Claude Skill Mart. Copy the skills/fingerprint-ci-gate folder from the GitHub repo liarjsdev/liarjs-skills into my ~/.claude/skills/fingerprint-ci-gate/. When it's done, tell me in one line what this skill can do.
Install with a command instead
git clone https://github.com/liarjsdev/liarjs-skills.git && mkdir -p ~/.claude/skills && cp -r liarjs-skills/skills/fingerprint-ci-gate ~/.claude/skills/⚠ This is a third-party skill. Check the source repository before installing.
- Open a terminal and confirm Node.js 22 or newer:
node -v - Clone the skills repository:
git clone https://github.com/liarjsdev/liarjs-skills.git - Create the skills folder if needed:
mkdir -p ~/.claude/skills - Copy this skill into place:
cp -r liarjs-skills/skills/fingerprint-ci-gate ~/.claude/skills/ - Restart Claude Code and ask something like "add a fingerprint gate to my CI pipeline" to trigger it.
- Real runs need a Chromium in the environment; on Docker pass
--shm-size=1gso the browser can start.
View source on GitHub ↗License: MIT