Agent skill

Chinese Official Document QA

by zhaohui-yang in zhaohui-yang/official-document-drafting

Checks the structure and quality of a finished Chinese official document with a section-checking script and a manual checklist, without rewriting it.

Custom licenceAuto-check passedDocuments & Office

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

Install Chinese Official Document QA

skills CLI
$ npx skills add zhaohui-yang/official-document-drafting --skill document-qa -a claude-code

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

GitHub CLI
$ gh skill install zhaohui-yang/official-document-drafting document-qa --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/zhaohui-yang/official-document-drafting.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/document-qa .claude/skills/document-qa && 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
document-qa
GitHub stars
140
Token cost
~466 tokens
SKILL.md length
68 words
Files
1
Skills in repo
8
Repo updated
First seen
Licence
Custom licence

At a glance

Checks the structure and quality of a finished Chinese official document with a section-checking script and a manual checklist, without rewriting it.

  • Works in 5 steps: 判断稿子文种 → 先跑 check_sections.py <文种> 成稿.md… → 再加 --strict-facts 跑一遍 0… → 再按「质量检查清单」做语义核对。 → …
  • Reviewing a drafted official notice or report for missing sections
  • SKILL.md covers 文件索引, 自动校验(脚本), 人工核对(清单) and 默认流程, plus 1 more section
  • Calls python3

What it does

This skill inspects a completed draft and does the opposite of drafting. A Python script, `src/scripts/check_sections.py`, covers all 22 document types and flags missing required sections, skipped heading levels, 一是 or 二是 items used as formal headings, third-level headings in documents under 10 pages, leftover placeholders and closing phrases that do not match the type. It also checks the GB/T 9704 formatting points: bracket style in document numbers, zero-padded dates, a stray period in titles and a leftover subject-words line.

The `--strict-facts` option lists every concrete, non-placeholder value such as numbers, dates, percentages and amounts so each can be traced to a source, and `--strict-structure` turns structure warnings into errors. Semantic points the script cannot judge are checked by hand against a quality checklist, including document type, title focus, sign-off and invented facts. The report states what is missing, what is irregular and which values look unsupported, and revisions go back to the drafting skill. The text is in Chinese.

When your agent uses it

  • Reviewing a drafted official notice or report for missing sections
  • Checking heading levels and closing phrases against the document type
  • Listing every concrete figure and date in a draft so sources can be verified

Example prompts

  • “检查这份通知的结构是否齐全,标题层级有没有跳级。”
  • “Run the strict facts audit on report draft 成稿.md and list the values that need a source.”
  • “Check this draft against the GB/T 9704 format red lines and report problems without rewriting.”

Requirements

  • Python 3 to run the section-checking script
  • The finished draft as a Markdown file

Workflow steps

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

  1. 判断稿子文种 → 先跑 check_sections.py <文种> 成稿.md 拿结构结论(22 个文种均覆盖)。
  2. 再加 --strict-facts 跑一遍 0 幻觉审计,拿到「非占位具体值」清单,逐项核对是否有可核实来源(无来源的应改占位或标「待核实」)。
  3. 再按「质量检查清单」做语义核对。
  4. 输出「缺什么板块 / 哪里结构不规范 / 哪些具体值疑似无依据」,并指明对应主源规则。
  5. 只报问题与依据,不擅自改写;需要修订时交回「公文写作」skill。

What it can do on your machine

Read from SKILL.md and the folder at commit 6b4166a. 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

    Shell commands in SKILL.md call:

    • python3

    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

Chinese Official Document QA loads about 466 tokens when it runs. Until then it costs about 44 tokens; SKILL.md has 68 words of instructions outside code blocks.

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

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

Its licence (Custom licence) doesn't allow us to republish the file, so here is its outline and opening line. It has 68 words (~466 tokens).

name
document-qa

Read the full SKILL.md on GitHub

Files

Just SKILL.md in skills/document-qa of zhaohui-yang/official-document-drafting.

Open the folder on GitHubat commit 6b4166a

Compare with similar skills

Chinese Official Document QA 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.

Chinese Official Document QA compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Chinese Official Document QA this skillzhaohui-yang/official-document-drafting140—~466Automated safety check: PassCustom licence
Visual Auditpedrohcgs/claude-code-my-workflow1.6k—~651Automated safety check: NotesMIT
WeChat Article Compliance Revieweraiworkskills/wechat-article-skills667—~1.5kAutomated safety check: PassApache-2.0
Iflytek Text Proofreadiflytek/iFly-Skills209—~1.4kAutomated safety check: PassApache-2.0
Markdown Article FormatterJimLiu/baoyu-skills26k7 repos~3.5kAutomated safety check: PassMIT
Summarise Ecosystem Resultsastral-sh/ruff50k1 repos~2.2kAutomated safety check: PassMIT

Similar skills

  • Visual Audit

    pedrohcgs/claude-code-my-workflow

    Adversarial visual-layout audit of a Quarto .qmd or Beamer .tex deck.

    1.6k GitHub stars~651 tokensUpdated 11 days ago
    Documents & OfficeAuto-check: notes
  • WeChat Article Compliance Reviewer

    aiworkskills/wechat-article-skills

    Local, offline pre-publish review for a WeChat official account article: sensitive words, typos and platform compliance, producing an actionable fix list.

    667 GitHub stars~1.5k tokensUpdated 15 days ago
    Productivity & AutomationAuto-check passed
  • Iflytek Text Proofread

    iflytek/iFly-Skills

    iFlytek Official Document Proofreading (公文校对) — detect and correct errors in Chinese text including typos, punctuation, word order, factual mistakes, sensitive content, and more (27 error types).

    209 GitHub stars~1.4k tokensUpdated yesterday
    Writing & ContentAuto-check passed
  • Markdown Article Formatter

    JimLiu/baoyu-skills

    Reformats plain text or Markdown articles with frontmatter, a title, a summary, headings, bold, lists and code blocks, and saves a separate formatted copy.

    26k GitHub starsUsed in 7 repos~3.5k tokens
    Documents & OfficeAuto-check passed
  • Official

    A skill your agent uses when a user says "summarise ecosystem results", "summarize this ty ecosystem report", "what changed in this ecosystem run?", or asks to summarise or summarize ty ecosystem…

    50k GitHub starsUsed in 1 repo~2.2k tokens
    DevelopmentAuto-check passed
  • AIGC Detection Rate Reducer

    xiaofenggan01/aigc-reduce

    Reduces the AI-text detection rate of academic papers by scanning for templated phrasing and making small deterministic edits that keep citations, data and terminology.

    613 GitHub stars~1.5k tokensUpdated 3 mo ago
    Writing & ContentAuto-check passed

