klangblocks-knowhow

Guide klangblocks development for AST-to-block conversion and code generation.

3|1|Updated Dec 20, 2025
One-click install
npx skills add https://github.com/PeekAndPoke/klang --skill klangblocks-knowhow
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: klangblocks-knowhow
Source: https://github.com/PeekAndPoke/klang/tree/main/.claude/skills/klangblocks-knowhow
Command: npx skills add https://github.com/PeekAndPoke/klang --skill klangblocks-knowhow

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill provides focused context and guidance for developers working on the klangblocks module, streamlining the implementation of block editor features, AST-to-blocks conversion, code generation, and round-trip testing.

Core Features & Use Cases

  • Module-Specific Context: Loads essential documentation for the klangblocks module, including architecture, key files, and dispatcher pipelines.
  • Task-Oriented Guidance: Directs developers to specific reference files based on their current task (e.g., block model types, AST conversion, code generation, round-trip testing).
  • Cross-Module Rules: Enforces the requirement that every new KlangScript language feature must be represented in klangblocks.
  • Testing Guidance: Provides commands for running tests on different platforms (JVM, JS).

Quick Start

Use the klangblocks-knowhow skill to understand the AST to blocks conversion process.

Frequently Asked Questions about klangblocks-knowhow

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

FAQPage Schema
How do I convert an Abstract Syntax Tree to visual blocks in Kotlin?

To convert an Abstract Syntax Tree to visual blocks in Kotlin, this Skill directs you to specific reference files detailing the AST-to-block model conversion process and dispatcher pipeline architecture.

What is the process for round-trip testing in a Kotlin Multiplatform block editor?

Round-trip testing for a Kotlin Multiplatform block editor involves verifying generated code against original visual blocks. This Skill provides specific testing commands for running these validations across JVM and JS platforms.

How do I generate Kotlin code from a visual block editor model?

Generating Kotlin code from a visual block editor model requires using the klangblocks code generation pipelines. This Skill provides task-oriented guidance to locate key files and rules necessary for accurate code output.

Does every new KlangScript language feature need to be added to the block editor?

Yes, cross-module development rules dictate that every new KlangScript language feature must be explicitly represented in the klangblocks module to ensure full visual editor support and syntax compatibility.

What are the limitations of using klangblocks for AST conversion?

The klangblocks AST conversion requires strict adherence to cross-module development rules, meaning any language feature not explicitly mapped to the block model will fail to convert or generate code properly.