rugo-developer

Develop the Rugo compiler, parser, modules, and idiomatic .rugo scripts.

24|1|Updated Feb 7, 2026
One-click install
npx skills add https://github.com/rubiojr/rugo --skill rugo-developer
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: rugo-developer
Source: https://github.com/rubiojr/rugo/tree/main/extras/claude/skills/rugo-developer
Command: npx skills add https://github.com/rubiojr/rugo --skill rugo-developer

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill provides expert knowledge for developing and maintaining the Rugo compiler, its parser, modules, and for writing .rugo scripts with idiomatic best practices.

Core Features & Use Cases

  • Compiler Internals: Understand the entire compilation pipeline from .rugo source to Go binaries.
  • Language Syntax & Features: Deep knowledge of Rugo's Ruby-inspired syntax, modules, Go bridge, and concurrency primitives.
  • Development Workflow: Guidance on grammar changes, preprocessor logic, module creation, and testing.
  • Use Case: Debugging a codegen issue by inspecting the generated Go code or adding a new feature to the Rugo language.

Quick Start

Load the rugo-developer skill to understand the Rugo compiler's AST walker.

Frequently Asked Questions about rugo-developer

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

FAQPage Schema
How does the Rugo compiler transform source code into Go binaries?

The Rugo compiler processes .rugo source files through a pipeline involving preprocessor transformations, AST structuring, and Go code generation to produce final Go binaries. It bridges Ruby-inspired syntax directly into the Go compilation pipeline.

How do I add a new language feature to a Ruby-inspired parser in Go?

To add a new language feature, you must modify the Rugo parser's grammar rules, update the AST walker to handle the new syntax, and adjust the Go code generation logic to emit the corresponding Go stdlib bridging code.

What is the best way to debug Go codegen issues in a transpiled language?

Debugging codegen issues requires inspecting the generated Go code directly from the AST walker output. You can trace discrepancies by comparing the expected Go stdlib bridging calls against the actual instructions generated during the compilation pipeline.

Does Rugo support bridging external modules and Go standard library functions?

Yes, Rugo supports a module system designed specifically for Go stdlib bridging. This allows developers to import and utilize Go standard library functions directly within idiomatic Rugo scripts during the compilation process.

How do I test Rugo language modules and compiler transformations?

You test Rugo modules and transformations using the RATS testing framework. This framework validates grammar changes, preprocessor logic, and AST structure outputs to ensure compiler pipeline stability across new features.

Why might preprocessor transformations fail when updating compiler internals?

Preprocessor transformations fail when grammar changes desynchronize the expected AST structure. Ensuring the AST walker correctly interprets the updated preprocessed syntax is critical before executing the Go code generation phase.