Dx Devops Test Suite Run

This runs DevOps Center test suites on pipeline stages and waits for results. It handles the full cycle: triggers async execution via the Connect API (with a confirmation gate since it mutates org state), polls by runId until complete or timed out, then hands failures off to analysis. Works for Pre-Promote, Post-Promote, or Review events. The retrigger mode is smart about quality gates: it won't re-run unless current coverage meets the threshold, which saves you from wasting cycles on tests that can't pass yet. Polling intervals are provider-specific and all data lives in the Salesforce org, not your local repo. Useful when you need to kick off stage tests or unblock a promotion after fixing coverage gaps.

skills.sh installs: 5K
GitHub stars: 1.2K
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add forcedotcom/sf-skills --skill dx-devops-test-suite-run --agent claude-code

Installs into .claude/skills of the current project.

Files

Run a DevOps Center Test Suite

Triggers a DevOps Center test suite execution and watches it to completion. Running and polling are two halves of one operation — never poll without first having (or being handed) a runId.

API version: All DevOps testing system calls target Salesforce API v67.0 (minimum required).

Important: All DevOps Center data lives in the Salesforce org — NOT the local repo. Always query the org with sf data query or sf api request rest.

Prerequisites

Run the prerequisite checks in references/prerequisite-checks.md — Prerequisites 1–4 and Prerequisite 5 (stage), since this skill operates on a specific stage. You need the confirmed doce-org-alias, pipelineId, and stageId.

Inputs required

Input	How to obtain
`pipelineId`	Prerequisite 4 (pipeline selection)
`stageId`	Prerequisite 5 (pipeline stage confirmation)
`event`	Confirm with user: `Pre-Promote`, `Post-Promote`, or `Review`
`testSuiteIds`	Confirmed suite IDs from selection or recommendation
`doce-org-alias`	Prerequisite 1