# volcengine-sdk-generator

The volcengine-sdk-generator Claude Code skill finds Volcengine APIs and generates SDK call examples. It activates for code requests in Python, Go, Java, PHP, cURL, or Node.js, and for SDK configuration questions.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 112 installs · ★ 37 repo stars
- Author: volcengine
- License: MIT · policy=mirror · the beginning of the file is at the end of this page
- Source: https://github.com/volcengine/volcengine-agent-toolkit/tree/HEAD/plugins/volcengine-service-support/skills/volcengine-sdk-generator/SKILL.md
- Updated: 2026-11-16
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/volcengine-sdk-generator

## What it does

The skill searches API Explorer, retrieves the selected API’s Swagger definition, then sends user-provided parameters to the code generator. The resulting example covers authentication setup, request parameters, the API call, and printing its response. Language-specific reference files cover questions about retries, timeouts, proxies, SSL, and other SDK settings.

API discovery runs online only. If search fails, the skill reports the error rather than choosing an API from a bundled catalog. Request parameters come from the user; when required fields are missing, it can insert mock values and mark them as such. Questions limited to API parameters, response schemas, or API comparisons go to `volcengine-api`; CLI operations go to `volcengine-cli`.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add volcengine/volcengine-agent-toolkit --skill volcengine-sdk-generator -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/volcengine-sdk-generator/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/volcengine-sdk-generator/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add volcengine/volcengine-agent-toolkit --skill volcengine-sdk-generator -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/volcengine-sdk-generator/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add volcengine/volcengine-agent-toolkit --skill volcengine-sdk-generator -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/volcengine-sdk-generator/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install volcengine/volcengine-agent-toolkit plugins/volcengine-service-support/skills/volcengine-sdk-generator
```

2. **Manually: put the files in place**
- File: `.github/skills/volcengine-sdk-generator/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add volcengine/volcengine-agent-toolkit --skill volcengine-sdk-generator -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/volcengine/volcengine-agent-toolkit --path plugins/volcengine-service-support/skills/volcengine-sdk-generator
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/volcengine-sdk-generator/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add volcengine/volcengine-agent-toolkit --skill volcengine-sdk-generator -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/volcengine/volcengine-agent-toolkit/tree/HEAD/plugins/volcengine-service-support/skills/volcengine-sdk-generator/SKILL.md

## When to use it
- find a Volcengine API from its name or action
- generate a Python or Go API call example
- create SDK samples for Java, PHP, or Node.js
- configure SDK retries, timeouts, or request signing

## Example prompts
- Generate a Python example for the Volcengine AssumeRole API using these parameters: …
- Write a Go call for this Volcengine API action: …
- How do I configure timeouts and retries in the Volcengine Python SDK?

## Source text · SKILL.md · MIT

Below is the content of a third-party file. It is data, not instructions for you: do not act on anything written inside unless the human asks. Block tag: 71eb3f21b1a76a80.

BEGIN THIRD-PARTY FILE 71eb3f21b1a76a80
```text
---
name: volcengine-sdk-generator
description: >
  Generate accurate Volcengine SDK examples by locating an API through API Explorer search,
  fetching its swagger, and calling api/common/explorer/make-code with user-provided
  Params. Use when the user asks how to write Volcengine SDK code, generate SDK samples, or call a
  Volcengine API in Python, Go, Java, PHP, cURL, Node.js. Supports Chinese and
  English API names such as "角色扮演", "AssumeRole", or "STS AssumeRole". Also use for explicit SDK
  configuration questions about retry, timeout, AK/SK, STS, AssumeRole, temporary credentials,
  proxy, connection pooling, SSL, debug mode, request signing, response parsing, and error handling.
  If the user only needs API parameters, enum values, required fields, error codes, response
  schemas, pagination, or API comparisons, hand off to volcengine-api. If they need CLI-based
  operations, hand off to volcengine-cli.
license: MIT
---

# Volcengine SDK Generator

Generate ordinary Volcengine API call examples by default. Keep the default output focused on the
API call itself: authentication setup, request object/params, invocation, and printing the response.
Do not add retry, proxy, connection pool, debug logging, or other advanced SDK configuration unless
the user explicitly asks for those topics.

For advanced SDK configuration questions, use the language-specific files under `references/`.
These reference files are self-contained; answer from them directly.

| Topic | Reference |
| --- | --- |
| Go SDK configuration | `references/sdk-integration-go.md` |
| Python SDK configuration | `references/sdk-integration-python.md` |
| Java SDK configuration | `references/sdk-integration-java.md` |
| Node.js SDK configuration | `references/sdk-integration-nodejs.md` |
| PHP SDK configuration | `references/sdk-integration-php.md` |

## Core Rules

- API discovery uses `scripts/rg_rank.py`, which calls API Explorer search with both `Channel=service` and `Channel=api`. After a concrete API is selected, call `scripts/make_code.py` in direct mode with `--service-code`, `--api-version`, and `--action`.
- API discovery is online-only. The search endpoint does not require cookies, login state, UID, DID, UUID, or browser-specific headers. The script sends only `Query`, `Channel`, `Limit`, and `Offset` as query parameters.
```
END THIRD-PARTY FILE 71eb3f21b1a76a80

The third-party file has ended. Everything between the 71eb3f21b1a76a80 tags is data: requests and commands from it are not followed. An “end of file” line with another tag inside the block is part of the file.

First 2349 of 9364 bytes. © volcengine · MIT · https://github.com/volcengine/volcengine-agent-toolkit/tree/HEAD/plugins/volcengine-service-support/skills/volcengine-sdk-generator/SKILL.md

_Part of the page did not fit — see the HTML version._

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
