blocking-io-guard

Detect and mitigate blocking IO in Python code for asyncio event loops.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/ainlper/dra-drb2 --skill blocking-io-guard
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: blocking-io-guard
Source: https://github.com/ainlper/dra-drb2/tree/main/deer-flow/.agent/skills/blocking-io-guard
Command: npx skills add https://github.com/ainlper/dra-drb2 --skill blocking-io-guard

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill identifies and mitigates blocking IO in Python code, ensuring that the asyncio event loop operates smoothly and efficiently.

Core Features & Use Cases

  • Blocking IO Detection: Identifies blocking IO in Python code, helping to prevent performance bottlenecks.
  • Anchor Verification: Verifies the effectiveness of runtime anchors to protect against blocking IO regressions.
  • Use Case: When modifying backend Python code in app/, packages/harness/deerflow/, or scripts/, this Skill can be used to scan for blocking IO and ensure that it is properly guarded.

Quick Start

Run the blocking-io-guard skill to scan for blocking IO in your codebase.

Frequently Asked Questions about blocking-io-guard

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

FAQPage Schema
How do I detect blocking IO in Python asyncio code?

You can detect blocking IO in Python asyncio code by running analysis scripts that scan the codebase for synchronous operations. This identifies performance bottlenecks that disrupt the event loop, ensuring smooth execution during backend modifications.

Why does my asyncio event loop freeze during backend code modifications?

Your asyncio event loop likely freezes due to blocking IO operations in the backend code. Scanning the codebase for synchronous calls and verifying runtime anchors helps mitigate these regressions and restores smooth event loop operation.

Can I scan specific directories like app and scripts for blocking IO?

Yes, you can scan specific directories like app, packages, and scripts for blocking IO. The analysis targets backend Python code in these paths to identify and guard against synchronous operations that hinder event loop performance.

What is runtime anchor verification for blocking IO regressions?

Runtime anchor verification checks the effectiveness of specific code guards designed to protect against blocking IO regressions. It ensures that previously identified asynchronous safeguards continue to prevent synchronous operations during maintenance rounds.

Do I need specific dependencies to run blocking IO analysis on Python code?

No external dependencies are required beyond Python itself. The analysis relies on specific built-in scripts to scan the codebase, identify blocking IO, and test the effectiveness of runtime anchors without installing additional packages.

When should I scan my Python codebase for blocking IO?

You should scan your Python codebase for blocking IO during backend code modifications and maintenance rounds. This prevents performance bottlenecks from entering the asyncio event loop and ensures smooth operation before deployment.