Sane Cpp Libraries
Developmentsane-cpp-librariesSane Cpp Libraries is an Agent Skill for development published in the Pagghiu/SaneCppLibraries repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.
Unified guidance for Sane C++ Libraries. Use when the user is adopting Sane C++ Libraries, choosing the right Sane library, looking for examples or tests, or working with Foundation, Memory, Strings, Containers, Async, Await, Socket, Http, File, FileSystem, Process, Time, Threading, Reflection, Serialization, Plugin, Build, Tools, or Testing.
How to use this skill
Bring this guide into your coding agent with a prompt tailored to the tool you use.
- Open your project in Codex.
- Copy and paste the prompt below.
- Review files and risks before approving any action.
Inspect the Agent Skill at https://github.com/Pagghiu/SaneCppLibraries/blob/HEAD/Skills/sane-cpp-libraries/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/sane-cpp-libraries, but wait for my approval before writing files or running scripts.
Copying this prompt does not install or run the skill. Review third-party files before use.
Sane C++ Libraries
Use this as the single installed skill for every Sane C++ Libraries request.
Start Here
- Read references/getting-started.md first.
- Then read the smallest matching topic guide under
references/*/guide.md. - Use references/topic-map.md when the request is broad, ambiguous, or spans multiple libraries.
Discovery Workflow
- Ground the answer in the repo-wide rules from
getting-started. - Pick one primary topic guide and at most one or two companion guides.
- Inspect the linked public headers, tests, examples, docs, or tools before answering.
- Prefer repo-specific guidance over generic C++ advice.
Topic Guides
Onboarding And Navigation
- Adoption and integration: references/adoption/guide.md
- Best examples, tests, docs, and source entry points: references/examples/guide.md
- SC.sh, SC.bat, and custom tool invocation: references/tools/guide.md
- SC::Build project setup: references/build/guide.md
- Test layout and SCTest usage: references/testing/guide.md
Core Types And Data Structures
- Global rules and adaptation patterns: references/core-patterns/guide.md
- Foundation primitives such as
Result,Span, andFunction: references/foundation/guide.md - Buffers, allocators, and owned storage: references/memory/guide.md
- Container choice and capacity behavior: references/containers/guide.md
- String formatting, conversion, and path helpers: references/strings/guide.md
- Time types and clock selection: references/time/guide.md
- Threads and synchronization primitives: references/threading/guide.md
I/O, Async, And Platforms
- Event loop, requests, and wake-up integration: references/async/guide.md
- Experimental coroutine wrapper over Async: references/await/guide.md
- Backpressure-aware stream pipelines: references/async-streams/guide.md
- Cross-library async composition recipes: references/async-networking/guide.md
- Raw synchronous sockets and DNS: references/socket/guide.md
- HTTP server, parser, and file server flows: references/http/guide.md
- Native-backend streaming HTTP client flows: references/http-client/guide.md
- Descriptor-based file and pipe I/O: references/file/guide.md
- Path-level filesystem operations: references/filesystem/guide.md
- Directory traversal: references/filesystem-iterator/guide.md
- File and folder change watching: references/filesystem-watcher/guide.md
- Child process launch and redirection: references/process/guide.md
- Serial port configuration and opening: references/serial-port/guide.md
Reflection, Serialization, And Plugins
- Reflection metadata and shape design: references/reflection/guide.md
- Reflection adapters for Sane containers: references/containers-reflection/guide.md
- End-to-end serialization choice and composition: references/serialization/guide.md
- Binary serialization flows: references/serialization-binary/guide.md
- Text and JSON serialization flows: references/serialization-text/guide.md
- Hashing algorithms and workflows: references/hashing/guide.md
- Runtime-loaded plugins and host exports: references/plugin/guide.md
- Plugin plus build-system integration recipes: references/plugin-build/guide.md