dx-devops-test-suite-run

Triggers and polls Salesforce DevOps Center test suite executions on pipeline stages.

Updated Jul 2, 2026
One-click install
npx skills add https://github.com/padjei/SF_Build --skill dx-devops-test-suite-run-padjei
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: dx-devops-test-suite-run
Source: https://github.com/padjei/SF_Build/tree/main/.claude/skills/dx-devops-test-suite-run
Command: npx skills add https://github.com/padjei/SF_Build --skill dx-devops-test-suite-run-padjei

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Running DevOps Center test suites on a pipeline stage requires orchestrating an async Connect API call, tracking the runId, and polling execution status until completion — a multi-step process that is easy to get wrong without guidance on the correct objects, fields, and intervals. ## Core Features & Use Cases - Gated Test Execution: Triggers Pre-Promote, Post-Promote, or Review test suite runs via the Connect API only after an explicit user confirmation showing pipeline, stage, event, suites, and org. - Status Polling to Completion: Polls the DevopsTestSuiteExecution record at provider-specific intervals (Apex, Code Analyzer, Provar UI, Flow) and surfaces coverage, success/failure counts, and quality gate status inline. - Quality Gate Retrigger: Re-runs a blocked quality gate only after verifying coverage meets the DevopsQualityGateRule threshold, then hands the new runId to polling. - Use Case: A promotion is blocked by a failed quality gate. After adding tests to raise coverage, ask the assistant to retrigger the gate on the Staging stage; it verifies the threshold, confirms with you, executes the run, and reports results. ## Quick Start Run the assigned test suites on my Integration pipeline stage as a Pre-Promote event and watch the run until it finishes.

Frequently Asked Questions about dx-devops-test-suite-run

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

FAQPage Schema
How do I run DevOps Center test suites on a pipeline stage?▼

Confirm the pipeline, stage, event type (Pre-Promote, Post-Promote, or Review), and suite IDs, then approve the confirmation prompt. The skill calls the Connect API stage/execute endpoint and polls the returned runId until the run completes.

How do I retrigger a failed quality gate in Salesforce DevOps Center?▼

First raise coverage to meet the DevopsQualityGateRule threshold, then ask to retrigger the gate. The skill verifies coverage against the threshold, confirms with you, and re-executes the same stage, event, and suites from the blocked promotion.

Can I use sf apex run test for DevOps Center test suites?▼

No. The sf apex run test command belongs to the platform-apex-test-run skill, not DevOps Center suites. DevOps Center executions must go through the Connect API devopstesting endpoint and are tracked on DevopsTestSuiteExecution records.

Why does my DevOps Center test execution fail with no tests to execute?▼

The error 'classIdList is null or empty' means the assigned suites contain no test classes. Add test classes to the suite using the suite assignment configuration skill, then run the execution again.

What happens when a DevOps Center test run times out?▼

On timeout the skill surfaces the runId and stops without auto-retrying. You can check the status manually in DevOps Center or ask the assistant to keep polling the same runId.