run-test-phase

Run phase-specific Vitest tests and write test.result.json.

2|Updated Jan 24, 2026
One-click install
npx skills add https://github.com/potenlab/marketplace-potenlab --skill run-test-phase
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: run-test-phase
Source: https://github.com/potenlab/marketplace-potenlab/tree/main/plugins/potenlab-workflow/skills/run-test-phase
Command: npx skills add https://github.com/potenlab/marketplace-potenlab --skill run-test-phase

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Run phase-specific Vitest tests to speed up feedback in multi-phase test suites.

Core Features & Use Cases

  • Reads test-plan.md to identify phases and map features to tests.
  • Prompts the user to select a phase via AskUserQuestion if not provided.
  • Resolves and runs only the test files for the chosen phase using Vitest.
  • Generates and replaces test.result.json, then analyzes failures via qa-specialist.
  • Integrates with the broader potenlab workflow to maintain phase-level quality.

Quick Start

Invoke the skill using /run-test-phase followed by a phase identifier to run only the tests for that phase.

Frequently Asked Questions about run-test-phase

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

FAQPage Schema
How do I run Vitest tests for a specific phase instead of the entire test suite?

Run Vitest tests for a specific phase by invoking the skill with a phase identifier. It reads your test-plan.md, resolves the mapped test files for that phase, and executes Vitest with a JSON report to speed up multi-phase feedback loops.

What is phase-based testing and how does it map features to test files?

Phase-based testing organizes a test suite into distinct stages mapped to specific features. A test-plan.md file defines these mappings, allowing test runners to resolve and execute only the test files relevant to a chosen phase rather than the full suite.

How do I generate a JSON test report and analyze failures in Vitest?

Generate a JSON test report by running Vitest with JSON output enabled. The skill writes this output to test.result.json and automatically triggers qa-specialist analysis on any detected failures to provide diagnostic insights.

Can I run phase-specific tests without manually specifying the phase identifier?

Yes, you can run phase-specific tests without a manual identifier. If no phase is provided, the skill reads test-plan.md and uses AskUserQuestion to prompt you interactively to select the desired phase for testing.

Do I need a test-plan.md file to execute phase-based Vitest tests?

Yes, a test-plan.md file is required. The skill relies on this file to identify available phases and map specific features to their corresponding test files before resolving and executing the targeted Vitest tests.

Why does my multi-phase test suite take so long and how can I speed up feedback?

Multi-phase test suites take long because they run all tests globally. Speed up feedback by using phase-based testing to execute only the Vitest tests mapped to your active development phase, bypassing the full suite.