debug

Diagnose Buildkite CI failures by listing builds, inspecting jobs, and fetching logs.

822|232|Updated Mar 1, 2019
One-click install
npx skills add https://github.com/cardano-foundation/cardano-wallet --skill debug-cardano-foundation
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: debug
Source: https://github.com/cardano-foundation/cardano-wallet/tree/main/.claude/skills/debug
Command: npx skills add https://github.com/cardano-foundation/cardano-wallet --skill debug-cardano-foundation

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps diagnose and fix CI failures in the Cardano Wallet project's Buildkite pipelines by providing guided access to logs and job details.

Core Features & Use Cases

  • CI failure debugging: Quickly identify failing steps and root causes from Buildkite pipelines.
  • Log retrieval & analysis: Fetch raw job logs via API, clean and inspect for errors to guide fixes.
  • Guided troubleshooting: Step-by-step workflows to inspect builds, jobs, and test outputs to speed resolution.

Quick Start

bk use cardano-foundation bk whoami bk build list --pipeline cardano-wallet --branch <your-branch> --limit 5 bk job list BUILD_NUMBER --pipeline cardano-wallet bk api "/pipelines/cardano-wallet/builds/BUILD_NUMBER/jobs/JOB_UUID/log" > /tmp/bk-log.json jq -r '.content' /tmp/bk-log.json > /tmp/bk-raw.log

Frequently Asked Questions about debug

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

FAQPage Schema
How do I fetch and inspect Buildkite logs for a failing CI job?

You can fetch Buildkite logs by querying builds with the bk CLI, then using the Buildkite API to retrieve the job log content. Tools like jq and sed clean the raw output to extract readable error details for CI debugging.

What is the best way to debug CI failures in Cardano Wallet pipelines?

Debugging CI failures involves listing recent builds to find failures, inspecting associated jobs, and extracting clean logs. This guided workflow helps identify failing steps and root causes quickly to speed up resolution.

Do I need the bk CLI to retrieve logs from Buildkite pipelines?

Yes, the bk CLI is required to query builds and list jobs. The implementation uses it alongside the Buildkite API to fetch logs, and jq with sed to parse and clean the retrieved content.

Can I extract readable test outputs from raw Buildkite API logs?

Yes, raw job logs fetched via the Buildkite API can be cleaned into readable text. By piping the API response through jq to extract the content field and sed to format it, you get clear test outputs for analysis.

How do I list recent builds on a specific branch in Buildkite?

You can list recent builds by running the bk build list command with your pipeline name and target branch. This limits the results to recent runs, helping you quickly locate the failed CI build for inspection.

What should I do if my Buildkite log retrieval returns unparseable content?

If Buildkite API log retrieval returns unparseable content, use jq to parse the JSON response and extract the content field. Applying sed further cleans the raw log output, making it readable for error inspection.