foxctl Test Runner

Run Go tests with structured JSON results and coverage, benchmark, or race analysis.

3|Updated Apr 14, 2026
One-click install
npx skills add https://github.com/joshka0/foxctl --skill foxctl-test-runner
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: foxctl Test Runner
Source: https://github.com/joshka0/foxctl/tree/main/configs/skills-condensed/foxctl-test
Command: npx skills add https://github.com/joshka0/foxctl --skill foxctl-test-runner

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It reduces the time and effort required to repeatedly run Go tests while collecting actionable results like coverage, benchmarks, and race-detection outcomes.

Core Features & Use Cases

  • Structured test execution: Runs Go tests and returns consistent, machine-readable results suitable for tooling and reporting.
  • Coverage, benchmarks, and race detection: Supports multiple test modes so you can validate correctness, performance, and concurrency behavior.
  • Targeted control: Lets you scope execution with path, test name patterns, verbosity, and timeouts for faster iteration.

Quick Start

Run the Go test suite with coverage using foxctl run test/run --input '{"path":"./...","mode":"coverage"}'.

Frequently Asked Questions about foxctl Test Runner

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

FAQPage Schema
How do I run Go tests with coverage and race detection in CI?

To run Go tests with coverage and race detection, execute the test runner with a JSON input specifying the path and mode. This returns structured results including pass/fail counts, timing, and race analysis for continuous integration workflows.

What is structured test execution for Go repositories?

Structured test execution for Go repositories runs tests and returns machine-readable JSON result envelopes. These envelopes contain pass/fail counts and timing data, making the output suitable for automated tooling and CI reporting.

Can I scope Go test execution to specific paths and test name patterns?

Yes, you can scope Go test execution using configurable paths, test name patterns, verbosity, and timeouts. This targeted control allows you to run specific test suite subsets for faster iteration during local verification.

Does the Go test runner support benchmark execution?

Yes, the Go test runner supports benchmark execution alongside coverage and race detection. It validates performance and concurrency behavior across your repository by returning structured timing results within a JSON result envelope.

What is the best way to get machine-readable Go test results for reporting?

The best way to get machine-readable Go test results is using a structured test runner that outputs a JSON result envelope. This format includes pass/fail counts, timing, and optional coverage data, ideal for automated reporting and tooling.

What are the limitations of running Go tests with structured results?

A limitation of running Go tests with structured results is the requirement to execute via a specific test runner using JSON input. It targets development workflows and requires configuring the runner with set timeouts, paths, and modes.