Skip to main content
skill CX Codex

tencent-docs — Claude Code skill: what it does, how to install

Lets the agent work inside your own Tencent Docs account through the Open API: create files, read documents and sheets, search the drive.

Apache-2.0 157 installs ★ 17 updated 2026-10-25

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add AceDataCloud/Skills --skill tencent-docs -a claude-code
Open on GitHub

What tencent-docs does

Under the hood it calls the Tencent Docs Open API with curl and jq; Bash is the one tool it may use. From chat you get a new doc, sheet, slide deck, smart table, form, mind map or flowchart. The skill also reads an online document's text, pulls a cell range such as A1:D10, searches the drive by keyword and lists a folder.

Each request carries three headers: Access-Token, Client-Id and Open-Id. The values arrive from TENCENTDOCS_ACCESS_TOKEN, TENCENTDOCS_CLIENT_ID and TENCENTDOCS_OPEN_ID, which the tencentdocs connector fills in. Responses look like {"ret": 0, "msg": "Succeed", "data": {…}}; read ret first, because a non-zero value puts the reason in msg.

Some calls depend on the account. 400007 means the capability needs a Tencent Docs VIP plan. 400008 says the generation quota is gone. A 400006 is an expired token: reconnect the tencentdocs connector instead of retrying the call. Rename, move and delete wait for an explicit yes from you, with the file title and link shown first.

What it helps with

  • spin up a sheet or slide deck from the chat window
  • pull the text of an online document for editing
  • read a cell range out of a spreadsheet
  • search the drive by keyword instead of clicking through folders
  • rename or delete a file after an explicit confirmation

Example prompts for the agent

  • Create a new Tencent Docs document with the meeting agenda and send me the link
  • Find the quarterly budget file in Tencent Docs and show the first rows
  • Read the document in my Tencent Docs space and summarise the conclusions

How to install tencent-docs

1Skills CLI (Vercel)

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

2Manually: put the files in place

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

Copy the whole skill folder; for one project use .claude/skills/tencent-docs/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about tencent-docs

How do I install tencent-docs in Claude Code?

Run npx skills add AceDataCloud/Skills --skill tencent-docs -a claude-code. The skill lands in ~/.claude/skills/tencent-docs/SKILL.md.

What does tencent-docs do?

It gives the agent access to your Tencent Docs account: creating files, reading documents and sheets, searching the drive, renaming and moving. Anything that changes data waits for your confirmation.

What has to be set up before it works?

The tencentdocs connector plus three environment variables holding the token, Client ID and Open ID. An expired token comes back as 400006.

Source text

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

Similar skills

All skills for Office documents →

From the same set67

The whole set →

Project sponsors

Companies that keep this analytics open