tencent-docs — скилл для Claude Code: что делает и как установить
Скилл открывает агенту доступ к вашему аккаунту Tencent Docs через открытый API: создавать файлы, читать содержимое, искать по диску и разбирать папки.
Apache-2.0 157 установок ★ 17 обновлён 2026-10-25
npx skills add AceDataCloud/Skills --skill tencent-docs -a claude-codeЧто делает 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-code2Вручную: положить файлы
~/.claude/skills/tencent-docs/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/tencent-docs/
1Через Skills CLI (Vercel)
npx skills add AceDataCloud/Skills --skill tencent-docs -a codex2Вручную: положить файлы
.agents/skills/tencent-docs/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add AceDataCloud/Skills --skill tencent-docs -a cursor2Вручную: положить файлы
.cursor/skills/tencent-docs/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install AceDataCloud/Skills skills/tencent-docs2Вручную: положить файлы
.github/skills/tencent-docs/SKILL.md1Через Skills CLI (Vercel)
npx skills add AceDataCloud/Skills --skill tencent-docs -a gemini-cli2Командой платформы
gemini skills install https://github.com/AceDataCloud/Skills --path skills/tencent-docsВручную: положить файлы
.devin/skills/tencent-docs/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add AceDataCloud/Skills --skill tencent-docs -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в 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