tokio-async-code-review

What This Skill Does

The tokio-async-code-review skill is a specialized static analysis tool designed to audit Rust codebases leveraging the Tokio asynchronous runtime. It systematically inspects asynchronous logic to ensure high performance, memory safety, and concurrency correctness. By analyzing Cargo feature flags, runtime initialization, task lifecycle management, and synchronization primitives, the skill identifies common pitfalls such as blocking the executor, improper mutex guard lifetimes, and channel misconfigurations. It provides actionable reports formatted with specific line references and severity levels, making it an essential companion for Rust developers managing complex async architectures.

Installation

To install this skill, run the following command in your terminal: clawhub install openclaw/skills/skills/anderskev/tokio-async-code-review

Use Cases

• Production Audits: Verifying that a production service has correctly configured feature flags and is not accidentally using synchronous blocking calls in async loops.
• Performance Tuning: Identifying bottlenecks where a std::sync::Mutex might be held across an .await point, causing potential deadlocks or runtime starvation.
• Refactoring: Moving from simple single-threaded async code to complex multi-threaded architectures requiring robust cancellation patterns and semaphore-based concurrency limiting.
• Error Handling: Ensuring JoinHandle results, channel disconnects, and broadcast lag errors are handled rather than ignored or unwrapped.

Example Prompts

1. "Review the following worker module for potential deadlocks. I'm using tokio::sync::Mutex inside an async loop—is this optimal? [Paste Code]"
2. "I'm seeing 'thread panicked' errors when my tasks fail. How can I improve my JoinHandle management using this skill's guidelines?"
3. "Check my Cargo.toml and main entry point. Are my Tokio feature flags sufficient for a high-throughput TCP server? [Paste Cargo.toml]"

Tips & Limitations

• Tips: Always include your Cargo.toml when requesting a review, as feature flags are the root cause of many cryptic compilation errors. For large codebases, provide files one at a time to receive more granular feedback.
• Limitations: The skill is a static analysis tool; it cannot detect runtime-specific race conditions that depend on external timing or network conditions. It works best when provided with isolated modules of your business logic.