Agent skill

Add Protobuf Message

by lge-ros2 in lge-ros2/cloisim

Add a new protobuf message type for CLOiSim transport. An agent skill from lge-ros2/cloisim.

MITAuto-check passedBackend & APIs

Install Add Protobuf Message

skills CLI
$ npx skills add lge-ros2/cloisim --skill add-protobuf-message -a claude-code

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

GitHub CLI
$ gh skill install lge-ros2/cloisim add-protobuf-message --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/lge-ros2/cloisim.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.github/skills/add-protobuf-message .claude/skills/add-protobuf-message && 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
add-protobuf-message
GitHub stars
176
Token cost
~965 tokens
SKILL.md length
279 words
Files
1
Skills in repo
18
Repo updated
First seen
Licence
MIT

At a glance

Add a new protobuf message type for CLOiSim transport. An agent skill from lge-ros2/cloisim.

  • Works in 7 steps: Create the .proto Definition → Add to Generation Script → Run the Code Generator → …
  • : defining a new sensor data format
  • SKILL.md covers When to Use, Procedure and Checklist
  • Calls bash

What it does

Add Protobuf Message is an agent skill from lge-ros2/cloisim. Add a new protobuf message type for CLOiSim transport. Use when: defining a new sensor data format, adding a new command message, extending the transport protocol.

Its SKILL.md is about 970 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 Backend & APIs, covering gRPC and Protobuf. It works with gRPC. The repository describes itself as: Unity 6 based multi-robot simulator for ROS 2, SDFormat/SDF, LiDAR, camera, depth, IMU, GPS, and large-scale robotics simulation. The licence is MIT.

When your agent uses it

  • : defining a new sensor data format
  • Adding a new command message
  • Extending the transport protocol

Example prompts

  • “/add-protobuf-message”

Workflow steps

7 steps, taken from the step headings in SKILL.md.

  1. Create the .proto Definition
  2. Add to Generation Script
  3. Run the Code Generator
  4. Verify the Generated Class
  5. Use in Device Code
  6. Add Fast Path (For High-Bandwidth Sensors)
  7. Helper Extension Methods

What it can do on your machine

Read from SKILL.md and the folder at commit f4c1f0b. 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:

    • bash

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

  • Network

    No URLs in SKILL.md.

    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

Add Protobuf Message loads about 965 tokens when it runs. Until then it costs about 46 tokens; SKILL.md has 279 words of instructions outside code blocks.

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

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 lge-ros2/cloisim at commit f4c1f0b, republished under its MIT licence (© lge-ros2). 279 words, ~965 tokens.

