Back to Serial Studio

Repo Skills (Claude Code)

doc/claude/repo-skills.md

4.0.11.8 KB
Original Source

Repo Skills (Claude Code)

Project-scoped Agent Skills live in .claude/skills/ and load automatically for anyone running Claude Code in this repo (committed to git, no install step). Invoke with /<name> or let them auto-trigger. Keep them current when the workflows they encode change.

SkillUse it when
ss-hotpathEditing/reviewing the data hotpath (FrameReader, CircularBuffer, FrameBuilder, Dashboard draw). Auto-activates on those paths. Encodes the SPSC/DirectConnection/slot-pool rules and the --benchmark-hotpath 256 kHz check.
ss-new-driverAdding a new I/O driver / data source under app/src/IO/Drivers/. Encodes the BluetoothLE reference pattern and every registration touch-point.
ss-verifyBefore committing, or any "lint / check conventions / sanitize" request. Wraps code-verify.py + sanitize-commit.py.
qt-cpp-reviewReviewing/auditing C++ (or "before I commit"). Runs code-verify.py as phase 1, then six parallel read-only agents (model contracts, ownership, thread-safety + hotpath, API correctness, error handling, perf). Adapted from The Qt Company's qt-cpp-review; read-only.
ss-cpp-modernAuthoring/refactoring non-trivial C++ and you want the idiomatic modern-C++20 shape (smart-pointer choice, RAII wrapper, concept-constrained template, atomics). Adapted from jeffallan's cpp-pro; defers style/build/sanitize to the scripts and the other skills.
cpp-compiler-flagsReading/changing the cmake flag modules (Optimization/Hardening/Sanitizers/MiMalloc), tuning -O/-march/LTO/PGO, adding a per-toolchain branch, or explaining a flag. Encodes the repo's real flag layout + invariants (IEEE-stable math, Lua unwind tables, x86-64-v2, two-stage PGO) and a cross-compiler flag catalog. Read-only on the build; never invokes cmake.