blocking-io-guard
A contributor skill in ByteDance's DeerFlow repository for making sure async Python backend code that could block the event loop is covered by a runtime test.
What the skill teaches
A contributor skill in ByteDance's DeerFlow repository for making sure async Python backend code that could block the event loop is covered by a runtime test. It scans either the contributor's own diff before a pull request or the whole repository, sorts each finding into already offloaded (add a guard test), blocking (offload it, then add a test) or no action with a recorded reason, and writes or extends an anchor test that drives the exact code path. A mandatory step reintroduces the blocking call to prove the test fails, then restores the fix to see it pass. The pull request lists every finding, its outcome and the red-to-green evidence.
Capabilities
- Scan Python async code for calls that block the event loop
- Sort findings into guard, fix or no-action
- Write anchor tests and prove they fail without the fix
About
- Publisher
- ByteDance
- Tool
- Testing
Install
The project doesn't document install steps that we could confirm. See the project's own instructions
What's inside
- references/good-anchor-rules.md
- references/sop-skeleton.md
- templates/anchor.template.py
MCP servers and skills can run code on your computer and act on your data. Review the source before installing.
This skill includes scripts that your agent may run.
Details
| Fact | Value | Source |
|---|---|---|
| Type | Skill | |
| Tool | Testing | |
| Publisher | ByteDance | source |
| Official status | Not stated in its documentation | |
| Needs an API key or sign-in | Not stated in its documentation | |
| Includes scripts | Yes | source |
| Platforms | Not stated in its documentation | |
| AI clients | Not stated in its documentation | |
| Licence | MIT | source |
| Pricing | Not stated in its documentation | |
| Activity | Last commit Nov 11, 202685,246 GitHub starsDownload data not available (not on npm or PyPI) | source |
| Links | Repository Website |
Sources
- Skill file (SKILL.md)github.com/bytedance/deer-flowNov 10, 2026
- GitHub repositorygithub.com/bytedance/deer-flow · Backs: Licence, Publisher, ActivityNov 11, 2026
- Folder in the repository (blocking-io-guard)github.com/bytedance/deer-flow · Backs: Includes scriptsNov 10, 2026