Agent skill

Update Docs

by ArcReel in ArcReel/ArcReel

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

AGPL-3.0Auto-check: notesDevelopment

Install Update Docs

skills CLI
$ npx skills add ArcReel/ArcReel --skill update-docs -a claude-code

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

GitHub CLI
$ gh skill install ArcReel/ArcReel update-docs --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/update-docs .claude/skills/update-docs && 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
update-docs
GitHub stars
5.3k
Token cost
~544 tokens
SKILL.md length
124 words
Files
4 (incl. scripts, references)
Skills in repo
18
Repo updated
First seen
Licence
AGPL-3.0

At a glance

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

  • Works in 7 steps: 收集 → 缺漏扫描:git 历史 → 文档 → 事实核对:文档 → 代码 → …
  • Tasks that involve Technical documentation
  • SKILL.md covers 适用范围, 步骤 and 事实项
  • Runs Shell scripts from its folder; calls bash

What it does

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

Its SKILL.md is about 540 tokens, which your agent loads only when the skill is triggered. The skill folder holds 5 other files, including scripts and reference files (for example `references/fact-checker.md`, `references/gap-finder.md` and `scripts/collect-changes.sh`).

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

When your agent uses it

  • Tasks that involve Technical documentation
  • Tasks that involve Git workflow
  • Tasks that involve AI video generation

Example prompts

  • “/update-docs”

Requirements

  • A Bash shell

Workflow steps

7 steps, taken from the step headings in SKILL.md.

  1. 收集
  2. 缺漏扫描:git 历史 → 文档
  3. 事实核对:文档 → 代码
  4. 分类
  5. 修改
  6. 双语核对
  7. 摘要

What it can do on your machine

Read from SKILL.md and the folder at commit a53c6e6. 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 1 file in scripts/ (Shell), which the agent can run.

    Shell commands in SKILL.md call:

    • bash

    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

Update Docs loads about 544 tokens when it runs, and up to ~1.2k if it reads all its reference files. Until then it costs about 16 tokens; SKILL.md has 124 words of instructions outside code blocks.

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

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: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

  • NoteMentions a .env fileSKILL.md:67
    - 命令与环境变量:安装/启动/部署命令、`.env` 配置项

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 a53c6e6, republished under its AGPL-3.0 licence (© ArcReel). 124 words, ~544 tokens.

