debug-coffee-ahk

Debug coffee-ahk compiler bugs across Formatters, Processors, and Renderer stages.

23|3|Updated Sep 8, 2020
One-click install
npx skills add https://github.com/phonowell/coffee-ahk --skill debug-coffee-ahk
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: debug-coffee-ahk
Source: https://github.com/phonowell/coffee-ahk/tree/main/.claude/skills/debug-coffee-ahk
Command: npx skills add https://github.com/phonowell/coffee-ahk --skill debug-coffee-ahk

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill provides a structured approach to debugging the coffee-ahk compiler: understanding the compilation flow (entry/index.ts → formatters → processors → renderer), locating bugs in rendering and tokenization, and applying debugging tips to speed up bug fixes and comprehension during debugging or debugging sessions.

Core Features & Use Cases

  • Three-stage debugging workflow: Understand the 3 phases: Formatters, Processors, Renderer.
  • Bug localization methodology: Guidance to pinpoint issues by inspecting AST, tokens, and scope transforms.
  • Practical debugging tips: commands to inspect AST and tokens, run the full debug sequence.

Quick Start

  • Run the full debug workflow for a Coffee file: node -e "import('./dist/index.js').then(m=>m.default('file.coffee', {verbose:true, ast:true}))"
  • Alternatively, compile a single file to see the final AHK output: node dist/index.js file.coffee

Frequently Asked Questions about debug-coffee-ahk

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

FAQPage Schema
How do I debug compilation errors in the coffee-ahk compiler?

Debug coffee-ahk compilation by running the full debug workflow with node -e "import('./dist/index.js').then(m=>m.default('file.coffee', {verbose:true, ast:true}))". This exposes the three-stage pipeline—Formatters, Processors, Renderer—so you can pinpoint rendering errors, token omissions, and execution order issues.

What is the coffee-ahk compilation pipeline and how does it work?

The coffee-ahk compiler uses a three-stage pipeline: Formatters (initial input processing), Processors (scope transforms and token manipulation), and Renderer (final AHK output generation). Understanding this flow helps you isolate bugs at each phase and trace token flow from entry/index.ts through to output.

How do I inspect the AST and tokens to fix coffee-ahk bugs?

Run debug commands with the verbose and ast flags to inspect Abstract Syntax Trees and token output. Use Read/Grep/Glob for path-based context to document file responsibilities, then validate fixes via the provided debug commands and test workflow.

Can I use coffee-ahk for compiling CoffeeScript to AutoHotkey?

Yes. The coffee-ahk compiler converts CoffeeScript files to AutoHotkey output. This Skill helps you debug compilation issues when the output is incorrect or incomplete, using inspection tools and a methodical three-stage debugging approach.

What should I do if my coffee-ahk output is missing tokens or has rendering errors?

Inspect the AST and tokens at each stage—Formatters, Processors, Renderer—to locate where tokens are omitted or incorrectly rendered. Use the debug workflow to trace execution order, then validate your fix by recompiling and comparing the output.