xray-testing

Create and update Xray test entities and import results via GraphQL and REST.

18|9|Updated Apr 8, 2026
One-click install
npx skills add https://github.com/arozumenko/sdlc-skills --skill xray-testing
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: xray-testing
Source: https://github.com/arozumenko/sdlc-skills/tree/main/skills/xray-testing
Command: npx skills add https://github.com/arozumenko/sdlc-skills --skill xray-testing

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill removes the manual, error-prone work of creating Xray Tests and executions and then importing or reporting test results so that Jira/Xray coverage and run statuses stay consistent.

Core Features & Use Cases

  • Xray CRUD for test entities: create and edit Xray Tests, Preconditions, Test Sets, Test Plans, and Test Executions across Xray Cloud (GraphQL) and Server/Data Center (REST).
  • Results upload with verification: import JUnit/Cucumber/XML and Xray JSON into a Test Execution while validating that the number of imported Test Runs matches expectations.
  • Correct coverage linking: link Tests to requirements using Xray coverage links (not plain Jira issue links) to make coverage reports accurate.
  • Practical operations: fetch Test steps, manage step IDs safely, update Test Run statuses, and attach evidence.

Quick Start

Run the command npx github:arozumenko/sdlc-skills init --skills xray-testing to install the skill for your AI IDE workflow.

Frequently Asked Questions about xray-testing

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

FAQPage Schema
How do I import JUnit test results into Xray?

To import JUnit test results into Xray, this Skill converts CI artifacts like JUnit XML into Xray Test Executions while validating that the number of imported Test Runs matches expectations through post-write re-fetch verification.

How do I link Xray tests to Jira requirements for coverage?

Linking Xray Tests to requirements requires using dedicated Xray coverage links rather than plain Jira issue links, which ensures that Jira/Xray coverage reports and run statuses remain accurate and consistent.

Does this Xray test management workflow support both Cloud and Server/Data Center?

Yes, the workflow supports Xray Cloud using GraphQL and Xray Server/Data Center using REST APIs, enabling CRUD operations for Tests, Preconditions, Test Sets, Test Plans, and Test Executions across both deployments.

What is the best way to automate Xray Test Execution status updates from CI?

Automating Xray Test Execution status updates from CI involves pulling tests into the correct Xray structure, converting CI artifacts into results, and attaching evidence using MCP transport or a bundled CLI fallback.

Why does my Xray test results import show silent mismatches in Jira?

Silent mismatches occur when post-write validation is skipped; this Skill prevents them by enforcing a post-write re-fetch mechanism that verifies the imported Test Runs match the expected counts before finalizing.

Can I create Xray Test Sets and Test Plans programmatically through an API?

Yes, you can create and manage Xray Test Sets and Test Plans programmatically by performing CRUD operations through GraphQL for Xray Cloud or REST APIs for Server/Data Center environments.