valynt-test-infra

Diagnose and fix ValyntApp test infrastructure failures from module resolution and setup issues.

Updated Nov 17, 2025
One-click install
npx skills add https://github.com/Valynt/ValueOS --skill valynt-test-infra
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: valynt-test-infra
Source: https://github.com/Valynt/ValueOS/tree/main/.windsurf/skills/valynt-test-infra
Command: npx skills add https://github.com/Valynt/ValueOS --skill valynt-test-infra

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Diagnose and fix widespread test infrastructure failures in the ValyntApp test suite. This includes non-logic issues such as module resolution problems, misconfigured test environments, missing mocks, and brittle setup code that cause large swaths of tests to fail for reasons unrelated to application logic.

Core Features & Use Cases

  • Diagnostic workflow to triage failures by category (import resolution, setup errors, provider mocks, and environment variables).
  • Prescribed code and configuration fixes, including vitest alias alignment, setup.ts mocks, and PNPM overrides guidance.
  • Plain-language playbook for sustaining test stability across local development and CI pipelines, with repeatable triage steps.

Quick Start

Run the diagnostic workflow from apps/ValyntApp, triage failure categories, and apply the recommended fixes to restore test stability.

Frequently Asked Questions about valynt-test-infra

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

FAQPage Schema
How do I fix vitest module resolution errors in my test suite?

Fix vitest module resolution errors by aligning vitest alias configurations and correcting setup.ts mocks to ensure dependencies resolve correctly during test execution, stabilizing failures caused by misconfigured environments.

What causes widespread test infrastructure failures unrelated to application logic?

Widespread test infrastructure failures stem from missing imports, hoisting errors, environment misconfigurations, and brittle setup code rather than application logic, requiring diagnostic workflows to triage and resolve across development and CI pipelines.

How do I triage provider mock setup errors in vitest?

Triage provider mock setup errors by running a diagnostic workflow that categorizes failures into import resolution, setup errors, provider mocks, and environment variables, then applying prescribed configuration changes to stabilize tests.

Does this diagnostic workflow apply to both local development and CI pipelines?

Yes, the diagnostic workflow applies across local development and CI pipelines, providing repeatable triage steps and recommended code or config changes to sustain test stability in both environments.

What is the best way to diagnose missing import and hoisting errors in test infrastructure?

The best way to diagnose missing import and hoisting errors is running a structured diagnostic workflow that maps error patterns to prescribed fixes, including vitest alias alignment and PNPM overrides guidance to restore stability.

When should I not use a test infrastructure diagnostic workflow?

Avoid using a test infrastructure diagnostic workflow when failures are caused by actual application logic bugs rather than module resolution, setup, provider mocks, or environment misconfigurations, as these require logic debugging instead.