More from zhaohui-yang/official-document-drafting

All 8 skills in this repo
  • Chinese Official Document Drafting

    zhaohui-yang/official-document-drafting

    Drafts, rewrites and standardizes Chinese official documents and formal reports such as notices, requests and meeting minutes, and exports the result to Word.

    140 GitHub stars~1.5k tokensUpdated 1 mo ago
    Auto-check passed
  • Official Document Type Routing

    zhaohui-yang/official-document-drafting

    Decides which type of Chinese official document to write and in which direction it travels, using three questions, before handing off to the drafting skill.

    140 GitHub stars~441 tokensUpdated 1 mo ago
    Auto-check passed
  • Official Document DOCX Exporter

    zhaohui-yang/official-document-drafting

    Exports a finished Chinese official-document Markdown draft to a .docx with government-style fonts and layout, with options to preview the font and layout plan first.

    140 GitHub stars~585 tokensUpdated 1 mo ago
    Auto-check passed
  • Ministry News Daily Report

    zhaohui-yang/official-document-drafting

    Collects the latest updates from Chinese central ministry websites and drafts a daily formal report on them, optionally exported to Word.

    140 GitHub stars~555 tokensUpdated 1 mo ago
    Auto-check passed
  • Policy Keyword Tracker

    zhaohui-yang/official-document-drafting

    Collects policies and developments on one topic from Chinese central ministries and compiles them into a verified situation report, with optional Word export.

    140 GitHub stars~555 tokensUpdated 1 mo ago
    Auto-check passed
  • Skill Build

    zhaohui-yang/official-document-drafting

    从 prompts/ 单一主源生成并校验本项目的 skill 产物。Use when working on 构建/重新生成 SKILL.md、agent 接口、dist 副本、assets/templates/ 模板或离线提示词,校验产物是否与 prompts/ 主源同步(--check / 防漂移),或维护 prompts/ → 产物 的单一信息源构建范式。

    140 GitHub stars~487 tokensUpdated 1 mo ago
    Auto-check passed

Works with

Questions about Chinese Official Document QA

What does Chinese Official Document QA do?

Checks the structure and quality of a finished Chinese official document with a section-checking script and a manual checklist, without rewriting it. This skill inspects a completed draft and does the opposite of drafting.py`, covers all 22 document types and flags missing required sections, skipped heading levels, 一是 or 二是 items used as formal headings, third-level headings in documents under 10 pages, leftover placeholders and closing phrases that do not match the type.

When should I use Chinese Official Document QA?

Chinese Official Document QA fits situations like: reviewing a drafted official notice or report for missing sections; checking heading levels and closing phrases against the document type; listing every concrete figure and date in a draft so sources can be verified.

How do I install Chinese Official Document QA in Claude Code?

Run `npx skills add zhaohui-yang/official-document-drafting --skill document-qa -a claude-code`. Or copy the skill folder (skills/document-qa in zhaohui-yang/official-document-drafting) into .claude/skills/document-qa in your project. Claude Code loads it when a task matches its description.

How do I install Chinese Official Document QA in Codex?

Run `npx skills add zhaohui-yang/official-document-drafting --skill document-qa -a codex`. Or copy the skill folder (skills/document-qa in zhaohui-yang/official-document-drafting) into .agents/skills/document-qa in your project. Codex loads it when a task matches its description.

Can I use Chinese Official Document QA 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 zhaohui-yang/official-document-drafting --skill document-qa -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/document-qa, .gemini/skills/document-qa, .github/skills/document-qa and .opencode/skills/document-qa in your project.

What does Chinese Official Document QA need to run?

Going by SKILL.md and its folder, Chinese Official Document QA needs the command-line tools its instructions call (python3). Our summary lists: Python 3 to run the section-checking script; The finished draft as a Markdown file.

Does Chinese Official Document QA 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 Chinese Official Document QA 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 Chinese Official Document QA use?

Chinese Official Document QA has a licence file (the repository's licence) that doesn't match a standard licence. Read it on GitHub before reusing the skill.

How many tokens does Chinese Official Document QA use?

About 466 tokens (SKILL.md is roughly 1.9k 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 Chinese Official Document QA?

Skills that share tags, products or a category with Chinese Official Document QA: Visual Audit (pedrohcgs/claude-code-my-workflow, 1.6k stars), WeChat Article Compliance Reviewer (aiworkskills/wechat-article-skills, 667 stars), Iflytek Text Proofread (iflytek/iFly-Skills, 209 stars) and Markdown Article Formatter (JimLiu/baoyu-skills, 26k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Chinese Official Document QA?

zhaohui-yang (a GitHub user) maintains it in zhaohui-yang/official-document-drafting, which has 140 GitHub stars. The repository holds 8 skills in this directory. The repository was last updated on August 19, 2026.

Source: zhaohui-yang/official-document-drafting on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.