cs-compilers

Purpose

This skill equips the AI to handle compiler-related tasks, including lexing, parsing (LL/LR/PEG), building ASTs, semantic analysis, code generation with LLVM, optimizations, and integration with Tree-sitter for real-time parsing.

When to Use

Use this skill when developing compilers, analyzing source code, debugging parsers, generating optimized machine code, or integrating parsing into tools like IDEs. Apply it for tasks involving code transformation, such as transpiling or static analysis in programming languages.

Key Capabilities

• Lexing: Tokenize input using regex; e.g., define patterns like r'\b(int|float)\b' for keywords in a lexer.
• Parsing: Implement LL(1) with recursive descent or LR(1) via tools like yacc; use PEG with libraries like packrat; integrate Tree-sitter for efficient parsing, e.g., load a language grammar with tree_sitter.Language.build('path/to/tree-sitter-javascript.wasm').
• AST Handling: Build and manipulate ASTs; traverse nodes for analysis, e.g., use Tree-sitter's cursor: cursor = tree.walk(); while cursor.goto_first_child(): process_node(cursor).
• Semantic Analysis: Perform type checking and scope resolution; e.g., check variable declarations against usage in a symbol table.
• Code Generation: Generate LLVM IR; use the LLVM C++ API to create modules, e.g., LLVMModuleCreateWithName("MyModule") then add functions.
• Optimization: Apply passes like constant propagation or dead code elimination; e.g., run LLVM's opt tool with flags like -O3 for aggressive optimization.
• Tree-sitter Integration: Parse code in real-time; supports languages like C, Python via pre-built grammars.

Usage Patterns

Invoke this skill via OpenClaw CLI for direct commands or SDK for programmatic access. Always specify the action and parameters as JSON. For CLI, use: openclaw invoke cs-compilers --action <action> --params '<JSON string>'. In code, import the SDK and call: from openclaw import Client; client = Client(api_key=os.environ['OPENCLAW_API_KEY']); response = client.invoke('cs-compilers', {'action': 'parse', 'params': {'language': 'c', 'code': 'int main(){}'}}). Structure params as a dictionary with keys like "language" and "code". If using external tools, ensure dependencies (e.g., LLVM) are installed and pathed correctly.