gjalla-test-audit — Claude Code skill: what it does, how to install
Audits test suites to uncover false confidence, over-mocked logic, and assertions that conceal code regressions. Helpful when hardening test suites before major updates.
npx skills add gjalla/engineering --skill gjalla-test-audit -a claude-codeWhat gjalla-test-audit does
The skill examines your testing setup across five structured phases. First, it maps directories and distinguishes between isolated unit tests and integration tests that use real backends like PGlite or SQLite. Then it inspects tests alongside their corresponding source files to verify that real application code gets exercised.
It flags tests with heavy ORM mocking, assertions verifying hardcoded mock returns, and cases where business logic is copy-pasted directly into the test file. A mock chain that intercepts every query will pass even if database queries target non-existent columns.
Findings are grouped into four action tiers alongside bug reports. Once reviewed, the skill executes a staged cleanup: deleting useless test files, fixing inverted assertions, and revealing honest gaps in coverage.
What it helps with
- locate tautological mocks that pass regardless of schema bugs
- catch tests asserting wrong behaviors that match broken source logic
- purge redundant unit tests when real integration tests exist
- generate an accurate coverage deficit map before writing new tests
Example prompts for the agent
- Run an audit on the test suite to locate tautological mocks
- Check the database test layer and classify weak tests into tiers
- Prepare a staged test cleanup plan to eliminate redundant mocks
How to install gjalla-test-audit
1Skills CLI (Vercel)
npx skills add gjalla/engineering --skill gjalla-test-audit -a claude-code2Manually: put the files in place
~/.claude/skills/gjalla-test-audit/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/gjalla-test-audit/
1Skills CLI (Vercel)
npx skills add gjalla/engineering --skill gjalla-test-audit -a codex2Manually: put the files in place
.agents/skills/gjalla-test-audit/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add gjalla/engineering --skill gjalla-test-audit -a cursor2Manually: put the files in place
.cursor/skills/gjalla-test-audit/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install gjalla/engineering gjalla-test-audit2Manually: put the files in place
.github/skills/gjalla-test-audit/SKILL.md1Skills CLI (Vercel)
npx skills add gjalla/engineering --skill gjalla-test-audit -a gemini-cli2Platform CLI
gemini skills install https://github.com/gjalla/engineering --path skills/gjalla-test-auditManually: put the files in place
.devin/skills/gjalla-test-audit/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add gjalla/engineering --skill gjalla-test-audit -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about gjalla-test-audit
How to install gjalla-test-audit in Claude Code?
Run npx skills add gjalla/engineering --skill gjalla-test-audit -a claude-code. You can also place the skill file directly at ~/.claude/skills/gjalla-test-audit/SKILL.md.
What does gjalla-test-audit do?
It inspects both test files and real source code to identify tests that inflate coverage without catching regressions.
Which test flaws does the skill detect?
It identifies tests that reimplement logic without importing source code, heavy database mocks that hide query bugs, inverted assertions, and empty placeholder assertions.
