Agent skill

Use Buf Plugins

by moeru-ai in moeru-ai/auv

Select, pin, configure, install, build, and troubleshoot Buf code-generation plugins across remote BSR and local execution.

Apache-2.0Auto-check passedBackend & APIs

Install Use Buf Plugins

skills CLI
$ npx skills add moeru-ai/auv --skill use-buf-plugins -a claude-code

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

GitHub CLI
$ gh skill install moeru-ai/auv use-buf-plugins --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/moeru-ai/auv.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/use-buf-plugins .claude/skills/use-buf-plugins && 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
use-buf-plugins
GitHub stars
100
Token cost
~1.3k tokens
SKILL.md length
635 words
Files
4 (incl. references)
Repo updated
First seen
Licence
Apache-2.0

At a glance

Select, pin, configure, install, build, and troubleshoot Buf code-generation plugins across remote BSR and local execution.

  • Works in 4 steps: Read repository instructions, every… → Identify each required artifact: message… → Record plugin source, version/revision,… → …
  • Buf.gen.yaml plugin entries
  • SKILL.md covers Inspect the Existing…, Choose Remote or Local…, Source and Package Local… and Configure Outputs by Ecosystem, plus 1 more section
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Use Buf Plugins is an agent skill from moeru-ai/auv. Select, pin, configure, install, build, and troubleshoot Buf code-generation plugins across remote BSR and local execution. Use for buf.gen.yaml plugin entries, protoc-gen- tools, generated Go/Python/TypeScript/OpenAPI outputs, offline generation, BSR connectivity or rate-limit failures, OCI-packaged plugin wrappers, or reproducing plugins from bufbuild/plugins.

Its SKILL.md is about 1.3k tokens, which your agent loads only when the skill is triggered. The skill folder holds 5 other files, including reference files (for example `agents/openai.yaml`, `references/language-generators.md` and `references/remote-and-local.md`).

It sits in Backend & APIs, covering Rate limiting and OpenAPI specifications. It works with OpenAPI, Python and TypeScript. The repository describes itself as: 📱🐭 No we are not computer use, it's Application Use Via... a unified orchestration layer of OS automation, 0 token cost. The licence is Apache-2.0.

When your agent uses it

  • Buf.gen.yaml plugin entries
  • Protoc-gen- tools
  • Generated Go/Python/TypeScript/OpenAPI outputs
  • Offline generation

Example prompts

  • “/use-buf-plugins”

Requirements

  • Docker

Workflow steps

4 steps, taken from the first numbered list in SKILL.md.

  1. Read repository instructions, every applicable buf.gen*.yaml, generation script, CI workflow, package manifest, and generated directory…
  2. Identify each required artifact: message runtime, gRPC client/server, gateway, OpenAPI, language typing, or framework bindings.
  3. Record plugin source, version/revision, options, invocation strategy, input scope, output path, and runtime requirements.
  4. Do not replace a working generator or rearrange generated paths without an explicit requirement.

What it can do on your machine

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

    No scripts in the folder and no shell commands in SKILL.md.

    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

Use Buf Plugins loads about 1.3k tokens when it runs, and up to ~2.8k if it reads all its reference files. Until then it costs about 95 tokens; SKILL.md has 635 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
~1.3k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~2.8k

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 moeru-ai/auv at commit 4042350, republished under its Apache-2.0 licence (© moeru-ai). 635 words, ~1,347 tokens.

