Agent skill

Research Guide Updater

by huangwb8 in huangwb8/ChineseResearchLaTeX

当用户明确要求"更新项目指南""同步指南""沉淀洞见到指南",或要求使用旧名 guide-updater skill 时使用。将对话中新产生的可复用写作洞见实时沉淀到项目指南文件,保持术语口径一致、结构稳定、可检验与可复现。调用时必须指定指南文件路径。

MITAuto-check passedDocuments & Office

Install Research Guide Updater

skills CLI
$ npx skills add huangwb8/ChineseResearchLaTeX --skill research-guide-updater -a claude-code

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

GitHub CLI
$ gh skill install huangwb8/ChineseResearchLaTeX research-guide-updater --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/huangwb8/ChineseResearchLaTeX.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/research-guide-updater .claude/skills/research-guide-updater && 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
research-guide-updater
GitHub stars
2.9k
Token cost
~741 tokens
SKILL.md length
175 words
Files
6 (incl. scripts, references)
Skills in repo
27
Repo updated
First seen
Licence
MIT

At a glance

当用户明确要求"更新项目指南""同步指南""沉淀洞见到指南",或要求使用旧名 guide-updater skill 时使用。将对话中新产生的可复用写作洞见实时沉淀到项目指南文件,保持术语口径一致、结构稳定、可检验与可复现。调用时必须指定指南文件路径。

  • Documents & Office work in your project
  • SKILL.md covers 流程 and 约束
  • Runs Python scripts from its folder; calls python

What it does

Research Guide Updater is an agent skill from huangwb8/ChineseResearchLaTeX. 当用户明确要求"更新项目指南""同步指南""沉淀洞见到指南",或要求使用旧名 guide-updater skill 时使用。将对话中新产生的可复用写作洞见实时沉淀到项目指南文件,保持术语口径一致、结构稳定、可检验与可复现。调用时必须指定指南文件路径。

Its SKILL.md is about 740 tokens, which your agent loads only when the skill is triggered. The skill folder holds 7 other files, including scripts and reference files (for example `CHANGELOG.md`, `README.md` and `config.yaml`).

It sits in Documents & Office. The licence is MIT.

When your agent uses it

  • Documents & Office work in your project

Example prompts

  • “更新项目指南”
  • “沉淀洞见到指南”
  • “/research-guide-updater”

Requirements

  • Python 3

What it can do on your machine

Read from SKILL.md and the folder at commit b8b4142. 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/ (Python), which the agent can run.

    Shell commands in SKILL.md call:

    • python

    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

Research Guide Updater loads about 741 tokens when it runs, and up to ~1.1k if it reads all its reference files. Until then it costs about 37 tokens; SKILL.md has 175 words of instructions outside code blocks.

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

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 huangwb8/ChineseResearchLaTeX at commit b8b4142, republished under its MIT licence (© huangwb8). 175 words, ~741 tokens.

