К основному содержанию
скилл CX Codex

tencent-docs — скилл для Claude Code: что делает и как установить

Скилл открывает агенту доступ к вашему аккаунту Tencent Docs через открытый API: создавать файлы, читать содержимое, искать по диску и разбирать папки.

Apache-2.0 157 установок ★ 17 обновлён 2026-10-25

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add AceDataCloud/Skills --skill tencent-docs -a claude-code
Открыть на GitHub

Что делает tencent-docs

Скилл ходит в открытый API Tencent Docs через curl и jq, из инструментов ему разрешён только Bash. Агент создаёт документ, таблицу, презентацию, интеллектуальную таблицу, форму, схему или карту мыслей. Умеет прочитать текст онлайн-документа, вытащить диапазон ячеек вроде A1:D10, найти файл по ключевому слову и показать листинг папки.

Запросы подписываются тремя заголовками: Access-Token, Client-Id и Open-Id. Значения приходят из переменных окружения TENCENTDOCS_ACCESS_TOKEN, TENCENTDOCS_CLIENT_ID и TENCENTDOCS_OPEN_ID, их выставляет коннектор tencentdocs. Ответ всегда в форме {"ret": 0, "msg": "Succeed", "data": {…}}, и смотреть надо на ret: при ненулевом значении причина лежит в msg.

Часть операций упирается в аккаунт. Код 400007 означает, что для запрошенной возможности нужен VIP-статус Tencent Docs. 400008 говорит о том, что квота на генерацию кончилась. При 400006 токен просрочен: коннектор tencentdocs придётся переподключить, повторять вызов бессмысленно. Переименование, перенос и удаление скилл выполняет только после явного «да» от пользователя.

Какие задачи решает

  • создать таблицу или презентацию в Tencent Docs прямо из чата
  • вытащить текст онлайн-документа, чтобы его отредактировать
  • прочитать диапазон ячеек A1:D10 из листа
  • найти файл по ключевому слову в своём диске
  • переименовать или удалить файл, подтвердив операцию

Примеры запросов агенту

  • Создай в Tencent Docs новый документ с повесткой встречи и пришли ссылку
  • Найди в Tencent Docs файл с бюджетом на квартал и покажи первые строки таблицы
  • Прочитай мой документ в Tencent Docs и перескажи раздел с выводами

Как установить tencent-docs

1Через Skills CLI (Vercel)

npx skills add AceDataCloud/Skills --skill tencent-docs -a claude-code

2Вручную: положить файлы

~/.claude/skills/tencent-docs/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/tencent-docs/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о tencent-docs

Как установить tencent-docs в Claude Code?

Выполните npx skills add AceDataCloud/Skills --skill tencent-docs -a claude-code. Скилл появится в ~/.claude/skills/tencent-docs/SKILL.md.

Что делает tencent-docs?

Даёт агенту доступ к вашему аккаунту Tencent Docs: создание файлов, чтение документов и таблиц, поиск по диску, переименование и перенос. Операции, которые что-то меняют, выполняются после подтверждения.

Что нужно, чтобы скилл заработал?

Подключённый коннектор tencentdocs и три переменные окружения с токеном, Client ID и Open ID. Если токен истёк, запросы вернут 400006.

Исходный текст

SKILL.md · Apache-2.0
---
name: tencent-docs
description: Create, read, list, search, and manage Tencent Docs (腾讯文档) — online documents, sheets, slides, mind maps, flowcharts, smart tables, and forms — via the Tencent Docs Open API. Use when the user mentions 腾讯文档 / Tencent Docs / docs.qq.com, a docs.qq.com link, or wants to create / read / organize a doc, sheet, slide, mind map, or flowchart in their Tencent Docs space.
when_to_use: |
  Trigger when the user wants to work with their Tencent Docs (腾讯文档) space —
  create a new document / sheet / slide / mind map / flowchart / smart table /
  form, read a doc or sheet's content, list a folder, search files by keyword,
  or rename / move / copy / delete a file. Acts in the user's own Tencent Docs
  account, so destructive or outward-facing writes are gated behind confirmation.