Download SKILL.mdSave it as .claude/skills/update-docs/SKILL.md (or your agent's skills folder). This skill also uses 3 other files; get the full folder from GitHub.
name
update-docs
description
根据最近的 git 改动,更新面向用户的文档(README 双语、入门教程、部署、剪映导出等)。手动调用。
disable-model-invocation
true

按最近的代码改动更新面向用户的文档。两道扫描:缺漏扫描(gap finder)读 git 历史,找已落地但文档未反映的新能力;事实核对(fact checker)读文档,找与代码现状不符的过时内容。措辞与结构改动直接修改,事实项经用户确认后再改。

适用范围

in-scope 文档分两组:

  • 全量组(full):高频、主题宽的文档。两道扫描都覆盖,并参与 baseline 计算。
  • 仅核对组(fact-check):低频、主题窄的文档。只做事实核对,不参与 baseline。

档位判据看两条:页面要有能力性正文(新能力能落笔成段)才具备进入全量组的资格,纯导航、索引页即便主题宽也归仅核对组;baseline 取全量组内正文最久未改的一页,纳入低频页会把扫描区间长期钉在旧时间点、放大每轮候选 commit 噪声。

website/docs/ 下每个 .md / .mdx 页面在 frontmatter 用 update_docs 声明覆盖档位:full、fact-check 或 none(明确不参与)。新增页面必须声明,否则收集脚本与 CI 一致性检查都会失败。README.md / CONTRIBUTING.md 等非 Docusaurus 根目录文件仍在收集脚本内少量枚举。CONTRIBUTING「各页职责」须登记全部上站源页面,包括声明为 none 的页面;CI 双向校验缺页和多页。

README.en.md 是 README.md 的镜像,中文为源:不单独扫描,改完后随中文做全文一致性核对(第 6 步)。

面向用户的文档源文件在 website/docs/ 下(发布到 docs.arc-reel.com)。排除供应商费用表,以及未上站的内部文档(docs/ 下的 adr、research、各供应商 SDK 文档等)。新增上站页面按上述判据声明 update_docs,并同步 CONTRIBUTING「各页职责」。

步骤

1. 收集

运行 bash .agents/skills/update-docs/scripts/collect-changes.sh,得到 baseline、全量候选 commit 标题、全量组文档清单与核对文档清单。任一上站页面未声明覆盖档位时脚本非零退出,按提示补 frontmatter 与 CONTRIBUTING「各页职责」后重跑。

2. 缺漏扫描:git 历史 → 文档

派一个只读 subagent(subagent_type: Explore,提示词 .agents/skills/update-docs/references/gap-finder.md),传入仓库根路径、收集输出中的全量组文档与全量候选 commit 标题清单,产出每篇全量组文档的遗漏能力清单。 完成判据:拿到 subagent 列出的遗漏项。

3. 事实核对:文档 → 代码

对核对清单中每篇文档派一个只读 subagent 并行核对(subagent_type: Explore,提示词 .agents/skills/update-docs/references/fact-checker.md)。 完成判据:每篇文档都有事实核对结果。

4. 分类

合并两道扫描的待改项:先按「同文档同位置」去重(两道扫描常撞同一项,如供应商列表),再逐项归为「措辞/结构」「事实项」或「新能力」。 完成判据:每项都已去重并归类。

5. 修改
  • 措辞/结构:直接改。
  • 事实项:先列给用户(位置、现状、建议、依据)确认后再改。
  • 新能力:判断是否重要到该进正文(核心能力 / 功能特性);重要的列给用户确认后写入对应小节,不重要的不进 README(版本流水已由 release-please changelog 覆盖)。

中文文案保持简洁准确,不用翻译腔、口语化或非必要比喻。 完成判据:获准改动全部落地。

6. 双语核对

README.md 改完后,对 README.md 与 README.en.md 两篇全文逐节核对,以中文为源把英文修平到一致(含改前就存在的存量偏离)。 完成判据:两篇逐节对应一致。

7. 摘要

输出改了哪些文档与小节、哪些事实项已确认、哪些新能力已入正文、英文修平了哪些(含存量),以及哪些留待用户处理。不 commit、不 push。

事实项

下列改动须经用户确认,不得直接修改:

  • 命令与环境变量:安装/启动/部署命令、.env 配置项
  • 供应商、模型、能力:供应商列表、默认模型、能力参数。属外部数据,只标记疑点,不猜测或填写具体值
  • 版本与依赖要求
  • 外部链接

© ArcReel, AGPL-3.0. 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 3 other files (scripts, references) in .agents/skills/update-docs of ArcReel/ArcReel.

  • SKILL.md
  • references/fact-checker.md
  • references/gap-finder.md
  • scripts/collect-changes.sh

Open the folder on GitHubat commit a53c6e6

Compare with similar skills

Update Docs 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.

Update Docs compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Update Docs this skillArcReel/ArcReel5.3k—~544Automated safety check: NotesAGPL-3.0
Docs Update from DiffQwenLM/qwen-code28k—~1.1kAutomated safety check: PassApache-2.0
Facade YARD Documentation Rulesruby-git/ruby-git1.8k—~5kAutomated safety check: PassMIT
GitHub Code ReviewRedWoodOG/Hermes-Desktop1775 repos~3.4kAutomated safety check: NotesMIT
Fantasia Final Cleanupvishiri/fantasia-archive409—~1.2kAutomated safety check: PassGPL-3.0
GitHub Release Assistantaiskillstore/marketplace4301 repos~477Automated safety check: PassNone

Similar skills

  • Docs Update from Diff

    QwenLM/qwen-code

    Reads local git changes and updates only the matching docs pages, so documentation stays in sync with uncommitted or recent code changes.

    28k GitHub stars~1.1k tokensUpdated today
    DevelopmentAuto-check passed
  • Sets facade-specific YARD documentation rules for the Git::Repository public API, layered on the gem's general YARD skill.

    1.8k GitHub stars~5k tokensUpdated 6 days ago
    DevelopmentAuto-check passed
  • GitHub Code Review

    RedWoodOG/Hermes-Desktop

    Review code changes by analyzing git diffs, leaving inline comments on PRs, and performing thorough pre-push review.

    177 GitHub starsUsed in 5 repos~3.4k tokens
    DevelopmentAuto-check: notes
  • Fantasia Final Cleanup

    vishiri/fantasia-archive

    End-of-batch ship workflow for Fantasia Archive: run full yarn testbatch:verify (not dev scoped gate), fix failures, sync README/AGENTS/rules/skills from Git changes, update in-app changelog, split…

    409 GitHub stars~1.2k tokensUpdated 6 days ago
    DevelopmentAuto-check passed
  • GitHub Release Assistant

    aiskillstore/marketplace

    Generate bilingual GitHub release documentation (README.md + README.zh.md) from repo metadata and user input, and guide release prep with git add/commit/push.

    430 GitHub starsUsed in 1 repo~477 tokens
    DevelopmentAuto-check passed
  • Docs Updater

    giuseppe-trisciuoglio/developer-kit

    Provides automated documentation updates by analyzing git changes between the current branch and the last release tag.

    355 GitHub stars~2.6k tokensUpdated 27 days ago
    DevelopmentAuto-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.3k GitHub stars~667 tokensUpdated today
    Auto-check passed
  • Tech Doc Style Chinese

    ArcReel/ArcReel

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

    5.3k GitHub starsUsed in 1 repo~845 tokens
    Auto-check passed
  • Translate Docs

    ArcReel/ArcReel

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

    5.3k GitHub stars~1.8k tokensUpdated today
    Auto-check passed
  • Adapt Custom Endpoint

    ArcReel/ArcReel

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

    5.3k GitHub stars~413 tokensUpdated today
    Auto-check passed
  • Afk Team Workflow

    ArcReel/ArcReel

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

    5.3k GitHub stars~794 tokensUpdated today
    Auto-check passed
  • Generate Script

    ArcReel/ArcReel

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

    5.3k GitHub stars~1.4k tokensUpdated today
    Auto-check passed

Works with

Questions about Update Docs

What does Update Docs do?

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

When should I use Update Docs?

Update Docs fits situations like: tasks that involve Technical documentation; tasks that involve Git workflow; tasks that involve AI video generation.

How do I install Update Docs in Claude Code?

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

How do I install Update Docs in Codex?

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

Can I use Update Docs 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 update-docs -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/update-docs, .gemini/skills/update-docs, .github/skills/update-docs and .opencode/skills/update-docs in your project.

What does Update Docs need to run?

Going by SKILL.md and its folder, Update Docs needs a shell for the scripts in its folder and the command-line tools its instructions call (bash). Our summary lists: A Bash shell.

Does Update Docs 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 Update Docs safe to install?

Our automated static check of SKILL.md found notes only (mentions a .env file), nothing it rates as a warning. 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 Update Docs use?

Update Docs is published under the AGPL-3.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Update Docs use?

About 544 tokens (SKILL.md is roughly 2.2k 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 671 tokens, read only when the agent opens those files.

What are the alternatives to Update Docs?

Skills that share tags, products or a category with Update Docs: Docs Update from Diff (QwenLM/qwen-code, 28k stars), Facade YARD Documentation Rules (ruby-git/ruby-git, 1.8k stars), GitHub Code Review (RedWoodOG/Hermes-Desktop, 177 stars) and Fantasia Final Cleanup (vishiri/fantasia-archive, 409 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Update Docs?

ArcReel (a GitHub organization) maintains it in ArcReel/ArcReel, which has 5,323 GitHub stars. The repository holds 18 skills in this directory. The repository was last updated on October 7, 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.