Download SKILL.mdSave it as .claude/skills/use-buf-plugins/SKILL.md (or your agent's skills folder). This skill also uses 3 other files; get the full folder from GitHub.
name
use-buf-plugins
description
Select, pin, configure, install, build, and troubleshoot Buf code-generation plugins across remote BSR and local execution. Use for buf.gen.yaml plugin entries, protoc-gen-* tools, generated Go/Python/TypeScript/OpenAPI outputs, offline generation, BSR connectivity or rate-limit failures, OCI-packaged plugin wrappers, or reproducing plugins from bufbuild/plugins.

Use Buf Plugins

Make code generation reproducible across languages and environments. Prefer an established generator, pin its version, preserve source-relative package structure, and verify generated output.

Inspect the Existing Generation Contract

  1. Read repository instructions, every applicable buf.gen*.yaml, generation script, CI workflow, package manifest, and generated directory convention.
  2. Identify each required artifact: message runtime, gRPC client/server, gateway, OpenAPI, language typing, or framework bindings.
  3. Record plugin source, version/revision, options, invocation strategy, input scope, output path, and runtime requirements.
  4. Do not replace a working generator or rearrange generated paths without an explicit requirement.

Choose Remote or Local Deliberately

Use a BSR remote plugin when network access is reliable and centralized execution is acceptable. Pin the upstream plugin version and revision when available; do not rely on latest for reproducible generation.

Use a local plugin when:

  • generation must work offline or in an isolated network;
  • the BSR is unavailable;
  • authentication or codegen rate limits make remote generation unreliable;
  • a private/custom plugin cannot run remotely;
  • CI requires locally controlled binaries or images.

Remote generation sends the Protobuf input to the configured BSR executor. Confirm that this is acceptable for private schemas. Authenticate with the repository's approved mechanism when increased BSR limits are needed; never embed tokens in config.

Read references/remote-and-local.md before changing plugin execution mode.

Source and Package Local Plugins Reproducibly

  • Prefer the plugin author's official binary/package or the upstream definitions in bufbuild/plugins.
  • Treat each upstream plugin Dockerfile, version, and revision as immutable build input.
  • A maintained mirror may build selected upstream bufbuild/plugins Dockerfiles into OCI images. Verify its source mapping, image entrypoint, version tag, platforms, provenance, and update cadence before depending on it.
  • If using a maintained buf-build mirror, understand the convention: an upstream path like plugins/<family>/<plugin>/<version>/Dockerfile is published as an image whose repository identifies <family>-<plugin> and whose tag identifies <version>. Reinspect the mirror documentation instead of hardcoding one publisher, version, or registry.
  • If the maintained image is acceptable, consume a pinned digest or immutable version. Otherwise build the upstream definition locally.
  • Invoke $use-docker-buildx-for-building before building or smoke-testing any plugin OCI image. Follow its platform, --load, naming, secret, runtime, and cleanup requirements.

OCI images are not automatically Buf local plugins. Buf expects an executable that reads a CodeGeneratorRequest from stdin and writes a CodeGeneratorResponse to stdout. Provide a narrow executable wrapper only after inspecting the image entrypoint; preserve stdin/stdout, forward arguments, use --rm, and never allocate a TTY.

Show full SKILL.md (237 more words)Show less

Configure Outputs by Ecosystem

  • Generate both runtime and service bindings required by the application.
  • For Go, follow the official Go generated-code and gRPC plugin guidance and honor go_package/managed-mode decisions.
  • For Python, generate runtime modules, gRPC bindings, and .pyi typing where the toolchain supports them.
  • For TypeScript, generate the ecosystem's customary .ts or declaration artifacts.
  • For OpenAPI, use the repository's established grpc-gateway/OpenAPI generator and annotations. Do not hand-maintain a second schema generator.
  • Keep output paths aligned with Protobuf source/package paths unless an explicit buf.gen.yaml convention says otherwise.
  • Pin generated-code runtime dependencies in each language package manager as well as pinning generators; generator reproducibility does not guarantee runtime compatibility.

Read references/language-generators.md before adding or replacing a language generator.

Validate Plugin Changes

  1. Run the plugin binary or OCI wrapper with a bounded smoke check appropriate to its entrypoint.
  2. Run buf lint.
  3. Run buf generate with every affected template.
  4. Run buf breaking --against '.git#branch=main'.
  5. Inspect the generated diff for missing files, unexpected path changes, nondeterminism, and stale artifacts.
  6. Run target-language formatting, compilation, tests, and type checks.
  7. Repeat generation from a clean state when reproducibility is uncertain; generated output should be stable.
  8. For an air-gapped contract, repeat the complete generation with networking disabled and no hidden image pull or ambient PATH dependency.

Never pass registry credentials, source credentials, or private dependency tokens through Docker build arguments, image layers, generated files, or committed plugin wrappers.

© moeru-ai, 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

SKILL.md and 3 other files (references) in .agents/skills/use-buf-plugins of moeru-ai/auv.

  • SKILL.md
  • agents/openai.yaml
  • references/language-generators.md
  • references/remote-and-local.md

Open the folder on GitHubat commit 4042350

Compare with similar skills

Use Buf Plugins 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.

Use Buf Plugins compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Use Buf Plugins this skillmoeru-ai/auv100—~1.3kAutomated safety check: PassApache-2.0
E2a Integratetokencanopy/e2a193—~840Automated safety check: PassApache-2.0
Code Documenterzebbern/claude-code-guide4.7k—~1kAutomated safety check: PassMIT
Implementing API Patternsancoleman/ai-design-components525—~3kAutomated safety check: PassMIT
Castai SDK Patternsjeremylongshore/tons-of-skills-marketplace2.8k—~1.1kAutomated safety check: PassMIT
Code DocumenterJeffallan/claude-skills12k—~1.5kAutomated safety check: PassMIT

Similar skills

  • E2a Integrate

    tokencanopy/e2a

    A skill your agent uses when adding e2a email capabilities to an application or codebase: outbound sending, inbound signed webhooks, REST polling, or SDK integration.

    193 GitHub stars~840 tokensUpdated yesterday
    Backend & APIsAuto-check passed
  • Code Documenter

    zebbern/claude-code-guide

    A skill your agent uses when adding docstrings, creating API documentation, or building documentation sites.

    4.7k GitHub stars~1k tokensUpdated yesterday
    Backend & APIsAuto-check passed
  • Implementing API Patterns

    ancoleman/ai-design-components

    API design and implementation across REST, GraphQL, gRPC, and tRPC patterns.

    525 GitHub stars~3k tokensUpdated 10 mo ago
    Backend & APIsAuto-check passed
  • Castai SDK Patterns

    jeremylongshore/tons-of-skills-marketplace

    Build a production REST adapter for CAST AI from the current OpenAPI contract without inventing an unofficial SDK surface.

    2.8k GitHub stars~1.1k tokensUpdated yesterday
    Backend & APIsAuto-check passed
  • Code Documenter

    Jeffallan/claude-skills

    Generates and validates docstrings, OpenAPI specs, JSDoc annotations and user guides, running every code example through a real compiler or linter before reporting coverage.

    12k GitHub stars~1.5k tokensUpdated 7 days ago
    DevelopmentAuto-check passed
  • MCP Server Builder

    alirezarezvani/claude-skills

    Design and ship production-ready MCP (Model Context Protocol) servers from OpenAPI contracts instead of hand-written tool wrappers.

    28k GitHub stars~985 tokensUpdated 1 mo ago
    Agent WorkflowsAuto-check passed

More from moeru-ai/auv

All 8 skills in this repo
  • Prepare, diagnose, and validate Linux GPU and Wayland environments for AUV rendering and capture through XDG Desktop Portal and PipeWire.

    100 GitHub stars~1.7k tokensUpdated today
    Auto-check passed
  • Use Buf

    moeru-ai/auv

    Configure, inspect, update, validate, and troubleshoot Buf workspaces and modules.

    100 GitHub stars~1k tokensUpdated today
    Auto-check passed
  • Domain CLI

    moeru-ai/auv

    A skill your agent uses when building CLI tools. An agent skill from moeru-ai/auv.

    100 GitHub starsUsed in 1 repo~988 tokens
    Auto-check passed
  • Use Protobuf

    moeru-ai/auv

    Design, change, and review Protobuf schemas used as gRPC contracts, streaming protocols, typed data models, grpc-gateway REST APIs, OpenAPI specifications, or generated SDK inputs.

    100 GitHub stars~1.6k tokensUpdated today
    Auto-check passed
  • A skill your agent uses when building cloud-native apps. An agent skill from moeru-ai/auv.

    100 GitHub starsUsed in 1 repo~1k tokens
    Auto-check passed
  • Domain ML

    moeru-ai/auv

    A skill your agent uses when building ML/AI apps in Rust. An agent skill from moeru-ai/auv.

    100 GitHub starsUsed in 1 repo~1.2k tokens
    Auto-check passed

Categories

Questions about Use Buf Plugins

What does Use Buf Plugins do?

Select, pin, configure, install, build, and troubleshoot Buf code-generation plugins across remote BSR and local execution. Use Buf Plugins is an agent skill from moeru-ai/auv. Select, pin, configure, install, build, and troubleshoot Buf code-generation plugins across remote BSR and local execution.

When should I use Use Buf Plugins?

Use Buf Plugins fits situations like: buf.gen.yaml plugin entries; protoc-gen- tools; generated Go/Python/TypeScript/OpenAPI outputs; offline generation.

How do I install Use Buf Plugins in Claude Code?

Run `npx skills add moeru-ai/auv --skill use-buf-plugins -a claude-code`. Or copy the skill folder (.agents/skills/use-buf-plugins in moeru-ai/auv) into .claude/skills/use-buf-plugins in your project. Claude Code loads it when a task matches its description.

How do I install Use Buf Plugins in Codex?

Run `npx skills add moeru-ai/auv --skill use-buf-plugins -a codex`. Or copy the skill folder (.agents/skills/use-buf-plugins in moeru-ai/auv) into .agents/skills/use-buf-plugins in your project. Codex loads it when a task matches its description.

Can I use Use Buf Plugins 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 moeru-ai/auv --skill use-buf-plugins -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/use-buf-plugins, .gemini/skills/use-buf-plugins, .github/skills/use-buf-plugins and .opencode/skills/use-buf-plugins in your project.

What does Use Buf Plugins need to run?

SKILL.md names no scripts, command-line tools or credentials: Use Buf Plugins is instructions for the agent only. Our summary lists: Docker.

Does Use Buf Plugins 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 Use Buf Plugins 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 Use Buf Plugins use?

Use Buf Plugins 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 Use Buf Plugins use?

About 1.3k tokens (SKILL.md is roughly 5.4k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 1.4k tokens, read only when the agent opens those files.

What are the alternatives to Use Buf Plugins?

Skills that share tags, products or a category with Use Buf Plugins: E2a Integrate (tokencanopy/e2a, 193 stars), Code Documenter (zebbern/claude-code-guide, 4.7k stars), Implementing API Patterns (ancoleman/ai-design-components, 525 stars) and Castai SDK Patterns (jeremylongshore/tons-of-skills-marketplace, 2.8k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Use Buf Plugins?

moeru-ai (a GitHub organization) maintains it in moeru-ai/auv, which has 100 GitHub stars. The repository was last updated on October 11, 2026.

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