Download SKILL.mdSave it as .claude/skills/research-guide-updater/SKILL.md (or your agent's skills folder). This skill also uses 5 other files; get the full folder from GitHub.
name
research-guide-updater
description
当用户明确要求"更新项目指南""同步指南""沉淀洞见到指南",或要求使用旧名 guide-updater skill 时使用。将对话中新产生的可复用写作洞见实时沉淀到项目指南文件,保持术语口径一致、结构稳定、可检验与可复现。调用时必须指定指南文件路径。
metadata.author
Bensz Conan

项目指南更新器

先决条件

每次更新前快速自检:

  • 不新增新的 ## 级标题;只在既有小节/列表中"融入"新增要点。
  • 不改动既有标题文本、编号、顺序;不为"整理美观"重排大量内容。
  • 新增内容默认写成 1 条或少量 bullet,紧贴相邻条目的写法与语气。
  • 涉及事实/文献:只写可核验信息;无法核验则标注"待核验",不要编造详细信息。

流程

输入

按用户请求和配置文件提供必要输入;缺失信息应明确列出并停止依赖该输入的步骤。

执行步骤
  • 当用户环境中出现因本 skill 设计缺陷导致的 bug 时,优先使用 bensz-collect-bugs 按规范记录到 ~/.bensz-skills/bugs/,严禁直接修改用户本地 Claude Code / Codex 中已安装的 skill 源码。
  • 若 AI 仍可通过 workaround 继续完成用户任务,应先记录 bug,再继续完成当前任务。
  • 当用户明确要求“report bensz skills bugs”等公开上报动作时,调用本地 gh 与 bensz-collect-bugs,仅上传新增 bug 到 huangwb8/bensz-bugs;不要 pull / clone 整个 bug 仓库。

将对话中新产生的可复用写作洞见实时沉淀到项目指南文件,保持术语口径一致、结构稳定、可检验与可复现。

旧名 guide-updater 仅作为 prompt 兼容别名保留;安装新版本时系统级旧目录会被清理。

调用此技能时,必须在参数中指定指南文件路径:

/research-guide-updater --guide-path <路径>

或自然语言形式:

  • "更新项目指南(路径:projects/MyProject/项目指南.md)"

  • "把这些内容同步到指南文件 docs/写作指南.md"

  • 将用户表达拆成若干条"可落笔"的要点,每条只包含一个主张/规则/写法。

  • 为每条要点附 1 句"写进指南的目的"(例如:统一口径/防评审质疑/可复现/风险控制)。

  • 需要更细的落点规则时,先读 skills/research-guide-updater/references/guide-structure-map.md 再动手。

  • 写作原则/禁区/句式 → ## 写作哲学

  • 术语、缩写、大小写、核心概念定义 → ## 命名与术语

  • 方法链条、验证口径、评估指标 → ## 基本原理

  • 范式定位、对照坐标系、差异化要点 → ## 文献综述与创新性

  • 具体写到哪一节(文档结构映射) → ## 落点清单

  • 评审问答口径 → ## 评审专家可能的问题及回答

  • 风险与对策 → ## 研究风险

  • "可核验事实锚点"(源码、参数、流程) → ## 附录

不确定放哪:优先放到"最能减少未来写作返工"的位置;仍不确定就先问用户"更希望作为写作哲学/技术路线/风险控制哪一类沉淀?"再改文件。

  • 只做"增量补丁":新增 1--3 条 bullet 或在既有 bullet 末尾补 1 句澄清。
  • 不新开大段长文;如果洞见很大,先拆成多个 bullet 分散落在对应小节。
  • 与已有术语保持一致(参考项目既有术语表)。
目录用途
scripts/校验 项目指南.md 是否保持关键结构与必要标题
references/记录结构映射与落点规则,避免反复判断放置位置
输出

输出 Skill description 所承诺的交付物,并明确格式、路径和失败返回形式。

输出管理

本 Skill 的新任务中间文件统一写入 ./.bensz-api/task-{yyyymmdd-hhmm}-{简短描述}/{skill名}/input|output|log/。同一任务复用一个任务根目录;多 Skill 协作才创建 shared/。正式交付物不写入该目录,历史隐藏目录只允许显式兼容读取、迁移或清理。

校验
  • 运行 python skills/research-guide-updater/scripts/validate_guide.py <指南文件路径>(或手动确认关键 ## 标题仍存在)。
  • 搜索是否意外新增 ## 级标题或引入"另起炉灶"的新结构。
失败与恢复

保留错误证据和已完成产物;仅在输入、环境或外部依赖恢复后从最近的失败步骤重试。

约束

遵守以下公共约束,并执行本 Skill 的专属边界。

公共硬约束
  • 任务需要落盘时,使用唯一的 ./.bensz-api/task-{yyyymmdd-hhmm}-{简短描述}/ 根目录;共享材料放入 shared/,Skill 专属材料放入该 Skill 的 input/、output/、log/。
  • 正式交付物、源代码和正式计划按项目约定保存,不写入任务工作区;未经授权不覆盖、删除、迁移或远程写入。
  • 项目维护变更检查 BAC 可用性并记录需求、AI 产出、工具结果、文件改动和验证摘要;BAC 只做过程审计,不替代署名、责任或合规判断。
  • 不记录 API Key、访问令牌、密码、Cookie、环境/凭据文件、私有 Prompt、身份信息、本地用户名、主机名或不必要的大体积原始数据。
  • 文件路径必须规范化并限制在授权项目范围内;外部 URL、子进程和网络访问遵循最小权限,防止路径遍历、SSRF 和命令注入。
  • Skill 版本唯一记录在自身 config.yaml:skill_info.version;公开 API、协议、目录或配置变更同步文档与 CHANGELOG.md。
  • 仅将 Skill 或 Bensz 基础设施本身的设计缺陷交给 bensz-collect-bugs;先脱敏写入 ~/.bensz-skills/bugs/,当前任务不中断,只有用户明确要求才公开上报,禁止直接修改用户已安装的 Skill 源码。
<!-- End of canonical common constraints. -->
Skill 专属约束

不得超出本 Skill description 和上方流程所声明的范围;不将未验证的信息伪装成确定结论。

© huangwb8, 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 5 other files (scripts, references) in skills/research-guide-updater of huangwb8/ChineseResearchLaTeX.

  • SKILL.md
  • CHANGELOG.md
  • README.md
  • config.yaml
  • references/guide-structure-map.md
  • scripts/validate_guide.py

Open the folder on GitHubat commit b8b4142

Compare with similar skills

Research Guide Updater 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.

Research Guide Updater compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Research Guide Updater this skillhuangwb8/ChineseResearchLaTeX2.9k—~741Automated safety check: PassMIT
Markdown Article FormatterJimLiu/baoyu-skills27k6 repos~3.5kAutomated safety check: PassMIT
MarkitdownImCa0/just-laws78114 repos~3.2kAutomated safety check: NotesMIT
Obsidian MarkdownAtmosphere/atmosphere3.8k20 repos~1.3kAutomated safety check: PassApache-2.0
DOCXrvdbreemen/OTGW-firmware20733 repos~4.3kAutomated safety check: PassProprietary
Word Document Reader and WriterHKUDS/DeepTutor41k—~2.5kAutomated safety check: PassApache-2.0

Similar skills

  • 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.

    27k GitHub starsUsed in 6 repos~3.5k tokens
    Documents & OfficeAuto-check passed
  • Markitdown

    ImCa0/just-laws

    Convert files and office documents to Markdown. An agent skill from ImCa0/just-laws.

    781 GitHub starsUsed in 14 repos~3.2k tokens
    Documents & OfficeAuto-check: notes
  • Obsidian Markdown

    Atmosphere/atmosphere

    Create and edit Obsidian Flavored Markdown with wikilinks, embeds, callouts, properties, and other Obsidian-specific syntax.

    3.8k GitHub starsUsed in 20 repos~1.3k tokens
    Documents & OfficeAuto-check passed
  • DOCX

    rvdbreemen/OTGW-firmware

    A skill your agent uses whenever the user wants to create, read, edit, or manipulate Word documents (.docx files).

    207 GitHub starsUsed in 33 repos~4.3k tokens
    Documents & OfficeAuto-check passed
  • 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
  • Crossposting

    wasp-lang/wasp

    Crosspost Wasp blog articles (MDX) to DEV.to and Medium. An agent skill from wasp-lang/wasp.

    19k GitHub stars~1.1k tokensUpdated today
    Documents & OfficeAuto-check passed

More from huangwb8/ChineseResearchLaTeX

All 27 skills in this repo
  • NSFC Grant Rationale Writer

    huangwb8/ChineseResearchLaTeX

    Writes, restructures, reviews and polishes the rationale section of NSFC research grant applications in LaTeX, with backups and a diff before every write.

    2.9k GitHub stars~945 tokensUpdated 7 days ago
    Auto-check passed
  • LaTeX Example Content Generator

    huangwb8/ChineseResearchLaTeX

    Fills an existing LaTeX project with sample sections, tables and figure narratives, protecting the template structure and previewing before writing.

    2.9k GitHub starsUsed in 1 repo~744 tokens
    Auto-check passed
  • Journal Selector for Manuscripts

    huangwb8/ChineseResearchLaTeX

    Recommends journals for a manuscript by filtering a bundled impact-factor catalog, verifying scope and quality online, and writing a ranked Markdown report.

    2.9k GitHub stars~1.7k tokensUpdated 7 days ago
    Auto-check passed
  • NSFC Abstract Writer

    huangwb8/ChineseResearchLaTeX

    Writes Chinese and English abstracts for NSFC grant applications, with a recommended title and five alternatives, within set character limits.

    2.9k GitHub starsUsed in 1 repo~1.3k tokens
    Auto-check passed
  • NSFC Budget Justification Writer

    huangwb8/ChineseResearchLaTeX

    Writes a submission-ready NSFC budget justification as a LaTeX project and renders budget.pdf from your grant proposal text and supporting materials.

    2.9k GitHub starsUsed in 1 repo~1.4k tokens
    Auto-check passed
  • NSFC Application Code Recommender

    huangwb8/ChineseResearchLaTeX

    Recommends five pairs of NSFC application codes, primary and secondary, from a grant proposal's text and writes the reasons to a Markdown report.

    2.9k GitHub starsUsed in 1 repo~1.1k tokens
    Auto-check passed

Questions about Research Guide Updater

What does Research Guide Updater do?

当用户明确要求"更新项目指南""同步指南""沉淀洞见到指南",或要求使用旧名 guide-updater skill 时使用。将对话中新产生的可复用写作洞见实时沉淀到项目指南文件,保持术语口径一致、结构稳定、可检验与可复现。调用时必须指定指南文件路径。. Research Guide Updater is an agent skill from huangwb8/ChineseResearchLaTeX.

When should I use Research Guide Updater?

Research Guide Updater fits situations like: documents & Office work in your project.

How do I install Research Guide Updater in Claude Code?

Run `npx skills add huangwb8/ChineseResearchLaTeX --skill research-guide-updater -a claude-code`. Or copy the skill folder (skills/research-guide-updater in huangwb8/ChineseResearchLaTeX) into .claude/skills/research-guide-updater in your project. Claude Code loads it when a task matches its description.

How do I install Research Guide Updater in Codex?

Run `npx skills add huangwb8/ChineseResearchLaTeX --skill research-guide-updater -a codex`. Or copy the skill folder (skills/research-guide-updater in huangwb8/ChineseResearchLaTeX) into .agents/skills/research-guide-updater in your project. Codex loads it when a task matches its description.

Can I use Research Guide Updater 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 huangwb8/ChineseResearchLaTeX --skill research-guide-updater -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/research-guide-updater, .gemini/skills/research-guide-updater, .github/skills/research-guide-updater and .opencode/skills/research-guide-updater in your project.

What does Research Guide Updater need to run?

Going by SKILL.md and its folder, Research Guide Updater needs Python for the scripts in its folder and the command-line tools its instructions call (python). Our summary lists: Python 3.

Does Research Guide Updater 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 Research Guide Updater 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 Research Guide Updater use?

Research Guide Updater is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Research Guide Updater use?

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

What are the alternatives to Research Guide Updater?

Skills that share tags, products or a category with Research Guide Updater: Markdown Article Formatter (JimLiu/baoyu-skills, 27k stars), Markitdown (ImCa0/just-laws, 781 stars), Obsidian Markdown (Atmosphere/atmosphere, 3.8k stars) and DOCX (rvdbreemen/OTGW-firmware, 207 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Research Guide Updater?

huangwb8 (a GitHub user) maintains it in huangwb8/ChineseResearchLaTeX, which has 2,880 GitHub stars. The repository holds 27 skills in this directory. The repository was last updated on October 4, 2026.

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