volcengine-troubleshooting SKILL.md skillA
volcengine-troubleshooting from volcengine/volcengine-agent-toolkit is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.
mdr add volcengine/volcengine-agent-toolkit/volcengine-troubleshooting@git:20261019.8a5d3dcPins git:20261019.8a5d3dc in mdr.lock. Pin the fingerprint instead.
- Audit grade
- A, 17 of 17 checks passed
- Kind
- SKILL.md skill
- Repository
- volcengine/volcengine-agent-toolkit
- Path
plugins/volcengine-core/skills/volcengine-troubleshooting/SKILL.md- Versions recorded
- 4
- Latest version
- git:20261019.8a5d3dc, committed Oct 19, 2026
- First version recorded
- Aug 10, 2026
- Size
- 6,549 bytes
- Repository stars
- 26
- License
- MIT
Use when the user encounters VolcEngine errors or needs local troubleshooting for OpenAPI, Python SDK, CLI, IAM, billing, compute, networking, storage, database, CDN, media, AI, security, or VKE cases.
Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.
What the file says
# VolcEngine Troubleshooting
本 skill 面向用户本地环境使用，目标是在不修改云上资源的前提下，帮助定位 VolcEngine 产品、OpenAPI、Python SDK、`ve`/`tosutil` CLI 和控制台操作失败的原因。主入口只保留必要的启动规则、场景路由和安全边界；本地工具检查与完整领域索引放在 `references/getting-started.md`，OpenAPI 报错、签名、鉴权、参数、限流以及 `ve`/`tosutil`/Python SDK 调用链路的快速检查放在 `references/openapi-quick-check.md`，具体产品域手册放在 `references/domain-guides/`。
先把 `SKILL_ROOT` 解析为包含本 `SKILL.md` 的绝对目录。所有脚本和 reference 都从
`${SKILL_ROOT}` 解析，不依赖仓库布局或当前工作目录。
## 开始前
1. 先读取 `references/getting-started.md`，确认本地工具、环境变量、场景依赖和领域路由。
2. 如用户允许执行本地体检，运行通用检查：
```bash
bash "${SKILL_ROOT}/scripts/common_check.sh"
```
3. 优先用 `ve sts GetCallerIdentity` 验证当前身份链路，只报告是否可用和必要的身份摘要，不输出 SecretKey、SessionToken、完整 AccessKeyId、完整手机号、账单明细或对象内容。
4. 不要运行 `ve configure`、登录/SSO 初始化、安装依赖、写入配置文件或修改云资源，除非用户明确要求并确认影响。
5. 若不确定归属，按 `references/getting-started.md` 中的“场景路由”定位领域；遇到 OpenAPI 报错、签名/鉴权失败、参数校验、限流、服务端错误，或由 `ve`/`tosutil`/Python SDK 暴露出的 OpenAPI 调用失败，先读 `references/openapi-quick-check.md` 收敛 RequestId、Action、Region、错误码和最小复现上下文。
6. 根据下方路由打开对应 `references/domain-guides/<domain>/README.md`，再按领域手册的“先读这些”读取 `query-cli-catalog.md`、章节 README、`api-coverage-matrix.md` 和脚本 README。
## 场景路由
…Read the whole file at its exact version.
How to install
mdr add volcengine/volcengine-agent-toolkit/volcengine-troubleshooting@sha256:9979fb04d221ddc3The line at the top of this page pins the label git:20261019.8a5d3dc, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.
[](https://markdownregistry.com/a/art_zjms7u4j6f3nntbt)
0 badge image fetches in 30 days. What the badge shows.
Versions
The registry has recorded 4 versions of this file, between Aug 10, 2026 and Oct 19, 2026, about one every 23 days.
| version | committed | commit | size | audit | |
|---|---|---|---|---|---|
| git:20261019.8a5d3dc latest | 2026-10-19 | 8a5d3dc | 6,549 B | A | view · diff |
| git:20260914.d09da5d | 2026-09-14 | d09da5d | 6,535 B | A | view · diff |
| git:20260914.8f86bdd | 2026-09-14 | 8f86bdd | 6,551 B | A | view · diff |
| git:20260810.b6aad39 | 2026-08-10 | b6aad39 | 5,052 B | A | view |
Audit of the latest version
- pass: Frontmatter block present
- pass: Frontmatter declares a name
- pass: Frontmatter declares a description
- pass: Size between 200 bytes and 200 KB (6549 bytes)
- pass: No zero-width or bidi control characters
- pass: No instruction hidden inside an HTML comment
- pass: No link to an exfiltration or paste host
- pass: No credential-shaped string
- pass: No instruction to send local credentials anywhere
- pass: No text hidden with inline styles
- pass: No prompt-injection phrasing
- pass: No curl or wget piped into a shell
- pass: No recursive delete of root, home or parent
- pass: No instruction to read or print local credentials
- pass: No base64 blob over 200 characters
- pass: No link to a raw IP address
- pass: No script tag
Source
volcengine/volcengine-agent-toolkit · 26 stars · license MIT · pushed 2026-11-06 · branch main
API
GET https://markdownregistry.com/api/v1/artifacts/art_zjms7u4j6f3nntbt GET https://markdownregistry.com/api/v1/resolve?ref=volcengine/volcengine-agent-toolkit/volcengine-troubleshooting GET https://markdownregistry.com/api/v1/blob/9979fb04d221ddc3f7bdc9584774505b9142e1e2b5bb4ee339ee286118dcb24b
Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.
Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.