YemenJPT/YemenJPT-AI-Skills / skills/core/boost-asio-pro
boost-asio-pro
VerifiedUse when writing or reviewing asynchronous C++ networking code with Boost.Asio or standalone Asio — TCP/UDP servers and clients, SSL/TLS, timers, strands, io_context, co_spawn, awaitable, async_read/async_write, asio::spawn, yield_context, or pre-C++20 completion-handler callbacks.
| File | Kind | Size |
|---|---|---|
| README.ar.md | markdown | 4.3 KB |
| README.en.md | markdown | 2.9 KB |
| SKILL.md | skill md | 13.9 KB |
| references/build.md | markdown | 3.0 KB |
| references/classic-boost.md | markdown | 1.7 KB |
| references/coroutines.md | markdown | 16.1 KB |
| references/pre-cpp20.md | markdown | 8.2 KB |
| references/ssl.md | markdown | 1.2 KB |
references/build.md
View on GitHub# Build Configuration
### Boost.Asio (header-only since Boost 1.74+)
```cmake
find_package(Boost REQUIRED)
find_package(OpenSSL REQUIRED) # if using SSL
find_package(Threads REQUIRED)
target_link_libraries(myapp PRIVATE
Boost::headers # header-only Asio
OpenSSL::SSL OpenSSL::Crypto # if using SSL
Threads::Threads
)
target_compile_features(myapp PRIVATE cxx_std_20)
# REQUIRED for GCC coroutine support — build will fail without this
target_compile_options(myapp PRIVATE
$<$<CXX_COMPILER_ID:GNU>:-fcoroutines>
)
# Optional: truly header-only (no Boost.System link needed)
target_compile_definitions(myapp PRIVATE BOOST_ERROR_CODE_HEADER_ONLY)
```
### Standalone Asio (always header-only)
```cmake
# Standalone Asio has no CMake config — use pkg-config or manual path
find_package(OpenSSL REQUIRED)
find_package(Threads REQUIRED)
# If installed via brew:
find_path(ASIO_INCLUDE_DIR asio.hpp HINTS /opt/homebrew/include)
target_include_directories(myapp PRIVATE ${ASIO_INCLUDE_DIR})
target_link_libraries(myapp PRIVATE OpenSSL::SSL OpenSSL::Crypto Threads::Threads)
target_compile_features(myapp PRIVATE cxx_std_20)
target_compile_definitions(myapp PRIVATE ASIO_STANDALONE)
target_compile_options(myapp PRIVATE
$<$<CXX_COMPILER_ID:GNU>:-fcoroutines>
)
```
### Dual-mode CMake (supports both)
```cmake
option(USE_STANDALONE_ASIO "Use standalone Asio instead of Boost.Asio" OFF)
find_package(OpenSSL REQUIRED)
find_package(Threads REQUIRED)
if(USE_STANDALONE_ASIO)
find_path(ASIO_INCLUDE_DIR asio.hpp HINTS /opt/homebrew/include)
target_include_directories(myapp PRIVATE ${ASIO_INCLUDE_DIR})
target_compile_definitions(myapp PRIVATE USE_STANDALONE_ASIO ASIO_STANDALONE)
else()
find_package(Boost REQUIRED)
target_link_libraries(myapp PRIVATE Boost::headers)
target_compile_definitions(myapp PRIVATE BOOST_ERROR_CODE_HEADER_ONLY)
endif()
target_link_libraries(myapp PRIVATE OpenSSL::SSL OpenSSL::Crypto Threads::Threads)
target_compile_features(myapp PRIVATE cxx_std_20)
target_compile_options(myapp PRIVATE $<$<CXX_COMPILER_ID:GNU>:-fcoroutines>)
```
## Header-Only Usage
**Boost.Asio:** Asio is header-only by default. The only thing that pulls in a Boost library to link is `boost::system::error_code`'s out-of-line symbols, so for a truly link-free build define **`BOOST_ERROR_CODE_HEADER_ONLY`**. `BOOST_ASIO_HEADER_ONLY` is rarely needed and only relevant if separate compilation was previously enabled; you do **not** normally need both.
**Define `BOOST_ERROR_CODE_HEADER_ONLY` in exactly ONE place — prefer CMake** (`target_compile_definitions`, as shown above). Defining it in CMake *and* with a source `#define` triggers `-Wmacro-redefined`. So in source, just include — no `#define`:
```cpp
#include <boost/asio.hpp>
#include <boost/asio/ssl.hpp>
#include <boost/asio/experimental/awaitable_operators.hpp>
```
**Standalone Asio:**
```cpp
#include <asio.hpp>
#include <asio/ssl.hpp>
#include <asio/experimental/awaitable_operators.hpp>
// No macros needed — always header-only
```
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| receiving-code-reviewobra/superpowersUse when receiving code review feedback, before implementing suggestions, especially if feedback seems unclear or technically questionable - requires technical rigor and verification, not performative agreement or blind implementation | Stars: 323k | Updated | Claude CodeCodex | Verified | Install |
| requesting-code-reviewobra/superpowersUse when completing tasks, implementing major features, or before merging to verify work meets requirements | Stars: 323k | Updated | Claude CodeCodex | Verified | Install |
| using-git-worktreesobra/superpowersUse when starting feature work that needs isolation from current workspace or before executing implementation plans - ensures an isolated workspace exists via native tools or git worktree fallback | Stars: 323k | Updated | Claude CodeCodex | Verified | Install |
| verification-before-completionobra/superpowersUse when about to claim work is complete, fixed, or passing, before committing or creating PRs - requires running verification commands and confirming output before making any success claims; evidence before assertions always | Stars: 323k | Updated | Claude CodeCodex | Verified | Install |