bubbletea-code-review

What This Skill Does

The bubbletea-code-review skill is a specialized static analysis tool for Go developers building terminal user interfaces (TUI) using the Charmbracelet BubbleTea framework. It acts as an expert pair programmer, auditing code for adherence to the Elm Architecture, idiomatic Model-Update-View (MUV) patterns, and professional Lipgloss styling practices. The skill distinguishes between standard asynchronous pattern usage and blocking operations that could degrade TUI performance, ensuring your application remains responsive.

Installation

To integrate this skill into your environment, run the following command in your terminal: clawhub install openclaw/skills/skills/anderskev/bubbletea-code-review Once installed, you can trigger the review process by targeting your project directory or specific source files within the OpenClaw agent interface.

Use Cases

This skill is ideal for teams or solo developers who need to perform automated code audits, refactoring, or educational reviews. It excels at identifying common pitfalls such as performing network I/O or file system calls directly within the Update function, which is a common source of flickering and input lag in TUI applications. It is also highly effective for ensuring complex component composition using the Bubbles library is handled correctly, and that Huh forms are properly integrated into the main update loop rather than being executed as blocking processes.

Example Prompts

1. "Review this update.go file. I'm seeing some UI stuttering when I fetch remote data; can you check if I'm blocking the main thread?"
2. "I'm trying to add a list component using bubbles/list. Can you verify my init and update logic follows the recommended Elm architecture?"
3. "Refactor my view function. It currently creates new Lipgloss styles on every render. Show me how to move them to global constants for performance."

Tips & Limitations

The most critical limitation to remember is that this skill is designed specifically for the BubbleTea lifecycle. It does not replace full-feature Go linters like golangci-lint but rather acts as an architectural validator. It distinguishes between blocking operations and valid tea.Cmd patterns, so avoid attempting to manually override its suggestions unless you have a specific requirement for synchronous operations outside the BubbleTea runtime. Always ensure your code is formatted correctly before running the review to help the agent accurately parse complex component hierarchies.