ck:debug

Debug software through a four-phase root cause investigation workflow.

1|Updated Mar 6, 2026
One-click install
npx skills add https://github.com/quanganh208/cookmate --skill ck-debug-quanganh208
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ck:debug
Source: https://github.com/quanganh208/cookmate/tree/main/.opencode/skills/ck-debug
Command: npx skills add https://github.com/quanganh208/cookmate --skill ck-debug-quanganh208

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

Debugging complex systems is often ad hoc and error-prone. ck:debug provides a disciplined framework to perform root-cause analysis before applying fixes, applicable across code, tests, CI/CD pipelines, logs, and production issues.

Core Features & Use Cases

  • Four-Phase Debugging: Root Cause Investigation → Pattern Analysis → Hypothesis Testing → Implementation to ensure fixes address the real cause.
  • Root Cause Tracing & Verification: Trace data flow through components, form testable hypotheses, and verify results with fresh evidence.
  • Defense-in-Depth Validation: Validate at entry, business logic, environment, and instrumentation layers to prevent regression.
  • Investigation Methodology & Documentation: Systematic data collection, cross-source analysis, and standardized reporting.

Quick Start

Summarize the issue and begin Phase 1 by performing Root Cause Investigation.

Frequently Asked Questions about ck:debug

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

FAQPage Schema
What is root-cause analysis in software debugging and why is it necessary?

Root-cause analysis systematically traces data flow through components to identify the actual source of a failure. It is necessary to ensure fixes address the real cause rather than superficial symptoms, preventing future regressions across code, tests, and CI/CD pipelines.

How do I debug CI/CD failures and production issues step by step?

Debug CI/CD failures and production issues using a four-phase workflow: perform root cause investigation, analyze patterns, test hypotheses, and implement fixes. This methodology ensures systematic data collection and cross-source log analysis before applying changes.

Can I use this debugging methodology for database diagnostics and performance issues?

Yes, this debugging methodology applies across code, tests, performance issues, logs, CI/CD failures, and database diagnostics. It guides end-to-end investigation by tracing data flow and forming testable hypotheses to verify results with fresh evidence.

What is the best way to prevent regression when fixing complex software bugs?

The best way to prevent regression is defense-in-depth validation. Validate fixes at entry, business logic, environment, and instrumentation layers to ensure verifiable outcomes and confirm the fix addresses the root cause without introducing new issues.

How does hypothesis testing work during software investigation?

Hypothesis testing during software investigation involves forming testable assumptions about the root cause and verifying them with fresh evidence. This phase follows pattern analysis and precedes implementation, ensuring fixes are validated before deployment.

When should I not use ad hoc debugging for log analysis?

Ad hoc debugging should be avoided when dealing with complex systems, CI/CD failures, or production issues. A disciplined framework with standardized reporting and cross-source analysis is necessary to trace data flow accurately and prevent error-prone fixes.