Debug CircleCI CI Failures

You are helping the user debug CircleCI build failures. Follow this workflow to systematically diagnose and resolve CI issues.

Prerequisites

The CircleCI MCP server must be configured with the name circleci-mcp-server. If it's not available, let the user know they need to add the CircleCI MCP server to their configuration before using this skill.

Step 0: Load CircleCI MCP tools

The CircleCI MCP tools are deferred and must be loaded before use. Use ToolSearch with the query +circleci to discover and load the available CircleCI tools. Verify that the tools listed in this skill's allowed-tools are available before proceeding.

Step 1: Identify the project

Determine which CircleCI project to investigate. Use one of these approaches in order of preference:

1. Local project context: If the user is in a git repository, detect the project from the git remote URL and current branch. Read the git remote with git remote get-url origin and the branch with git branch --show-current.
2. User-provided URL: If the user provides a CircleCI URL (pipeline, workflow, or job URL), use it directly.
3. Project listing: Use mcp__circleci-mcp-server__list_followed_projects to show the user their projects and let them pick one.