Buildkite issue solver

Diagnose Buildkite deployment failures and apply Confluence fixes with approval.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/siteminder-au/claude-code-dx-plugin --skill buildkite-issue-solver
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: Buildkite issue solver
Source: https://github.com/siteminder-au/claude-code-dx-plugin/tree/main/skills/buildkite-issue-solver
Command: npx skills add https://github.com/siteminder-au/claude-code-dx-plugin --skill buildkite-issue-solver

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires @siteminder/dx, @anthropic-ai/claude-code.

What problem does it solve?

Diagnosing and resolving Buildkite deployment errors, especially Terraform-related ones, can be time-consuming and require deep expertise. This Skill automates the identification of issues and suggests fixes based on internal documentation, accelerating troubleshooting.

Core Features & Use Cases

  • Error Diagnosis: Analyzes Buildkite URLs to identify issues using the Buildkite MCP server, pinpointing problems quickly.
  • Confluence-Based Solutions: Fetches and applies fixes from internal Confluence documentation for common errors (e.g., Terraform issues), providing expert guidance.
  • Automated Retries: Retries failed jobs after applying fixes and validates success, ensuring issues are truly resolved.
  • Use Case: A Buildkite job for notifications-beef failed with a Terraform error. Provide the Buildkite URL, and the Skill will diagnose, suggest a fix from Confluence, and re-run the job, saving you hours of debugging.

Quick Start

Solve the Buildkite issue at https://buildkite.com/siteminder/my-project/builds/12345

Frequently Asked Questions about Buildkite issue solver

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

FAQPage Schema
How do I diagnose and fix Buildkite deployment errors automatically?

Diagnose and fix Buildkite deployment errors by providing a build URL to this Skill, which queries the Buildkite MCP server, identifies issues, retrieves fixes from internal Confluence documentation, and re-runs failed jobs after your approval. It handles Terraform-related errors and validates success automatically.

Can I automate Buildkite job retries after applying error fixes?

Yes. After diagnosing a Buildkite error and presenting a fix for your approval, the Skill automatically re-runs the failed job and validates whether the issue is resolved before moving to the next error in the queue.

What types of Buildkite errors can this Skill resolve?

This Skill resolves Buildkite errors by consulting internal Confluence documentation for common Terraform deployment issues. It enumerates all issues in a build or job, applies documented fixes with placeholders for system, environment, component, and realm, then prompts approval before remediation.

Do I need Terraform knowledge to use this Skill for Buildkite troubleshooting?

No. The Skill retrieves and applies Terraform error fixes from internal documentation, so you don't need deep expertise. You review suggested fixes and approve them before the Skill re-runs the job and validates success.

How does this Skill avoid modifying my Buildkite configuration?

This Skill uses a read-only MCP server to query Buildkite builds and jobs without modifying them. It fetches guidance from Confluence, presents fixes for your approval, and only re-runs failed jobs—never alters pipeline configuration or build definitions.

What's the best way to troubleshoot multiple failing Buildkite jobs at once?

Provide the Buildkite URL for a build with multiple failures. The Skill enumerates all issues, presents fixes in sequence, and retries and validates each job after your approval, handling multiple errors systematically without manual intervention between each fix.