zeus-validation-and-qa

Diagnose and fix Zeus CI checks, Jest tests, and PR evidence requirements.

Updated Sep 2, 2026
One-click install
npx skills add https://github.com/aswin-dev-debug/Ai-Finance-analyzer --skill zeus-validation-and-qa-aswin-dev-debug
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: zeus-validation-and-qa
Source: https://github.com/aswin-dev-debug/Ai-Finance-analyzer/tree/main/lib/zeus-contrib/zeus/.claude/skills/zeus-validation-and-qa
Command: npx skills add https://github.com/aswin-dev-debug/Ai-Finance-analyzer --skill zeus-validation-and-qa-aswin-dev-debug

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Contributors to the Zeus Lightning wallet often hit confusing CI failures — prettier passing locally but failing in CI, jest transform errors from new dependencies, or the mysterious check-styles lint failure — and lack a clear map of what testing evidence a PR actually needs. This Skill explains exactly how the four-check quality gate works and what manual testing each change requires. ## Core Features & Use Cases - CI Gate Anatomy: Breaks down yarn verify into its four checks (Test, Prettier, tsc, Lint) with exact commands, pinned tool versions, and common failure modes for each. - Jest Troubleshooting: Covers transformIgnorePatterns ESM errors, moduleNameMapper for @noble/hashes, mock-before-import conventions, and running single test files. - PR Evidence Standards: Defines the manual testing matrix across 7 Lightning backends, screenshot requirements, and the extract-logic-to-utils pattern for testing store code. - Use Case: Your PR fails the Lint check with a themeColor StyleSheet error. Use this Skill to learn why static StyleSheet.create blocks freeze theme colors at import time and how to move themed colors into render-time styles. ## Quick Start Ask the AI to explain why yarn verify fails on the prettier check in CI but passes locally and how to fix it.

Frequently Asked Questions about zeus-validation-and-qa

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

FAQPage Schema
How do I run a single Jest test file in the Zeus repo?

Run yarn test followed by the file path, such as yarn test utils/Bolt11Utils.test.ts, and add -t with a name pattern to filter individual tests. Use yarn jest --listTests to enumerate all suites jest will run.

Why does prettier fail in CI but pass locally?

The repo pins prettier 2.4.1 with a specific .prettierrc config, and newer globally installed Prettier versions format differently. Run yarn prettier-write to format using the pinned local version that CI uses.

How do I fix the themeColor StyleSheet lint error from check-styles.test.ts?

Move themeColor calls out of static StyleSheet.create blocks, since those execute once at import time and freeze the active theme. Apply themed colors inline at render time and keep the styles block as the last thing in the file.

Why does jest throw Cannot use import statement outside a module?

Jest only transpiles node_modules packages whitelisted in transformIgnorePatterns in package.json. Add the offending ESM package name to that list to resolve the error.

Does Zeus have unit tests for MobX stores and components?

No. All 48 test suites cover utils, models, and one lndmobile file; stores, views, components, and backends have zero automated tests. The accepted pattern is extracting pure logic into utils and testing it there, plus mandatory manual testing.

What manual testing is required before opening a Zeus PR?

Hands-on testing on both iOS and Android is mandatory regardless of CI results, plus screenshots for UI changes. The PR template requires reporting which of the 7 Lightning backends you actually tested.