Agent skill

Docs Maintenance

by ncatbot in ncatbot/NcatBot

维护 NcatBot 项目文档、示例、Skills 知识资产。编写/编辑文档、修复文档问题、文档结构规范审查。Use when: 写文档、改文档、新增文档、修复断链、修复索引、修复代码块标注、文档规范、文档模板、文档结构设计、docs maintenance。

Custom licenceAuto-check passed

Install Docs Maintenance

skills CLI
$ npx skills add ncatbot/NcatBot --skill docs-maintenance -a claude-code

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

GitHub CLI
$ gh skill install ncatbot/NcatBot docs-maintenance --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/ncatbot/NcatBot.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/docs-maintenance .claude/skills/docs-maintenance && 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
docs-maintenance
GitHub stars
116
Token cost
~722 tokens
SKILL.md length
193 words
Files
3 (incl. references)
Skills in repo
12
Repo updated
First seen
Licence
Custom licence

At a glance

维护 NcatBot 项目文档、示例、Skills 知识资产。编写/编辑文档、修复文档问题、文档结构规范审查。Use when: 写文档、改文档、新增文档、修复断链、修复索引、修复代码块标注、文档规范、文档模板、文档结构设计、docs maintenance。

  • : 写文档、改文档、新增文档、修复断链、修复索引、修复代码块标注、文档规范、文档模板、文档结构设计、docs maintenance
  • SKILL.md covers 随附脚本, 四位一体, 关键路径 and 文档编排逻辑, plus 2 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Docs Maintenance is an agent skill from ncatbot/NcatBot. 维护 NcatBot 项目文档、示例、Skills 知识资产。编写/编辑文档、修复文档问题、文档结构规范审查。Use when: 写文档、改文档、新增文档、修复断链、修复索引、修复代码块标注、文档规范、文档模板、文档结构设计、docs maintenance。

Its SKILL.md is about 720 tokens, which your agent loads only when the skill is triggered. The skill folder holds 3 other files, including reference files (for example `references/docs-maintenance.md` and `references/quality-spec.md`).

The repository describes itself as: NapCat Python SDK;快速开发你的 QQ 机器人.

When your agent uses it

  • : 写文档、改文档、新增文档、修复断链、修复索引、修复代码块标注、文档规范、文档模板、文档结构设计、docs maintenance

Example prompts

  • “/docs-maintenance”

What it can do on your machine

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

Docs Maintenance loads about 722 tokens when it runs, and up to ~2.7k if it reads all its reference files. Until then it costs about 37 tokens; SKILL.md has 193 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
~722
With references · SKILL.md plus every file in references/, read only if the agent opens them
~2.7k

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 193 words (~722 tokens).

“你是 NcatBot 文档与知识资产维护助手。确保 Code / Test / Docs / Skill 四位一体产物描述同一事实,不矛盾、不遗漏、不过时。”

— opening of SKILL.md by ncatbot, Custom licence
name
docs-maintenance

Read the full SKILL.md on GitHub

Files

SKILL.md and 2 other files (references) in .agents/skills/docs-maintenance of ncatbot/NcatBot.

  • SKILL.md
  • references/docs-maintenance.md
  • references/quality-spec.md

Open the folder on GitHubat commit c26300a

Compare with similar skills

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

Docs Maintenance compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Docs Maintenance this skillncatbot/NcatBot116—~722Automated safety check: PassCustom licence
Doc Maintenancepaperclipai/paperclip99k—~1.6kAutomated safety check: PassMIT
Doc Maintenancepaperclipai/paperclip99k—~1.1kAutomated safety check: PassMIT
MaintenanceChachamaru127/claude-code-harness3.2k1 repos~713Automated safety check: NotesMIT
Logseq CLI Maintenancelogseq/logseq45k—~1kAutomated safety check: PassAGPL-3.0
Maintenanceplatonai/Browser41.2k—~2.2kAutomated safety check: PassApache-2.0

Similar skills

  • Doc Maintenance

    paperclipai/paperclip

    Audit README, SPEC, and PRODUCT docs against recent git history for drift and make minimal PR-ready edits.

    99k GitHub stars~1.6k tokensUpdated today
    DevelopmentAuto-check passed
  • Doc Maintenance

    paperclipai/paperclip

    Keep project docs aligned with recent code and feature changes — detect drift, update affected pages, and add release-relevant notes without rewriting unchanged sections.

    99k GitHub stars~1.1k tokensUpdated today
    DevelopmentAuto-check passed
  • Maintenance

    Chachamaru127/claude-code-harness

    File cleanup and archiving. An agent skill from Chachamaru127/claude-code-harness.

    3.2k GitHub starsUsed in 1 repo~713 tokens
    Productivity & AutomationAuto-check: notes
  • Improve readability, consistency, and long-term maintainability of Logseq CLI-related code, command flows, and tests.

    45k GitHub stars~1k tokensUpdated today
    Knowledge ManagementAuto-check passed
  • Maintenance

    platonai/Browser4

    Orchestrates 30 check scripts across 9 categories (code, tests, docs, SKILLs, deps, infra).

    1.2k GitHub stars~2.2k tokensUpdated today
    DevelopmentAuto-check passed
  • Agent Setup Maintenance

    langfuse/langfuse

    Shared workflow for editing Langfuse's repo-owned agent setup under .agents/.

    36k GitHub stars~799 tokensUpdated today
    AI & LLM EngineeringAuto-check passed

