Agent skill

Cpp Coding

by timeplus-io in timeplus-io/proton

Write or review Timeplus/Proton C++20 code covering naming conventions, Proton fences, clang-format, IProcessor patterns, and checkpointing.

Apache-2.0Auto-check passedDevelopment

Install Cpp Coding

skills CLI
$ npx skills add timeplus-io/proton --skill cpp-coding -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install timeplus-io/proton cpp-coding --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/timeplus-io/proton.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/cpp-coding .claude/skills/cpp-coding && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
cpp-coding
GitHub stars
2.3k
Token cost
~582 tokens
SKILL.md length
119 words
Files
1
Skills in repo
7
Repo updated
First seen
Licence
Apache-2.0

At a glance

Write or review Timeplus/Proton C++20 code covering naming conventions, Proton fences, clang-format, IProcessor patterns, and checkpointing.

  • Any C++ code changes
  • SKILL.md covers Language, Naming conventions, Proton fences and IProcessor pattern (streaming…, plus 2 more sections
  • Calls git
  • Reviews in this codebase

What it does

Cpp Coding is an agent skill from timeplus-io/proton. Write or review Timeplus/Proton C++20 code covering naming conventions, Proton fences, clang-format, IProcessor patterns, and checkpointing. Make sure to use this skill for any C++ code changes, additions, or reviews in this codebase, including small fixes, new functions, refactoring, or style questions, even if the user doesn't explicitly mention coding conventions.

Its SKILL.md is about 580 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Development, covering Refactoring. It works with C++ and ClickHouse. The repository describes itself as: The Fastest Unified Streaming SQL Engine in a Single C++ Binary. ⚡ Millisecond latency. 100+ GB/s throughput. Continuously compute real-time context from streams, logs, metrics… The licence is Apache-2.0.

When your agent uses it

  • Any C++ code changes
  • Reviews in this codebase
  • Including small fixes
  • Style questions

Example prompts

  • “/cpp-coding”

What it can do on your machine

Read from SKILL.md and the folder at commit 1c47e60. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • git

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use git, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Cpp Coding loads about 582 tokens when it runs. Until then it costs about 95 tokens; SKILL.md has 119 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~95
When it runs · the whole SKILL.md, loaded when a task matches
~582

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from timeplus-io/proton at commit 1c47e60, republished under its Apache-2.0 licence (© timeplus-io). 119 words, ~582 tokens.

Download SKILL.mdSave it as .claude/skills/cpp-coding/SKILL.md (or your agent's skills folder).
name
cpp-coding
description
Write or review Timeplus/Proton C++20 code covering naming conventions, Proton fences, clang-format, IProcessor patterns, and checkpointing. Make sure to use this skill for any C++ code changes, additions, or reviews in this codebase, including small fixes, new functions, refactoring, or style questions, even if the user doesn't explicitly mention coding conventions.

C++ Coding

Language

C++20. Prefer standard library over custom implementations when appropriate.

Naming conventions

ElementStyleExample
FunctionslowerCamelCaseprocessStreamData(), handleWindowClose()
Variableslowercase_with_underscoresevent_count, window_start
ClassesPascalCaseStorageStream, AggregatedDataVariants
ConstantsPascalCase or UPPER_CASEPer existing codebase convention
NamespacesPascalCaseDB::Streaming

Proton fences

cpp
/// proton: starts
if (isStreamingQuery()) { handleStreamingPath(); }
/// proton: ends
  • Use ONLY in ClickHouse-inherited code (upstream-synced files)
  • NEVER fence in src/Storages/Stream/ or namespace DB::Streaming
  • NEVER nest fences

IProcessor pattern (streaming transforms)

All streaming transforms in src/Processors/Transforms/Streaming/ follow:

cpp
class MyTransform : public IProcessor {
    Status prepare() override;  // O(1), non-blocking, check readiness
    void work() override;       // Do actual processing
};

Stateful processors MUST also implement:

  • hasState() → return true
  • checkpoint(CheckpointContextPtr) → serialize state
  • recover(CheckpointContextPtr) → restore from checkpoint

Formatting

Only formats changed code blocks (not entire files). Uses .clang-format config at repo root. The configured brace style is Allman-like: opening braces normally go on a new line.

bash
git clang-format              # format unstaged changes in-place
git clang-format --staged     # format staged changes in-place
git clang-format --diff       # dry-run: show what would change
git clang-format <commit>     # format changes since <commit>

Comments

Use ///. Explain why, not what:

cpp
/// Use 10 seconds to allow late events
watermark_delay = 10;

© timeplus-io, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in .claude/skills/cpp-coding of timeplus-io/proton.

Open the folder on GitHubat commit 1c47e60

Compare with similar skills

Cpp Coding next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Cpp Coding compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Cpp Coding this skilltimeplus-io/proton2.3k—~582Automated safety check: PassApache-2.0
Databuddy Internaldatabuddy-analytics/Databuddy1.2k—~11kAutomated safety check: NotesAGPL-3.0
Embedded Cpp14 MisraBlueAndi/Pixelix443—~2kAutomated safety check: PassMIT
Ss Cpp ModernSerial-Studio/Serial-Studio7.2k—~1.6kAutomated safety check: PassCustom licence
Cpp ProYikai-Liao/symusic1891 repos~1.1kAutomated safety check: PassMIT
Readable Cppcrazyguitar/cppcheatsheet290—~6.4kAutomated safety check: PassMIT

Similar skills

  • Databuddy Internal

    databuddy-analytics/Databuddy

    Work inside the Databuddy monorepo for internal implementation, debugging, review, and refactoring.

    1.2k GitHub stars~11k tokensUpdated yesterday
    DevelopmentAuto-check: notes
  • Embedded Cpp14 Misra

    BlueAndi/Pixelix

    A skill your agent uses when writing, reviewing, or refactoring C/C++ firmware code in this repository (src/, lib/, test/) — creating or editing .h/.hpp/.cpp files, applying MISRA-oriented and…

    443 GitHub stars~2k tokensUpdated today
    DevelopmentAuto-check passed
  • Ss Cpp Modern

    Serial-Studio/Serial-Studio

    Modern C++20 authoring guidance for Serial Studio (Qt 6.11, C++20): concepts, ranges, move/RAII, std smart pointers, constexpr, lock-free SPSC atomics.

    7.2k GitHub stars~1.6k tokensUpdated yesterday
    DevelopmentAuto-check passed
  • Cpp Pro

    Yikai-Liao/symusic

    Writes, optimizes, and debugs C++ applications using modern C++20/23 features, template metaprogramming, and high-performance systems techniques.

    189 GitHub starsUsed in 1 repo~1.1k tokens
    DevelopmentAuto-check passed
  • Readable Cpp

    crazyguitar/cppcheatsheet

    Readable C/C++/Rust/CUDA code rules inspired by The Art of Readable Code.

    290 GitHub stars~6.4k tokensUpdated yesterday
    DevelopmentAuto-check passed
  • Qt Qml

    Serial-Studio/Serial-Studio

    QML authoring best practices for Serial Studio (Qt 6.11). An agent skill from Serial-Studio/Serial-Studio.

    7.2k GitHub stars~2.9k tokensUpdated yesterday
    DevelopmentAuto-check passed

More from timeplus-io/proton

  • Alloc Profile

    timeplus-io/proton

    Analyze jemalloc or async-profiler allocation profiles in collapsed stack format.

    2.3k GitHub stars~489 tokensUpdated 18 days ago
    Auto-check passed
  • Create Worktree

    timeplus-io/proton

    Create a Proton git worktree with local submodule reuse. An agent skill from timeplus-io/proton.

    2.3k GitHub stars~812 tokensUpdated 18 days ago
    Auto-check passed
  • Build And Verify

    timeplus-io/proton

    Build, compile, run server/client/cluster, execute unit/stateless/SQL tests, verify results, and troubleshoot build/test failures.

    2.3k GitHub stars~1.3k tokensUpdated 18 days ago
    Auto-check passed
  • SQL Usage

    timeplus-io/proton

    Timeplus streaming SQL covering stream types, EMIT policies, window functions, JOINs, materialized views, external streams, and UDFs.

    2.3k GitHub stars~1.7k tokensUpdated 18 days ago
    Auto-check passed
  • CI Diagnostics

    timeplus-io/proton

    Diagnose Proton CI failures and performance comparison results from GitHub checks and uploaded reports.

    2.3k GitHub stars~685 tokensUpdated 18 days ago
    Auto-check passed
  • Review

    timeplus-io/proton

    Review a Proton pull request or diff for correctness, streaming semantics, checkpointing, compatibility, and performance.

    2.3k GitHub stars~1.1k tokensUpdated 18 days ago
    Auto-check passed

Works with

Questions about Cpp Coding

What does Cpp Coding do?

Write or review Timeplus/Proton C++20 code covering naming conventions, Proton fences, clang-format, IProcessor patterns, and checkpointing. Cpp Coding is an agent skill from timeplus-io/proton. Write or review Timeplus/Proton C++20 code covering naming conventions, Proton fences, clang-format, IProcessor patterns, and checkpointing.

When should I use Cpp Coding?

Cpp Coding fits situations like: any C++ code changes; reviews in this codebase; including small fixes; style questions.

How do I install Cpp Coding in Claude Code?

Run `npx skills add timeplus-io/proton --skill cpp-coding -a claude-code`. Or copy the skill folder (.claude/skills/cpp-coding in timeplus-io/proton) into .claude/skills/cpp-coding in your project. Claude Code loads it when a task matches its description.

How do I install Cpp Coding in Codex?

Run `npx skills add timeplus-io/proton --skill cpp-coding -a codex`. Or copy the skill folder (.claude/skills/cpp-coding in timeplus-io/proton) into .agents/skills/cpp-coding in your project. Codex loads it when a task matches its description.

Can I use Cpp Coding in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add timeplus-io/proton --skill cpp-coding -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/cpp-coding, .gemini/skills/cpp-coding, .github/skills/cpp-coding and .opencode/skills/cpp-coding in your project.

What does Cpp Coding need to run?

Going by SKILL.md and its folder, Cpp Coding needs the command-line tools its instructions call (git).

Does Cpp Coding access the network?

SKILL.md contains no URLs. Its commands use git, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Cpp Coding safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Cpp Coding use?

Cpp Coding is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Cpp Coding use?

About 582 tokens (SKILL.md is roughly 2.3k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Cpp Coding?

Skills that share tags, products or a category with Cpp Coding: Databuddy Internal (databuddy-analytics/Databuddy, 1.2k stars), Embedded Cpp14 Misra (BlueAndi/Pixelix, 443 stars), Ss Cpp Modern (Serial-Studio/Serial-Studio, 7.2k stars) and Cpp Pro (Yikai-Liao/symusic, 189 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Cpp Coding?

timeplus-io (a GitHub organization) maintains it in timeplus-io/proton, which has 2,265 GitHub stars. The repository holds 7 skills in this directory. The repository was last updated on September 20, 2026.

Source: timeplus-io/proton on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.