connections: [tencentdocs]
allowed_tools: [Bash]
license: Apache-2.0
metadata:
  author: acedatacloud
  version: "1.0"
---

# Tencent Docs (腾讯文档)

Drive the [Tencent Docs Open API](https://docs.qq.com/open/document/app/) with
`curl + jq`. Everything runs **in the user's own Tencent Docs account** — only
files they can access, only the scopes they granted at connect time.

## Auth — three headers (NOT a single Bearer)

The `tencentdocs` BYOC connector injects three env vars; every call sends **all
three** headers:

- `TENCENTDOCS_ACCESS_TOKEN` → `Access-Token` header (OAuth2 access token). **Secret.**
- `TENCENTDOCS_CLIENT_ID` → `Client-Id` header (the developer app's Client ID).
- `TENCENTDOCS_OPEN_ID` → `Open-Id` header (the user id returned with the token).

All endpoints live under `https://docs.qq.com/openapi`. Define a reusable header
set once per session:

```sh
AUTH=(-H "Access-Token: $TENCENTDOCS_ACCESS_TOKEN" \
      -H "Client-Id: $TENCENTDOCS_CLIENT_ID" \
      -H "Open-Id: $TENCENTDOCS_OPEN_ID")
```

Never echo, print, or log `TENCENTDOCS_ACCESS_TOKEN` — it is full account access.

## Response shape & error handling

Every response is `{"ret": 0, "msg": "Succeed", "data": {…}}`. **`ret == 0`
means success**; any non-zero `ret` is an error — surface `msg` to the user.
Always check it:

```sh
resp=$(curl -sS "${AUTH[@]}" … )
echo "$resp" | jq 'if .ret == 0 then .data else error("Tencent Docs \(.ret): \(.msg)") end'
```

Common error codes:

| code | meaning | what to do |
|---|---|---|
| `400006` | access token invalid / expired | tell the user to reconnect 腾讯文档 at <https://studio.acedata.cloud/console/connectors> — do **not** loop-retry |
| `400007` | VIP (超级会员) privilege required | the requested capability needs a Tencent Docs 超级会员; tell the user, link <https://docs.qq.com/vip> |
| `400008` | 积分 (credits) insufficient | AI-generation quota is exhausted; tell the user to top up |
| `11607` / `-32603` | bad request params | recheck `fileID` / `type` / body fields against the recipe below |

## Doc types (`type` when creating)

| type | Product | Notes |
|---|---|---|
| `doc` | 在线文档 (Word-style) | classic rich-text document |
| `sheet` | 在线表格 (Excel) | data tables |
| `slide` | 幻灯片 (PPT) | presentations |
| `mind` | 思维导图 | mind map |
| `flowchart` | 流程图 | flowchart |
| `smartsheet` | 智能表格 | structured multi-view table |
| `form` | 收集表 | form / survey |

## Recipes

### Verify auth (always run first)

Cheap sanity check — read the app's OpenAPI usage counter:

```sh
curl -sS "${AUTH[@]}" "https://docs.qq.com/openapi/drive/v2/util/resource-use" \
  | jq 'if .ret == 0 then .data else "ERR \(.ret): \(.msg)" end'
```

If this returns `400006`, the connection is expired — have the user reconnect.

### List a folder (root = `/`)

```sh
curl -sS "${AUTH[@]}" \
  "https://docs.qq.com/openapi/drive/v2/folders/%2F?listType=folder&sortType=browse&asc=0" \
  | jq 'if .ret == 0 then [.data.list[]? | {ID, title, type, url}] else . end'
```

`%2F` is the URL-encoded root folder id. For a sub-folder use its folder id in
the path.

### Search files by keyword

```sh
curl -sS -G "${AUTH[@]}" \
  "https://docs.qq.com/openapi/drive/v2/search" \
  --data-urlencode "searchName=Q1 预算" \
  | jq 'if .ret == 0 then [.data.list[]? | {ID, title, type, url}] else . end'
```

### Read a file's metadata

The `fileID` is the last path segment of a `https://docs.qq.com/doc/<id>` (or
`/sheet/`, `/slide/`, …) URL.

```sh
curl -sS "${AUTH[@]}" \
  "https://docs.qq.com/openapi/drive/v2/files/FILE_ID/metadata" \
  | jq 'if .ret == 0 then .data else . end'
```

### Read an online document's content

```sh
curl -sS "${AUTH[@]}" \
  "https://docs.qq.com/openapi/document/v3/files/FILE_ID/export?exportType=text" \
  | jq 'if .ret == 0 then .data else . end'
```

### Read a sheet's cell range

Get the sheet's `sheetId` list from the metadata first, then read a range
(`A1:D10`):

```sh
curl -sS "${AUTH[@]}" \
  "https://docs.qq.com/openapi/spreadsheet/v2/files/FILE_ID/sheets/SHEET_ID/values?range=A1:D10" \
  | jq 'if .ret == 0 then .data.values else . end'
```

### Create a file

`POST /openapi/drive/v2/files` with form-urlencoded `title` + `type`. Returns the
new file's `ID` and `url`.

```sh
curl -sS -X POST "${AUTH[@]}" \
  "https://docs.qq.com/openapi/drive/v2/files" \
  --data-urlencode "title=会议纪要 2026-07-03" \
  --data-urlencode "type=doc" \
  | jq 'if .ret == 0 then {ID: .data.ID, url: .data.url} else . end'
```

Swap `type=sheet` / `slide` / `mind` / `flowchart` / `smartsheet` / `form` for
other doc types. Pass `--data-urlencode "folderID=<id>"` to create inside a
folder instead of the root.

### Upload an image (for embedding in docs)

```sh
curl -sS -X POST "${AUTH[@]}" \
  "https://docs.qq.com/openapi/resources/v2/images" \
  -F "file=@./cover.png" \
  | jq 'if .ret == 0 then .data else . end'
```

### Rename a file — GATED, confirm first

Show the user the current `title` + `url` and the new title, get an explicit
"yes", then run:

```sh
curl -sS -X PATCH "${AUTH[@]}" \
  "https://docs.qq.com/openapi/drive/v2/files/FILE_ID" \
  --data-urlencode "title=新的标题" \
  | jq 'if .ret == 0 then "renamed" else . end'
```

### Move a file — GATED, confirm first

Show the user the file's current `title` + location and the destination folder,
get an explicit "yes", then run. `folderID=/` moves it back to the root.

```sh
curl -sS -X PATCH "${AUTH[@]}" \
  "https://docs.qq.com/openapi/drive/v2/files/FILE_ID/move" \
  --data-urlencode "folderID=DEST_FOLDER_ID" \
  | jq 'if .ret == 0 then "moved" else . end'
```

### Copy a file

```sh
curl -sS -X POST "${AUTH[@]}" \
  "https://docs.qq.com/openapi/drive/v2/files/FILE_ID/copy" \
  --data-urlencode "title=副本 - 项目计划" \
  | jq 'if .ret == 0 then {ID: .data.ID, url: .data.url} else . end'
```

### Delete a file — GATED, confirm first

Deletion moves the file to the recycle bin but is still destructive. **Show the
user the exact `title` + `url`, get an explicit "yes", then run:**

```sh
curl -sS -X DELETE "${AUTH[@]}" \
  "https://docs.qq.com/openapi/drive/v2/files/FILE_ID" \
  | jq 'if .ret == 0 then "deleted" else . end'
```

## Notes

- **Gate writes.** Rename / move / delete / copy and any share-permission change
  act on the user's real files — confirm the exact target before running.
- **Extract ids from links.** When the user pastes a `docs.qq.com/doc/<id>` (or
  `/sheet/`, `/slide/`, `/mind/`, `/flowchart/`, `/form/`, `/smartsheet/`) URL,
  take the id from the path rather than asking for it.
- **Pagination.** List / search endpoints return a cursor / `next` marker in
  `data`; pass it back to fetch the next page. Stop when the marker is empty.
- **Rate / quota.** Free apps get 20,000 API calls/month (超级会员 20,000/day,
  Plus 40,000/day). AI-generation features additionally consume 积分 and may
  require 超级会员 — a `400007` / `400008` means the account tier / credits, not a
  bug in the request.
- **Full API index.** Beyond the recipes above, the Open API also covers
  smart-table records, form collection, folder CRUD, permissions, and
  import/export — see the [接口索引](https://docs.qq.com/open/document/app/openapi/v2/file/).

© acedatacloud · Apache-2.0 · AceDataCloud/Skills

Похожие скиллы

Все скиллы по теме «Документы и офис» →
mila fbalzan20-5mxo MCP-сервер mila даёт агенту инструменты для работы с документами, таблицами и презентациями. С его помощью можно создавать файлы и менять уже существующие. CX Codex +1 187установок google-docs sanjay3290 Скилл google-docs создаёт документы, ищет их по названию, читает текст и правит содержимое прямо из чата с агентом. Нужен аккаунт Google Workspace. CX Codex +1 564установок docs-router daymade Скилл docs-router для Claude Code маршрутизирует задачи по работе с файлами между инструментами пакета Daymade. Определяет нужный обработчик по форматам исходника и результата. CX Codex +1 138установок sumsub-api-generic sumsub Скилл sumsub-api-generic для Claude Code находит и безопасно вызывает методы Sumsub API по официальной схеме OpenAPI. Обрабатывает запросы, не охваченные узкими скиллами интегратора. CX Codex +1 1 400установок inngest-api inngest Скилл inngest-api инструктирует агента по работе с REST API v2 Inngest через прямые HTTP-запросы, спецификацию OpenAPI и документацию, когда возможностей CLI или MCP недостаточно. CX Codex +1 870установок gws-sheets официальный googleworkspace Скилл gws-sheets для Claude Code читает и изменяет таблицы Google Sheets через CLI. Автоматизирует операции с таблицами и работу с данными проекта. CX Codex +1 61 900установок

Из того же набора67

Весь набор →
vercel Скилл проверяет сборки, читает логи ошибок и управляет доменами на Vercel через REST API прямо из чата с агентом. CX Codex +1 176установок bilibili Скилл читает статистику статей в Bilibili и помогает публиковать новые через ваш аккаунт. Для работы нужны cookies входа. CX Codex +1 175установок figma Читает файлы Figma через REST API: дерево документа, отдельные ноды, рендер в PNG и комментарии. Запускается при переводе макета в код. CX Codex +1 175установок google-docs Позволяет читать, создавать и редактировать документы Google Docs через официальный REST API с помощью curl и jq. CX Codex +1 175установок personal-wechat Скилл personal-wechat подключает Claude Code к личному WeChat через собственный сервер Wisdom: агент читает чаты и контакты, а перед отправкой сообщений запрашивает подтверждение. CX Codex +1 162установок acedatacloud Управляет аккаунтом AceDataCloud через management API: балансом, API-ключами, заказами и каталогом сервисов. Подключается к задачам через Claude Code и другие IDE. CX Codex +1 127установок webextrator Скилл webextrator для Claude Code извлекает содержимое веб-страниц через API AceDataCloud. Запускается для получения HTML после рендеринга или структурированных данных по URL. CX Codex +1 107установок feishu Читает и меняет документы Feishu через REST API. Запускается по запросам о документах, таблицах, календаре или сообщениях Feishu. CX Codex +1 104установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой