Agent skill

Word Document Generator

by huiliyi37 in huiliyi37/Tianshu-harness

Generates and reads Word (.docx) documents such as reports, contracts and bids from heading, paragraph, table, code and list blocks, with a centered title.

Apache-2.0Auto-check passedDocuments & Office

SKILL.md written in Chinese; this summary is our English description.

Install Word Document Generator

skills CLI
$ npx skills add huiliyi37/Tianshu-harness --skill office-docx -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install huiliyi37/Tianshu-harness office-docx --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/huiliyi37/Tianshu-harness.git skills-src && mkdir -p .claude/skills && cp -r skills-src/plugins/office-docx/skills .claude/skills/office-docx && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
office-docx
GitHub stars
1.1k
Token cost
~252 tokens
SKILL.md length
75 words
Files
1
Skills in repo
7
Repo updated
First seen
Licence
Apache-2.0

At a glance

Generates and reads Word (.docx) documents such as reports, contracts and bids from heading, paragraph, table, code and list blocks, with a centered title.

  • Works in 4 steps: 结构先行:长文档先把章节(heading)结构列给用户确认,再一次生成 → 表格化数据:能用 table 呈现的数据不写成段落 → 生成后自查:用 docx_read… → …
  • Producing a report, contract or bid as an editable Word file
  • SKILL.md covers 何时使用, 内容块速查 and 生成纪律
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

The skill writes native .docx files for deliverables that need to stay editable, such as reports, contracts, proposals and bids, and reads the text of existing .docx files into context with docx_read. Content is described as blocks: headings at three levels, paragraphs, tables with headers and rows, monospaced code blocks and bullet lists, plus an optional document title shown centered in large bold type.

The generation rules ask the agent to confirm the section structure of a long document with you before generating it in one pass, to present tabular data as tables, and to read the output back with docx_read to check that nothing is missing and no placeholder text is left. The skill notes that Markdown is lighter when Word is not needed and that PDF is the better choice for formal read-only delivery, so Word is used when you ask for an editable document.

When your agent uses it

  • Producing a report, contract or bid as an editable Word file
  • Reading the text of an existing .docx into the conversation
  • Checking a generated document for completeness by reading it back

Example prompts

  • “Write the project proposal as a Word document with a centered title and a budget table.”
  • “Read the text of tender.docx so we can summarize the requirements.”
  • “Draft the service contract as a .docx and show me the section outline first.”

Requirements

  • The office-docx plugin of the Tianshu harness

Workflow steps

4 steps, taken from the first numbered list in SKILL.md.

  1. 结构先行:长文档先把章节(heading)结构列给用户确认,再一次生成
  2. 表格化数据:能用 table 呈现的数据不写成段落
  3. 生成后自查:用 docx_read 读回产出,确认内容完整、无占位符残留(lorem / xxxx / TODO)
  4. 编辑需求优先:用户说"要能改的文档"用 docx;只说"给我一份报告"默认 PDF

What it can do on your machine

Read from SKILL.md and the folder at commit 29bf77c. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Word Document Generator loads about 252 tokens when it runs. Until then it costs about 26 tokens; SKILL.md has 75 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~26
When it runs · the whole SKILL.md, loaded when a task matches
~252

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from huiliyi37/Tianshu-harness at commit 29bf77c, republished under its Apache-2.0 licence (© huiliyi37). 75 words, ~252 tokens.