More from ncatbot/NcatBot

All 12 skills in this repo
  • Code Nav

    ncatbot/NcatBot

    定位 NcatBot 代码实现:锁定模块目录、找到关键类/函数、追踪调用链。当文档不够时才读代码,用搜索而非遍历。Use when: 找代码实现、哪个文件、哪个类、追踪调用链、定位 bug 行号、代码在哪、模块目录、源码定位。

    116 GitHub stars~460 tokensUpdated 3 days ago
    Auto-check passed
  • Docs Sync

    ncatbot/NcatBot

    整体/局部防腐检查:Docs 内部链接断裂、README 索引不同步、guide↔reference 内容不一致、examples 导入过时、Code↔Docs API 对齐。逐文件检查,最大化并发 subagent。Use when: docs 防腐、docs 链接、docs 断链、断链检查、docs 审计、docs audit、code docs 对齐、reference 过时、guide…

    116 GitHub stars~1.3k tokensUpdated 3 days ago
    Auto-check passed
  • Framework Usage

    ncatbot/NcatBot

    使用 NcatBot 框架开发 QQ 机器人或跨平台 Bot。当用户需要快速体验、创建插件、注册事件处理、发送消息、调用 Bot API、使用 Mixin/Hook、使用 CLI 工具、编写插件测试、或调试运行问题时触发此技能。Use when: 开发…

    116 GitHub stars~1.2k tokensUpdated 3 days ago
    Auto-check passed
  • Plugin Migration

    ncatbot/NcatBot

    将 NcatBot 4.4/4.5 版本插件迁移到 5.0。包括导入路径、注册方式、Config/Data API、事件类型、消息构造的全面映射。Use when: 迁移插件、升级插件、4 转 5、老版本、旧版本、migration、upgrade、plugin migration、版本升级。

    116 GitHub stars~1.2k tokensUpdated 3 days ago
    Auto-check passed
  • Release

    ncatbot/NcatBot

    发布 NcatBot 新版本到 PyPI 和 GitHub Release,或仅编排 Commit 推送到 main。从工作区变更编排 commit 到最终发布的全链路流程。Use when: 发版、release、发布、changelog、版本号、pick commits、挑选提交、release notes、编排 commit、push、推送。

    116 GitHub stars~513 tokensUpdated 3 days ago
    Auto-check passed
  • Skills Sync

    ncatbot/NcatBot

    检查、报告、修复 Skills 间链接内容不同步,以及 Skills↔Docs 内容链接不同步。逐文件检查,最大化并发 subagent。Use when: skill 同步、skill 断链、skill 引用、skill 过时、skill audit、skills 一致性、skill 检查、skill↔docs。

    116 GitHub stars~694 tokensUpdated 3 days ago
    Auto-check passed

Questions about Docs Maintenance

What does Docs Maintenance do?

维护 NcatBot 项目文档、示例、Skills 知识资产。编写/编辑文档、修复文档问题、文档结构规范审查。Use when: 写文档、改文档、新增文档、修复断链、修复索引、修复代码块标注、文档规范、文档模板、文档结构设计、docs maintenance。. Docs Maintenance is an agent skill from ncatbot/NcatBot.

When should I use Docs Maintenance?

Docs Maintenance fits situations like: : 写文档、改文档、新增文档、修复断链、修复索引、修复代码块标注、文档规范、文档模板、文档结构设计、docs maintenance.

How do I install Docs Maintenance in Claude Code?

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

How do I install Docs Maintenance in Codex?

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

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

What does Docs Maintenance need to run?

SKILL.md names no scripts, command-line tools or credentials: Docs Maintenance is instructions for the agent only.

Does Docs Maintenance 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 Docs Maintenance 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 Docs Maintenance use?

Docs Maintenance 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 Docs Maintenance use?

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

What are the alternatives to Docs Maintenance?

Skills that share tags, products or a category with Docs Maintenance: Doc Maintenance (paperclipai/paperclip, 99k stars), Doc Maintenance (paperclipai/paperclip, 99k stars), Maintenance (Chachamaru127/claude-code-harness, 3.2k stars) and Logseq CLI Maintenance (logseq/logseq, 45k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Docs Maintenance?

ncatbot (a GitHub organization) maintains it in ncatbot/NcatBot, which has 116 GitHub stars. The repository holds 12 skills in this directory. The repository was last updated on October 4, 2026.

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