kindlings-debugging

Debug Kindlings macro derivation with structured logging and compile-time tracing.

68|7|Updated Nov 24, 2025
One-click install
npx skills add https://github.com/kubuszok/kindlings --skill kindlings-debugging
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: kindlings-debugging
Source: https://github.com/kubuszok/kindlings/tree/main/docs/contributing/kindlings-debugging
Command: npx skills add https://github.com/kubuszok/kindlings --skill kindlings-debugging

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Debugging Kindlings macro derivation can be challenging because it involves complex macro expansions, multiple modules, and compile-time logging data.

Core Features & Use Cases

  • Import a module-specific debug log switch to observe derivation steps.
  • Inspect MIO diagnostic logging, flame-graph annotations, and error trait hierarchies.
  • Track recursive types with MLocal to avoid infinite recursion during derivation.

Quick Start

Enable module-specific derivation logging and run a compilation that exercises a failing derivation to view the actionable diagnostics.

Frequently Asked Questions about kindlings-debugging

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

FAQPage Schema
How do I debug Scala macro derivation failures during compilation?

Debug Scala macro derivation by enabling module-specific structured logging to observe derivation steps and capture compilation-time diagnostic data. This exposes actionable tracing for failing expansions.

What is the best way to trace recursive types causing infinite loops in macro derivation?

Trace recursive types during macro derivation by using MLocal tracking to monitor type expansion and prevent infinite recursion. This mechanism identifies recursive structures before they trigger compilation timeouts.

Can I generate a flame graph for compile-time macro expansion diagnostics?

Yes, you can generate flame graph annotations for compile-time macro expansion diagnostics. This visualizes the derivation hierarchy and logs structured diagnostic data across multiple modules during compilation.

How do I configure derivation logging and timeouts for Hearth-based macros?

Configure derivation logging and timeouts for Hearth-based macros by importing a module-specific debug log switch and setting configurable timeout parameters. This exposes structured compilation tracing and error hierarchy metadata.

Why does my Kindlings macro derivation fail without clear compilation errors?

Macro derivation may fail without clear errors due to complex expansions across multiple modules lacking structured diagnostic logging. Enable derivation logging and MIO diagnostics to inspect the error trait hierarchy and trace the failure.

Do I need a specific environment setup to inspect MIO diagnostic logging for macros?

You need a module employing Hearth-based macros with frontmatter metadata containing name and description, and optionally a resources directory. Enable the debug log switch within this setup to inspect MIO diagnostic logging and error hierarchies.