Agent skill

Tech Doc Style Chinese

by ArcReel in ArcReel/ArcReel

在撰写、改写、校对或审阅中文技术文档、产品文案、界面文案、Markdown 文档、API 说明、操作手册、故障排查或运维文档时使用。采用克制、准确、可扫读的中文技术写作风格;保留原文事实、限制和机器可读内容;按任务读取术语排版、API 状态文案、项目覆盖或受控中文技术写作参考。

MITAuto-check passedMedia & Creative

Install Tech Doc Style Chinese

skills CLI
$ npx skills add ArcReel/ArcReel --skill tech-doc-style-chinese -a claude-code

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

GitHub CLI
$ gh skill install ArcReel/ArcReel tech-doc-style-chinese --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/ArcReel/ArcReel.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/tech-doc-style-chinese .claude/skills/tech-doc-style-chinese && 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
tech-doc-style-chinese
GitHub stars
5.4k
Used in
1 other repo
Token cost
~845 tokens
SKILL.md length
177 words
Files
15 (incl. scripts, references)
Skills in repo
18
Repo updated
First seen
Licence
MIT

At a glance

在撰写、改写、校对或审阅中文技术文档、产品文案、界面文案、Markdown 文档、API 说明、操作手册、故障排查或运维文档时使用。采用克制、准确、可扫读的中文技术写作风格;保留原文事实、限制和机器可读内容;按任务读取术语排版、API 状态文案、项目覆盖或受控中文技术写作参考。

  • Works in 5 steps: 保留事实、逻辑、限制、安全信息和法律含义。 → 服从用户明确要求和目标项目约定。 → 保持技术术语和机器可读内容准确。 → …
  • Tasks that involve AI video generation
  • SKILL.md covers 适用范围, 规则优先级, 事实保真 and 先判断任务模式, plus 6 more sections
  • Runs Python scripts from its folder

What it does

Tech Doc Style Chinese is an agent skill from ArcReel/ArcReel. 在撰写、改写、校对或审阅中文技术文档、产品文案、界面文案、Markdown 文档、API 说明、操作手册、故障排查或运维文档时使用。采用克制、准确、可扫读的中文技术写作风格;保留原文事实、限制和机器可读内容;按任务读取术语排版、API 状态文案、项目覆盖或受控中文技术写作参考。

Its SKILL.md is about 850 tokens, which your agent loads only when the skill is triggered. The skill folder holds 20 other files, including scripts and reference files (for example `.github/workflows/skill-lint.yml`, `NoCode-Skill.md` and `README.md`).

It sits in Media & Creative, covering AI video generation. The repository describes itself as: AI Agent 驱动的开源可自部署视频工作台:将小说与剧本转为角色、场景、道具资产、分镜、视频和剪映草稿,支持跨镜头一致性、多供应商与费用追踪 | Self-hosted AI video workspace for stories, storyboards and short-form video production. The licence is MIT.

When your agent uses it

  • Tasks that involve AI video generation

Example prompts

  • “/tech-doc-style-chinese”

Requirements

  • Python 3

Workflow steps

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

  1. 保留事实、逻辑、限制、安全信息和法律含义。
  2. 服从用户明确要求和目标项目约定。
  3. 保持技术术语和机器可读内容准确。
  4. 改善结构、语义、语气和可扫读性。
  5. 最后处理标点、留白、大小写等排版细节。

What it can do on your machine

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

    Ships 2 files in scripts/ (Python), which the agent can run.

    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

Tech Doc Style Chinese loads about 845 tokens when it runs, and up to ~6.4k if it reads all its reference files. Until then it costs about 41 tokens; SKILL.md has 177 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~41
When it runs · the whole SKILL.md, loaded when a task matches
~845
With references · SKILL.md plus every file in references/, read only if the agent opens them
~6.4k

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); the scripts in this folder are not scanned.

SKILL.md

The full file from ArcReel/ArcReel at commit 2dd9d91, republished under its MIT licence (© ArcReel). 177 words, ~845 tokens.