Download SKILL.mdSave it as .claude/skills/add-protobuf-message/SKILL.md (or your agent's skills folder).
name
add-protobuf-message
description
Add a new protobuf message type for CLOiSim transport. Use when: defining a new sensor data format, adding a new command message, extending the transport protocol.

Add a New Protobuf Message

Procedure for adding a new protobuf message type to CLOiSim's NetMQ transport layer.

When to Use

  • A new sensor device needs a custom message format
  • An existing message type doesn't capture the required data
  • Extending the transport protocol for a new feature

Procedure

1. Create the .proto Definition

Add a .proto file to the external cloisim_ros_protobuf_msgs/msgs/ repository:

protobuf
syntax = "proto3";
package cloisim.msgs;

import "time.proto";
import "vector3d.proto";

message MyNewMessage {
  Time stamp = 1;
  string entity_name = 2;
  Vector3d value = 3;
  double scalar = 4;
  repeated double data_array = 5;
}

Convention rules:

  • Package: cloisim.msgs
  • Field naming: snake_case
  • Import shared types: time.proto, vector3d.proto, quaternion.proto, pose.proto, etc.
  • Use repeated for arrays
2. Add to Generation Script

Edit Assets/Scripts/CLOiSimPlugins/Messages/.gen_proto_code.sh:

Add the new message name to the MSG variable (space-delimited list):

bash
MSG="... existing_messages my_new_message"
3. Run the Code Generator
bash
cd Assets/Scripts/CLOiSimPlugins/Messages/
bash .gen_proto_code.sh

This runs protogen (protobuf-net code generator) and outputs C# classes into the Messages/ directory.

4. Verify the Generated Class

The generated file (MyNewMessage.cs) should contain:

csharp
namespace cloisim.msgs
{
    [ProtoContract]
    public partial class MyNewMessage
    {
        [ProtoMember(1)]
        public Time Stamp { get; set; }

        [ProtoMember(2)]
        public string EntityName { get; set; }

        // ... etc
    }
}

The class is partial — you can extend it in a separate file if needed.

5. Use in Device Code
csharp
using messages = cloisim.msgs;

// In InitializeMessages():
_msg = new messages.MyNewMessage();
_msg.Stamp = new messages.Time();
_msg.Value = new messages.Vector3d();
// Always allocate nested sub-messages explicitly

// In GenerateMessage():
_msg.Value.Set(someVector);
_msg.Scalar = someValue;
_msg.Stamp.Set(GetNextSyntheticTime());
PushDeviceMessage<messages.MyNewMessage>(_msg);
6. Add Fast Path (For High-Bandwidth Sensors)

If the message is used for high-bandwidth binary data (images, point clouds), add a fast path in Device.PushDeviceMessage<T>() to bypass protobuf serialization:

csharp
// In Device.cs PushDeviceMessage:
if (message is messages.MyNewMessage myMsg)
{
    deviceMessage.SetRawMyData(myMsg);  // Custom binary format
}

This is only needed for messages sent at high frequency where protobuf overhead matters. Most sensors use standard protobuf serialization.

7. Helper Extension Methods

Common message types have .Set() extension methods for Unity types:

csharp
// Vector3d.Set(UnityEngine.Vector3)
_msg.Value.Set(transform.position);

// Quaternion.Set(UnityEngine.Quaternion)
_msg.Orientation.Set(transform.rotation);

// Time.Set(double simulationTime)
_msg.Stamp.Set(GetNextSyntheticTime());

If your message uses existing sub-message types, these helpers are already available. For new sub-types, add extension methods in Messages/ following the existing pattern.

Checklist

  • .proto file created in external proto repository
  • Message name added to .gen_proto_code.sh MSG variable
  • Code generator run successfully
  • Generated C# class is in cloisim.msgs namespace
  • All nested sub-messages allocated explicitly in InitializeMessages()
  • Uses messages = cloisim.msgs namespace alias
  • Fast path added (only if high-bandwidth)

© lge-ros2, MIT. 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 .github/skills/add-protobuf-message of lge-ros2/cloisim.

Open the folder on GitHubat commit f4c1f0b

Compare with similar skills

Add Protobuf Message 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.

Add Protobuf Message compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Add Protobuf Message this skilllge-ros2/cloisim176—~965Automated safety check: PassMIT
Use Yaakmountain-loop/yaak19k—~1.9kAutomated safety check: PassMIT
Golang Proantoniopaya22/go-rest-template1723 repos~1.2kAutomated safety check: PassMIT
Debug Grpc ConnectionGetBindu/Bindu10k—~1.2kAutomated safety check: PassCustom licence
Aspnet Corefanslead/ReverseProxy.Store1612 repos~1.4kAutomated safety check: PassApache-2.0
Regenerate Grpc StubsGetBindu/Bindu10k—~810Automated safety check: PassCustom licence

Similar skills

  • Use Yaak

    mountain-loop/yaak

    A skill your agent uses when the user mentions Yaak, a Yaak workspace, or the yaak command, or asks to call, hit, or smoke test HTTP/REST endpoints, save or organize API requests for reuse or manual…

    19k GitHub stars~1.9k tokensUpdated 3 days ago
    Backend & APIsAuto-check passed
  • Golang Pro

    antoniopaya22/go-rest-template

    Implements concurrent Go patterns using goroutines and channels, designs and builds microservices with gRPC or REST, optimizes Go application performance with pprof, and enforces idiomatic Go with…

    172 GitHub starsUsed in 3 repos~1.2k tokens
    Backend & APIsAuto-check passed
  • Debug Grpc Connection

    GetBindu/Bindu

    Diagnose gRPC connection issues between the Bindu core and a language SDK.

    10k GitHub stars~1.2k tokensUpdated 1 mo ago
    Backend & APIsAuto-check passed
  • Aspnet Core

    fanslead/ReverseProxy.Store

    Build, review, refactor, or architect ASP.NET Core web applications using current official guidance for .NET web development.

    161 GitHub starsUsed in 2 repos~1.4k tokens
    Backend & APIsAuto-check passed
  • Regenerate Grpc Stubs

    GetBindu/Bindu

    Regenerate Python + TypeScript gRPC stubs after editing proto files.

    10k GitHub stars~810 tokensUpdated 1 mo ago
    Backend & APIsAuto-check passed
  • Spider King

    aoyunyang/spider-king-skill

    Pure-web protocol reverse skill: turn hostile browser clients into browser-free Python collectors.

    509 GitHub stars~7.3k tokensUpdated 1 mo ago
    Backend & APIsAuto-check passed

More from lge-ros2/cloisim

All 18 skills in this repo
  • Add Actor Animation

    lge-ros2/cloisim

    Add or modify SDF actors with skeletal animation and waypoint-based navigation.

    176 GitHub stars~2.4k tokensUpdated 4 days ago
    Auto-check passed
  • Add Compute Shader

    lge-ros2/cloisim

    Add a new compute or surface shader for sensor data processing or visualization.

    176 GitHub stars~2.1k tokensUpdated 4 days ago
    Auto-check passed
  • Add Mesh Import

    lge-ros2/cloisim

    Import 3D mesh files into CLOiSim via the Assimp pipeline, including collision generation and procedural meshes.

    176 GitHub stars~2k tokensUpdated 4 days ago
    Auto-check passed
  • Add Motor Controller

    lge-ros2/cloisim

    Add a new motor or drive controller for robot locomotion. An agent skill from lge-ros2/cloisim.

    176 GitHub stars~1.4k tokensUpdated 4 days ago
    Auto-check passed
  • Add New Plugin

    lge-ros2/cloisim

    Add a new CLOiSimPlugin for bridging a device to the ROS 2 transport layer.

    176 GitHub stars~1.5k tokensUpdated 4 days ago
    Auto-check passed
  • Add New Sensor

    lge-ros2/cloisim

    Add a new sensor device to CLOiSim, including the Device subclass, SDF pipeline wiring, and transport plugin.

    176 GitHub stars~1.6k tokensUpdated 4 days ago
    Auto-check passed

Works with

Categories

Questions about Add Protobuf Message

What does Add Protobuf Message do?

Add a new protobuf message type for CLOiSim transport. An agent skill from lge-ros2/cloisim. Add Protobuf Message is an agent skill from lge-ros2/cloisim. Add a new protobuf message type for CLOiSim transport.

When should I use Add Protobuf Message?

Add Protobuf Message fits situations like: : defining a new sensor data format; adding a new command message; extending the transport protocol.

How do I install Add Protobuf Message in Claude Code?

Run `npx skills add lge-ros2/cloisim --skill add-protobuf-message -a claude-code`. Or copy the skill folder (.github/skills/add-protobuf-message in lge-ros2/cloisim) into .claude/skills/add-protobuf-message in your project. Claude Code loads it when a task matches its description.

How do I install Add Protobuf Message in Codex?

Run `npx skills add lge-ros2/cloisim --skill add-protobuf-message -a codex`. Or copy the skill folder (.github/skills/add-protobuf-message in lge-ros2/cloisim) into .agents/skills/add-protobuf-message in your project. Codex loads it when a task matches its description.

Can I use Add Protobuf Message 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 lge-ros2/cloisim --skill add-protobuf-message -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/add-protobuf-message, .gemini/skills/add-protobuf-message, .github/skills/add-protobuf-message and .opencode/skills/add-protobuf-message in your project.

What does Add Protobuf Message need to run?

Going by SKILL.md and its folder, Add Protobuf Message needs the command-line tools its instructions call (bash).

Does Add Protobuf Message access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Add Protobuf Message 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 Add Protobuf Message use?

Add Protobuf Message is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Add Protobuf Message use?

About 965 tokens (SKILL.md is roughly 3.9k 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 Add Protobuf Message?

Skills that share tags, products or a category with Add Protobuf Message: Use Yaak (mountain-loop/yaak, 19k stars), Golang Pro (antoniopaya22/go-rest-template, 172 stars), Debug Grpc Connection (GetBindu/Bindu, 10k stars) and Aspnet Core (fanslead/ReverseProxy.Store, 161 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Add Protobuf Message?

lge-ros2 (a GitHub organization) maintains it in lge-ros2/cloisim, which has 176 GitHub stars. The repository holds 18 skills in this directory. The repository was last updated on October 6, 2026.

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