Repository skill

One skill, many small routes.

The Sane C++ skill is not a long catalog. It is an agent-facing map: start with the shared rules, choose the smallest matching topic, then inspect the actual headers, tests, examples, docs, or tools before editing code.

User request

Adopt, debug, extend, or review a Sane C++ library.

Skill router

Read getting-started, then select the relevant topic route.

Repo evidence

Ground the answer in source, tests, examples, and generated docs.

1 Installed skill

One entry point for the whole repo

33 Topic guides

Loaded only when the request needs them

69 Reference files

Extra detail behind the guides

Progressive disclosure

Agents should not load the whole repository manual for every request. The skill keeps context small by opening only the repo-wide rules, one primary topic guide, and at most a couple of companion guides.

That makes the agent faster, but more importantly it keeps the active context relevant enough that it can stay under control.

Orthogonal routes

Each route answers one kind of question: build setup, async I/O, containers, serialization, plugin loading, tests, examples, and so on. The guides overlap as little as practical, so an agent can find the right boundary without receiving generic C++ advice.

Open skill source

Structure

How the skill is shaped

The root file is intentionally short. Deeper reference files sit behind topic guides and are pulled in only when the task needs that detail.

Skills/sane-cpp-libraries
  SKILL.md
  agents/openai.yaml
  references/getting-started.md
  references/topic-map.md
  references/<topic>/guide.md
  references/<topic>/references/*.md

Start shared

Read the global repository rules before choosing a library-specific path.

Narrow quickly

Pick the smallest topic guide that matches the requested change.

Verify locally

Inspect headers, tests, examples, docs, or tools before producing a patch.

Topic routes

What the skill can route to

Onboarding And Navigation

Adoption and integration
Best examples, tests, docs, and source entry points
SC.sh, SC.bat, and custom tool invocation
SC::Build project setup
Test layout and SCTest usage

Core Types And Data Structures

Global rules and adaptation patterns
Foundation primitives such as Result, Span, and Function
Buffers, allocators, and owned storage
Container choice and capacity behavior
String formatting, conversion, and path helpers
Time types and clock selection

+ 1 more routes

I/O, Async, And Platforms

Event loop, requests, and wake-up integration
Experimental coroutine wrapper over Async
Backpressure-aware stream pipelines
Cross-library async composition recipes
Raw synchronous sockets and DNS
HTTP server, parser, and file server flows

+ 7 more routes

Reflection, Serialization, And Plugins

Reflection metadata and shape design
Reflection adapters for Sane containers
End-to-end serialization choice and composition
Binary serialization flows
Text and JSON serialization flows
Hashing algorithms and workflows

+ 2 more routes

Sane C++ Libraries

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.

sane-cpp-libraries