Download SKILL.mdSave it as .claude/skills/tech-doc-style-chinese/SKILL.md (or your agent's skills folder). This skill also uses 14 other files; get the full folder from GitHub.
name
tech-doc-style-chinese
description
在撰写、改写、校对或审阅中文技术文档、产品文案、界面文案、Markdown 文档、API 说明、操作手册、故障排查或运维文档时使用。采用克制、准确、可扫读的中文技术写作风格;保留原文事实、限制和机器可读内容;按任务读取术语排版、API 状态文案、项目覆盖或受控中文技术写作参考。

中文技术文档与产品文案规范

<!-- 作者:Fenng(GitHub:@Fenng) -->

适用范围

将本 Skill 用于中文技术内容的撰写、改写、校对和审阅,包括:

  • 文档首页、产品介绍、解决方案页和更新日志
  • API 文档、参数说明、错误码和常见问题
  • 操作手册、故障排查、运维 Runbook 和安全说明
  • 界面文案、按钮、导航、状态和提示信息

不要改写代码字面量、JSON 键名、URL、API 路径、数据库字段名、命令、配置项或其他机器可读标识符。

规则优先级

发生冲突时,按以下顺序处理:

  1. 保留事实、逻辑、限制、安全信息和法律含义。
  2. 服从用户明确要求和目标项目约定。
  3. 保持技术术语和机器可读内容准确。
  4. 改善结构、语义、语气和可扫读性。
  5. 最后处理标点、留白、大小写等排版细节。

不得为了句子更短、语气更确定或格式更统一而牺牲更高优先级的信息。

事实保真

  • 不新增原文或可靠上下文没有提供的日期、数字、时限、SLA、能力、条件、因果关系或结论。
  • 不删除前置条件、适用范围、例外、风险、安全警告、兼容性说明或失败处理。
  • 不把可能、计划、建议、通常等不确定表达改成确定事实。
  • 信息不足时保留原意,或明确标记「待确认」;不要自行补全。
  • 改写引用、法规、合同、错误原文或用户提供的固定文案时,优先保持原文并将建议单独列出。

示例:

  • 截止 4 月 12 日 -> 截至 4 月 12 日
  • 尽快处理 -> 在约定时限内处理〔具体时限待确认〕
  • 不要凭空补成 截至 2026 年 4 月 12 日 或 30 分钟内处理

先判断任务模式

撰写
  • 先确定受众、内容类型、事实来源、发布载体和篇幅。
  • 缺少会改变结论的事实时,先标记缺口,再继续组织可确认内容。
改写
  • 保留事实、逻辑关系、信息层级、限制和必要例外。
  • 默认交付完整改写稿;重大语义选择或待确认内容另行说明。
校对
  • 只处理约定范围内的错字、标点、留白、大小写和术语一致性。
  • 未经要求,不改变结构、语气或事实表达。
审阅
  • 先列问题,再给建议;按影响程度排序并引用具体原文。
  • 未经授权,不直接修改文件。

核心写作规则

语义与语气
  • 准确先于修辞,清晰先于热闹。
  • 使用克制、直接、可执行的中文。
  • 优先说明「是什么、适用于什么、需要做什么、接着看哪里」。
  • 避免问候式开场、宣传口号、空泛形容和连续堆叠黑话。
  • 默认不直接称呼读者;必要时使用明确角色,如「开发者」「实施人员」。
  • 第二人称、感叹号和品牌语气属于风格选择;项目约定或特定界面语境可以覆盖默认规则。
结构与句子
  • 一个段落承载一个主要信息点。
  • 一个句子保持一个清晰的主干;不要连续堆叠多个条件、动作和例外。
  • 列表项保持相同层级、句式和信息密度。
  • 标题反映用途,不只使用抽象名词。
  • 删除重复信息,不删除事实、条件和例外。
  • 指代可能不清时,用具体名称替代「该」「其」「此」「上述」。
术语与排版
  • 同一概念使用同一首选术语,不因追求变化而替换同义词。
  • 中文正文使用直角引号 「」,嵌套引用使用 『』;项目、地区或固定引用规范可以覆盖。
  • 在可见正文中,中文与英文、阿拉伯数字和版本号之间加一个半角空格,例如 使用 API 获取数据、等待 3 秒、版本 2.0 已发布。
  • 中文与行内代码之间加一个半角空格;链接按显示文字判断留白。中文全角标点前后不额外加空格,不修改代码、链接目标、官方名称和用户指定字面量。
  • 中文段落在源文件中保持一段一行,不为了控制行宽做硬换行;代码块、表格、标题和列表结构保持原样。
  • 术语、产品名和缩写优先采用项目规范或官方写法,不机械替换。
  • 不直接批量运行排版替换工具;先保护 Markdown、代码和机器可读内容。

详细规则见 术语与排版。

按内容类型处理

入口页和介绍页

首段优先回答:

  • 内容覆盖什么
  • 适合谁使用
  • 从哪里开始读

避免标题、正文和行动按钮重复同一信息。

API 文档
  • 请求方法、路径、字段和值使用代码环境保护。
  • 参数说明一列一义,并写清类型、单位、默认值、限制和是否必填。
  • 状态和错误文案根据实际语义翻译,不机械对应单个英文词。
  • 写明前置条件、成功结果、失败结果和恢复方式。

详细规则见 API 状态与错误文案。

界面文案
  • 按钮说明动作和目标,不重复页面标题。
  • 错误提示说明发生了什么、影响是什么,以及如何恢复。
  • 危险操作写清对象、后果和是否可撤销。
  • 空状态区分「没有数据」「尚未创建」「无权限」和「加载失败」。
操作与故障排查

对操作手册、故障排查、运维 Runbook、安全说明和多步骤 API 流程,读取并应用 受控中文技术写作。不要把这些规则机械应用于品牌文案、叙事文本或固定引用。

项目覆盖规则

先检查目标项目自己的 AGENTS.md、术语表、品牌规范、既有文档和用户指示。不要把本 Skill 仓库中的示例约定当成目标项目约定。

需要建立项目覆盖文件时,参考 项目覆盖模板,并将实际文件放在目标项目中。

编辑流程

以下流程按任务模式选择执行;校对只执行约定范围内的检查和修改。

  1. 确认任务模式、内容类型、受众和项目约定。
  2. 标记事实、数字、限制、引用和机器可读内容,建立不可改动边界。
  3. 修复语义错误、歧义、遗漏和不一致。
  4. 调整信息顺序、段落、标题和列表。
  5. 处理语气、术语、标点、留白和大小写。
  6. 对照原文复核事实、条件、否定范围、因果关系和确定程度。
  7. 运行适用的轻量检查器,并人工判断警告和风格提示。

最终检查

  • 是否新增了来源不明的日期、数字、时限、能力或结论
  • 是否遗漏了条件、例外、风险、单位、默认值或恢复方式
  • 主语、对象、否定范围、因果关系和确定程度是否保持准确
  • 同一概念是否使用同一术语
  • 标题、正文、卡片和按钮是否重复
  • 代码、路径、字段、命令和引用是否保持原样
  • 内容是否便于目标读者扫读和执行
  • 段落是否残留硬换行,拼接边界的中西文留白是否正确
  • 项目覆盖规则是否来自目标项目,而不是示例文件

参考资料路由

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

Files

SKILL.md and 14 other files (scripts, references) in .agents/skills/tech-doc-style-chinese of ArcReel/ArcReel.

  • SKILL.md
  • .github/workflows/skill-lint.yml
  • LICENSE
  • NoCode-Skill.md
  • README.md
  • agents/openai.yaml
  • references/api-status-copy.md
  • references/controlled-technical-chinese.md
  • references/project-overrides-example.md
  • references/terminology-and-typography.md
  • scripts/lint_copy_rules.py
  • scripts/unwrap_md_paragraphs.py
  • tests/test_lint_copy_rules.py
  • tests/test_skill_structure.py
  • tests/test_unwrap_md_paragraphs.py

Open the folder on GitHubat commit 2dd9d91

Used in 1 other repository

We found 1 copy of this SKILL.md (exact, near-identical or edited) in other folders, from 1 other GitHub owner. This page covers the copy in ArcReel/ArcReel, which our catalogue first saw on October 7, 2026.

Compare with similar skills

Tech Doc Style Chinese 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.

Tech Doc Style Chinese compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Tech Doc Style Chinese this skillArcReel/ArcReel5.4k1 repos~845Automated safety check: PassMIT
Video Generationbytedance/deer-flow84k3 repos~1.4kAutomated safety check: PassMIT
Video Cover Imageitwanger/toBeBetterJavaer18k—~3.3kAutomated safety check: PassNone
Seedancesongguoxs/seedance-prompt-skill2.9k1 repos~2.5kAutomated safety check: PassNone
HyperFrames Video Entry Pointheygen-com/hyperframes60k3 repos~5.2kAutomated safety check: PassApache-2.0
Lanshu Create AI Presenter Videocclank/lanshu-create-ai-presenter-video2.6k—~3.6kAutomated safety check: PassMIT

Similar skills

  • Video Generation

    bytedance/deer-flow

    Generates short videos from a structured JSON prompt, optionally guided by a reference image used as the first or last frame.

    84k GitHub starsUsed in 3 repos~1.4k tokens
    Media & CreativeAuto-check passed
  • Video Cover Image

    itwanger/toBeBetterJavaer

    Generate matched 3:4, 16:9, and 4:3 short-video cover images from toBeBetterJavaer video scripts or AI/Java technical topics.

    18k GitHub stars~3.3k tokensUpdated yesterday
    Media & CreativeAuto-check passed
  • Seedance

    songguoxs/seedance-prompt-skill

    This skill should be used when the user asks to "generate video prompts", "create Seedance prompts", "write video descriptions", mentions "Seedance", "seedance", "即梦", "即梦平台", "视频提示词", "视频生成"…

    2.9k GitHub starsUsed in 1 repo~2.5k tokens
    Media & CreativeAuto-check passed
  • HyperFrames Video Entry Point

    heygen-com/hyperframes

    Entry point for making, editing and rendering videos from HTML compositions with HyperFrames, routing each request to the right workflow.

    60k GitHub starsUsed in 3 repos~5.2k tokens
    Media & CreativeAuto-check passed
  • Lanshu Create AI Presenter Video

    cclank/lanshu-create-ai-presenter-video

    Turn a topic or finished script into a complete, publish-ready explainer video — led by an AI presenter from an authorized adult presenter image, or performed in one of nine visual explainer styles…

    2.6k GitHub stars~3.6k tokensUpdated today
    Media & CreativeAuto-check passed
  • Video Shots

    eternityspring/reelbench-skills

    拉片:把一条成片拆成逐镜头的分析表——每个镜头的时长、景别、类别、运镜、画面. An agent skill from eternityspring/reelbench-skills.

    878 GitHub starsUsed in 1 repo~1.8k tokens
    Media & CreativeAuto-check: notes

More from ArcReel/ArcReel

All 18 skills in this repo
  • PR AI Review Loop

    ArcReel/ArcReel

    PR AI review 收敛。用户或 team-lead 要求启动或继续审查—修复循环时使用;供本地实现者或受委派的 review-looper 调用,不用于 GitHub reviewer 产出审查意见或仅处理单条评论。

    5.4k GitHub stars~667 tokensUpdated yesterday
    Auto-check passed
  • Translate Docs

    ArcReel/ArcReel

    Translate every dirty ArcReel documentation source into English and refresh the translation lockfile.

    5.4k GitHub stars~1.8k tokensUpdated yesterday
    Auto-check passed
  • Adapt Custom Endpoint

    ArcReel/ArcReel

    当用户要求把采用 JSON 提交后轮询协议的视频或图片供应商接入 ArcReel,或要求编写、验证、测试、保存自定义调用端点定义时使用。

    5.4k GitHub stars~413 tokensUpdated yesterday
    Auto-check passed
  • Afk Team Workflow

    ArcReel/ArcReel

    把一个 Spec 的全部子 issue(或一组显式 issue)组建团队无人值守跑到全部合并或明确暂停. An agent skill from ArcReel/ArcReel.

    5.4k GitHub stars~794 tokensUpdated yesterday
    Auto-check passed
  • Update Docs

    ArcReel/ArcReel

    根据最近的 git 改动,更新面向用户的文档(README 双语、入门教程、部署、剪映导出等)。手动调用. An agent skill from ArcReel/ArcReel.

    5.4k GitHub stars~544 tokensUpdated yesterday
    Auto-check: notes
  • Generate Script

    ArcReel/ArcReel

    提示词编写:调用项目配置的文本模型,为正式脚本中待编写的分镜 / 视频单元补出 imageprompt 与 videoprompt(参考生视频改写单元正文);ad 项目尚无正式脚本时整份生成。由 create-episode-script 子智能体调用,输入是正式脚本自身的内容与 project.json。

    5.4k GitHub stars~1.4k tokensUpdated yesterday
    Auto-check passed

Questions about Tech Doc Style Chinese

What does Tech Doc Style Chinese do?

在撰写、改写、校对或审阅中文技术文档、产品文案、界面文案、Markdown 文档、API 说明、操作手册、故障排查或运维文档时使用。采用克制、准确、可扫读的中文技术写作风格;保留原文事实、限制和机器可读内容;按任务读取术语排版、API 状态文案、项目覆盖或受控中文技术写作参考。. Tech Doc Style Chinese is an agent skill from ArcReel/ArcReel.

When should I use Tech Doc Style Chinese?

Tech Doc Style Chinese fits situations like: tasks that involve AI video generation.

How do I install Tech Doc Style Chinese in Claude Code?

Run `npx skills add ArcReel/ArcReel --skill tech-doc-style-chinese -a claude-code`. Or copy the skill folder (.agents/skills/tech-doc-style-chinese in ArcReel/ArcReel) into .claude/skills/tech-doc-style-chinese in your project. Claude Code loads it when a task matches its description.

How do I install Tech Doc Style Chinese in Codex?

Run `npx skills add ArcReel/ArcReel --skill tech-doc-style-chinese -a codex`. Or copy the skill folder (.agents/skills/tech-doc-style-chinese in ArcReel/ArcReel) into .agents/skills/tech-doc-style-chinese in your project. Codex loads it when a task matches its description.

Can I use Tech Doc Style Chinese 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 ArcReel/ArcReel --skill tech-doc-style-chinese -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/tech-doc-style-chinese, .gemini/skills/tech-doc-style-chinese, .github/skills/tech-doc-style-chinese and .opencode/skills/tech-doc-style-chinese in your project.

What does Tech Doc Style Chinese need to run?

Going by SKILL.md and its folder, Tech Doc Style Chinese needs Python for the scripts in its folder. Our summary lists: Python 3.

Does Tech Doc Style Chinese 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 Tech Doc Style Chinese 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. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Tech Doc Style Chinese use?

Tech Doc Style Chinese is published under the MIT licence (from the LICENSE file in the skill folder). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Tech Doc Style Chinese use?

About 845 tokens (SKILL.md is roughly 3.4k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 5.5k tokens, read only when the agent opens those files.

What are the alternatives to Tech Doc Style Chinese?

Skills that share tags, products or a category with Tech Doc Style Chinese: Video Generation (bytedance/deer-flow, 84k stars), Video Cover Image (itwanger/toBeBetterJavaer, 18k stars), Seedance (songguoxs/seedance-prompt-skill, 2.9k stars) and HyperFrames Video Entry Point (heygen-com/hyperframes, 60k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Tech Doc Style Chinese?

ArcReel (a GitHub organization) maintains it in ArcReel/ArcReel, which has 5,426 GitHub stars. The repository holds 18 skills in this directory. The repository was last updated on October 10, 2026.

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