Download SKILL.mdSave it as .claude/skills/office-docx/SKILL.md (or your agent's skills folder).
name
office-docx
description
生成与读取 Word 文档(.docx)——报告、合同、交付文档、投标书;原生 docx 渲染,支持 heading/paragraph/table/code/list 内容块与居中标题
triggers
word, docx, 文档, 报告, 合同, 标书, 交付, word 文档, Word, .docx

Office DOCX(Word 文档生成与读取)

参考 anthropics/skills(Apache 2.0)提炼,适配天枢 office-docx 插件(与 dsh-office 0.1.5 同步)。

何时使用

  • 需要交付 Word 格式文档:报告、合同、方案书、标书
  • 用户明确要求 .docx / Word 导出(可继续编辑的文档——Word 适合需要后续人工编辑的场景,纯交付阅读用 PDF 更稳)
  • 只需快速读内容时用 docx_read 抽取现有 .docx 文本进上下文

不需要时别用——Markdown 更轻;正式排版交付优先 PDF(天枢 office-pdf)。

内容块速查

块字段说明
heading / h1text一级标题
h2 / h3text二/三级子标题
paragraphtext正文段落
tableheaders, rows全宽表格(首行为表头)
codetextCourier 等宽代码块
listitems圆点列表

其他参数:title(文档标题,居中加粗大字)。

生成纪律

  1. 结构先行:长文档先把章节(heading)结构列给用户确认,再一次生成
  2. 表格化数据:能用 table 呈现的数据不写成段落
  3. 生成后自查:用 docx_read 读回产出,确认内容完整、无占位符残留(lorem / xxxx / TODO)
  4. 编辑需求优先:用户说"要能改的文档"用 docx;只说"给我一份报告"默认 PDF

© huiliyi37, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in plugins/office-docx/skills of huiliyi37/Tianshu-harness.

Open the folder on GitHubat commit 29bf77c

Compare with similar skills

Word Document Generator next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Word Document Generator compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Word Document Generator this skillhuiliyi37/Tianshu-harness1.1k—~252Automated safety check: PassApache-2.0
Word Document Reader and WriterHKUDS/DeepTutor41k—~2.5kAutomated safety check: PassApache-2.0
BiSheng DOCX Builderdataelement/bisheng12k—~2.7kAutomated safety check: PassApache-2.0
Word Document Builderspinabot/brigade11k—~2.1kAutomated safety check: PassMIT
Markdown to Word Convertercat-xierluo/SuitAgent205—~559Automated safety check: PassMIT
Industry Bid Document WriterGet00/BiaoShu-SKILL173—~4.6kAutomated safety check: PassApache-2.0

Similar skills

  • Reads, creates and edits Word .docx files with python-docx, and drops to raw OOXML for tracked changes, comments and byte-exact edits.

    41k GitHub stars~2.5k tokensUpdated 3 days ago
    Documents & OfficeAuto-check passed
  • BiSheng DOCX Builder

    dataelement/bisheng

    Builds or edits Word .docx documents inside BiSheng's code executor with python-docx, handling Chinese fonts, tables of contents, page numbers and official-document layout.

    12k GitHub stars~2.7k tokensUpdated yesterday
    Documents & OfficeAuto-check passed
  • Word Document Builder

    spinabot/brigade

    Creates and edits Word documents along four paths of rising capability, from a quick tool to the docx library, an OOXML round-trip and pandoc, then verifies the file.

    11k GitHub stars~2.1k tokensUpdated yesterday
    Documents & OfficeAuto-check passed
  • Markdown to Word Converter

    cat-xierluo/SuitAgent

    Converts Markdown files into Word documents formatted to Chinese typesetting conventions, with presets for academic, legal, report and book layouts.

    205 GitHub stars~559 tokensUpdated 1 mo ago
    Documents & OfficeAuto-check passed
  • Industry Bid Document Writer

    Get00/BiaoShu-SKILL

    Converts a tender document into Markdown, extracts scoring criteria and requirements, then drafts an industry-formatted technical bid as a Word file.

    173 GitHub stars~4.6k tokensUpdated 17 days ago
    Documents & OfficeAuto-check passed
  • Compiles notes, outlines, PDFs or BIRD and iMandalArt content into an eight-page mini book, with upright page PDFs, a reading PDF, an editable DOCX and an A4 landscape print sheet.

    259 GitHub stars~4.4k tokensUpdated 2 mo ago
    Documents & OfficeAuto-check passed

More from huiliyi37/Tianshu-harness

  • Agent Harness Testing Methodology

    huiliyi37/Tianshu-harness

    Guides an agent through probing an unfamiliar project's test setup, then choosing a red-light-first testing strategy matched to the task type.

    1.1k GitHub stars~1k tokensUpdated today
    Auto-check: notes
  • Visual Acceptance Review

    huiliyi37/Tianshu-harness

    Chinese-language final-check method for UI visual changes before delivery, using multi-theme screenshot matrices, pixel-level evidence and a CSS cascade checklist.

    1.1k GitHub stars~601 tokensUpdated today
    Auto-check passed
  • Frontend Prototype Workflow

    huiliyi37/Tianshu-harness

    Asks one clarifying question at a time, then builds two or three single-file HTML prototypes checked across phone, tablet, and desktop widths.

    1.1k GitHub stars~415 tokensUpdated today
    Auto-check passed
  • Office Excel

    huiliyi37/Tianshu-harness

    Excel 电子表格读写与编辑最佳实践 — 用 xlsxread/xlsxwrite/xlsxedit 处理 .xlsx 时遵守的公式、数字格式与可维护性纪律

    1.1k GitHub stars~340 tokensUpdated today
    Auto-check passed
  • Office PDF Generator and Reader

    huiliyi37/Tianshu-harness

    Generates formal PDFs from structured content blocks with automatic CJK font handling and page numbers, and reads text back out of existing PDFs.

    1.1k GitHub stars~334 tokensUpdated today
    Auto-check passed
  • Office PPT Design Rules

    huiliyi37/Tianshu-harness

    Sets design rules for building PowerPoint decks with the pptx_create and pptx_read tools: a dominant color, varied layouts, readable type and a read-back check.

    1.1k GitHub stars~401 tokensUpdated today
    Auto-check passed

Works with

Questions about Word Document Generator

What does Word Document Generator do?

Generates and reads Word (.docx) documents such as reports, contracts and bids from heading, paragraph, table, code and list blocks, with a centered title. docx files into context with docx_read. Content is described as blocks: headings at three levels, paragraphs, tables with headers and rows, monospaced code blocks and bullet lists, plus an optional document title shown centered in large bold type.

When should I use Word Document Generator?

Word Document Generator fits situations like: producing a report, contract or bid as an editable Word file; reading the text of an existing .docx into the conversation; checking a generated document for completeness by reading it back.

How do I install Word Document Generator in Claude Code?

Run `npx skills add huiliyi37/Tianshu-harness --skill office-docx -a claude-code`. Or copy the skill folder (plugins/office-docx/skills in huiliyi37/Tianshu-harness) into .claude/skills/office-docx in your project. Claude Code loads it when a task matches its description.

How do I install Word Document Generator in Codex?

Run `npx skills add huiliyi37/Tianshu-harness --skill office-docx -a codex`. Or copy the skill folder (plugins/office-docx/skills in huiliyi37/Tianshu-harness) into .agents/skills/office-docx in your project. Codex loads it when a task matches its description.

Can I use Word Document Generator in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add huiliyi37/Tianshu-harness --skill office-docx -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/office-docx, .gemini/skills/office-docx, .github/skills/office-docx and .opencode/skills/office-docx in your project.

What does Word Document Generator need to run?

SKILL.md names no scripts, command-line tools or credentials: Word Document Generator is instructions for the agent only. Our summary lists: The office-docx plugin of the Tianshu harness.

Does Word Document Generator access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Word Document Generator safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Word Document Generator use?

Word Document Generator is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Word Document Generator use?

About 252 tokens (SKILL.md is roughly 1k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Word Document Generator?

Skills that share tags, products or a category with Word Document Generator: Word Document Reader and Writer (HKUDS/DeepTutor, 41k stars), BiSheng DOCX Builder (dataelement/bisheng, 12k stars), Word Document Builder (spinabot/brigade, 11k stars) and Markdown to Word Converter (cat-xierluo/SuitAgent, 205 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Word Document Generator?

huiliyi37 (a GitHub user) maintains it in huiliyi37/Tianshu-harness, which has 1,091 GitHub stars. The repository holds 7 skills in this directory. The repository was last updated on October 11, 2026.

Source: huiliyi37/Tianshu-harness on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.