Agent skill

Docs Management

by 312362115 in 312362115/claude

项目知识库引擎:持续维护 docs/ 目录作为活的知识库. An agent skill from 312362115/claude.

MITAuto-check passedKnowledge Management

Install Docs Management

skills CLI
$ npx skills add 312362115/claude --skill docs-management -a claude-code

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

GitHub CLI
$ gh skill install 312362115/claude docs-management --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/312362115/claude.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/docs-management .claude/skills/docs-management && 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-management
GitHub stars
107
Token cost
~1.2k tokens
SKILL.md length
217 words
Files
1
Skills in repo
20
Repo updated
First seen
Licence
MIT

At a glance

项目知识库引擎:持续维护 docs/ 目录作为活的知识库. An agent skill from 312362115/claude.

  • Tasks that involve Technical writing
  • SKILL.md covers 三层架构, 四个核心操作 and 与其他 skill 的关系
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
  • Tasks that involve Task management

What it does

Docs Management is an agent skill from 312362115/claude. 项目知识库引擎:持续维护 docs/ 目录作为活的知识库。 灵感来源:Karpathy LLM Wiki — LLM 不只是写文档,而是持续维护知识库。 五个核心操作:Ingest(摄入新信息)、Query(检索知识)、Lint(健康检查)、Index(索引维护)、Synthesize(聚合全局视图)。 触发词:文档检查、清理文档、文档索引、docs 整理、知识库、文档过期了吗、架构文档、用户手册。 触发场景:task-manager 标 done 时自动触发 Ingest、定期 Lint 健检、用户查询项目历史、 task-finish 提醒后触发 Synthesize 更新 architecture/ 或 user-guide/。 即使用户没有说"文档管理",只要涉及 docs/ 目录的整理/检查/更新,都应触发此技能。

Its SKILL.md is about 1.2k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Knowledge Management, covering Technical writing, Task management and Linting and formatting. The licence is MIT.

When your agent uses it

  • Tasks that involve Technical writing
  • Tasks that involve Task management
  • Tasks that involve Linting and formatting

Example prompts

  • “/docs-management”

What it can do on your machine

Read from SKILL.md and the folder at commit 2d4fa49. 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 (its code samples are markdown).

    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 Management loads about 1.2k tokens when it runs. Until then it costs about 96 tokens; SKILL.md has 217 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~96
When it runs · the whole SKILL.md, loaded when a task matches
~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 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

The full file from 312362115/claude at commit 2d4fa49, republished under its MIT licence (© 312362115). 217 words, ~1,231 tokens.

Download SKILL.mdSave it as .claude/skills/docs-management/SKILL.md (or your agent's skills folder).
name
docs-management
description
项目知识库引擎:持续维护 docs/ 目录作为活的知识库。 灵感来源:Karpathy LLM Wiki — LLM 不只是写文档,而是持续维护知识库。 五个核心操作:Ingest(摄入新信息)、Query(检索知识)、Lint(健康检查)、Index(索引维护)、Synthesize(聚合全局视图)。 触发词:文档检查、清理文档、文档索引、docs 整理、知识库、文档过期了吗、架构文档、用户手册。 触发场景:task-manager 标 done 时自动触发 Ingest、定期 Lint 健检、用户查询项目历史、 task-finish 提醒后触发 Synthesize 更新 architecture/ 或 user-guide/。 即使用户没有说"文档管理",只要涉及 docs/ 目录的整理/检查/更新,都应触发此技能。
version
1.0.0
last_updated
2026-04-08
repository
https://github.com/312362115/claude

项目知识库引擎(Docs Management)

"维护知识库最累的不是阅读和思考,是记账——交叉引用、一致性维护。这正是 LLM 擅长的。" — Karpathy, LLM Wiki


三层架构

Raw Sources(原始素材)  →  代码、git log、会议记录、外部文档
Wiki(知识库)           →  docs/ 目录下所有结构化文档
Schema(规则)           →  CLAUDE.md 中的文档规范

四个核心操作

操作 1:Ingest(摄入)

新信息进来时,不只是新建文件,而是找到已有文档合并更新。

触发时机:

  • task-manager 标 done 时(复盘完成后自动触发)
  • 新的设计决策产生时
  • 外部信息需要整合到项目文档时

执行流程:

新信息产生
  │
  ├─ 搜索 docs/ 中是否有相关文档
  │   ├─ 有 → 更新已有文档,合并新信息
  │   └─ 无 → 创建新文档
  │
  ├─ 更新 docs/ 内相关交叉引用
  │
  └─ 更新 INDEX(如有)

示例:

  • task-finish 产出复盘 → 写入 docs/decisions/,同时检查对应的 spec 是否需要标注"方案已执行,实际偏差见 decisions/xxx"
  • 发现新的最佳实践 → 更新 docs/guides/ 相关指南
Ingest 中的 spec 偏差处理

spec 标 done 时必须反映最终实现,但不是所有偏差都需要同样的处理方式。

偏差判断
  │
  ├─ 细节偏差(字段名调整、参数变更、实现细节微调)?
  │   └─ 直接更新 spec 中的技术方案章节
  │
  ├─ 方案偏差(换了实现路径,但目标不变)?
  │   └─ 更新 spec 技术方案 + 在决策章节补注"实际执行偏差及原因"
  │
  └─ 方向偏差(目标或范围发生了变化)?
      └─ 写 decision 记录完整复盘,spec 中标注"已被 decisions/xxx 覆盖"
操作 2:Query(查询)

docs/ 是项目的可查询知识库,不是文件堆。

触发时机:

  • 用户问"这个模块之前怎么设计的?"
  • 用户问"上次类似问题怎么解的?"
  • task-start 对焦阶段检索历史经验

执行流程:

查询请求
  │
  ├─ 在 docs/ 中搜索相关文档
  │   ├─ specs/ — 设计方案
  │   ├─ decisions/ — 踩坑记录和经验
  │   ├─ plans/ — 历史开发计划
  │   ├─ tests/ — 测试用例
  │   └─ guides/ — 开发指南
  │
  ├─ 综合相关文档给出回答
  │
  └─ 如果回答有价值且不在现有文档中 → Ingest 回 wiki
操作 3:Lint(健康检查)

定期体检,防止文档腐烂。

触发时机:

  • 用户主动要求检查
  • 大批量代码改动后
  • 定期维护

检查清单:

#检查项怎么查问题示例
1引用有效性文档中引用的文件路径是否存在spec 引用了已删除的文件
2进度一致性plan 的 checklist 和实际代码是否一致plan 说"待做"但代码已完成
3INDEX 同步INDEX.md 和实际文件是否对得上INDEX 有但文件已删
4跨文档一致plan 引用的 spec 是否存在plan 指向不存在的 spec
5状态同步backlog 状态和实际进度是否匹配backlog open 但 plan 已全部完成
6孤立文档有没有不被任何 INDEX 或文档引用的文件遗忘的旧 spec
7过期内容文档描述的代码结构是否还存在spec 说"改 src/old.ts"但该文件已重命名
8全局视图同步architecture/ 和 user-guide/ 的 INDEX 和实际子文档是否一致INDEX 列了但文件不存在、新模块有 spec 但 architecture/ 没收录
9记忆巡检memory 中的条目是否仍然有效feedback 引用的模块已删除、project 信息已过期

输出格式:

markdown
## Docs 健康检查报告 — YYYY-MM-DD

### 概况
- 扫描目录:docs/
- 文档总数:X 个
- 发现问题:X 个

### 问题清单

| # | 级别 | 文件 | 问题 | 建议 |
|---|------|------|------|------|
| 1 | 高 | plans/xxx.md | 引用的 spec 不存在 | 更新引用或补建 spec |
| 2 | 中 | specs/xxx.md | 引用的文件路径 src/old.ts 已不存在 | 更新路径 |
| 3 | 低 | backlog/xxx.md | 状态 open 但关联 plan 已全部完成 | 更新为 done |
操作 4:Index(索引维护)

索引是知识库的入口,必须和实际内容同步。

维护对象:

  • docs/backlog/INDEX.md — 需求索引(已有,由 task-manager 维护)
  • docs/decisions/INDEX.md — 经验索引(待建,按时间倒序)

INDEX 更新时机:

  • 新建文档后
  • 文档状态变更后
  • Lint 发现不一致后

操作 5:Synthesize(聚合)

从碎片文档中维护全局视图索引。不是写长文档,是保持索引准确。

维护对象:

目录INDEX.md 的职责子文档
docs/architecture/模块列表、模块间关系、核心数据流概览每个模块一份架构文档
docs/user-guide/功能目录、快速入门导航每个功能/模块一份用户指南

触发时机:

触发场景操作token 成本
用户手动要求全量:读所有相关 spec/decision,重建 INDEX高
task-finish 提醒后用户确认增量:只读本次变更涉及的模块,更新对应子文档和 INDEX低
Lint 发现 INDEX 和实际文件不一致修复:对齐 INDEX 和实际文件列表极低

执行流程:

触发 Synthesize
  │
  ├─ 全量模式(首次生成 / 用户要求重建)
  │   ├─ 扫描 docs/specs/ 和 docs/decisions/ 提取模块列表
  │   ├─ 每个模块生成/更新 architecture/<模块名>.md
  │   ├─ 生成 architecture/INDEX.md(模块导航 + 关系概览)
  │   └─ user-guide 同理
  │
  └─ 增量模式(单次改动后)
      ├─ 只读本次涉及的 spec/decision
      ├─ 判断是否涉及新模块 / 模块间关系变更
      │   ├─ 是 → 更新对应子文档 + INDEX
      │   └─ 否 → 跳过
      └─ 完成

INDEX.md 格式示例:

markdown
# 系统架构

## 模块概览
| 模块 | 职责 | 文档 |
|------|------|------|
| auth | 认证与会话管理 | [auth.md](auth.md) |
| payment | 支付与账单 | [payment.md](payment.md) |

## 模块间关系
- auth → payment:支付前需要认证
- ...(或引用 docs/assets/ 中的架构图)

和 Ingest 的区别:

  • Ingest:一条新信息 → 归档到一个文档(一对一)
  • Synthesize:多个文档 → 聚合成索引和全局视图(多对一)

与其他 skill 的关系

task-finish(复盘产出)→ docs-management.Ingest(整合到知识库)
task-finish(提交时)  → 提醒:是否需要 Synthesize(涉及新模块/模块间交互变更?)
task-start(对焦阶段)→ docs-management.Query(检索历史经验)
task-manager(需求管理)→ docs-management.Index(维护 backlog INDEX)

定期 / 用户主动 → docs-management.Lint(健康检查)
用户主动 / Lint 发现不一致 → docs-management.Synthesize(聚合全局视图)

docs-management vs writing:

  • writing:生产文档(从无到有写出来)
  • docs-management:维护文档(确保已有文档保持健康和可用)

docs-management vs task-manager:

  • task-manager:专门管 backlog(需求的收集/排序/清理)
  • docs-management:管整个 docs/ 目录(包括 backlog 之外的 specs/plans/decisions/等)

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

Files

Just SKILL.md in skills/docs-management of 312362115/claude.

Open the folder on GitHubat commit 2d4fa49

Compare with similar skills

Docs Management 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 Management compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Docs Management this skill312362115/claude107—~1.2kAutomated safety check: PassMIT
LLM Wikilewislulu/llm-wiki-skill655—~3.7kAutomated safety check: PassNone
Kbcompozy/kb110—~4.2kAutomated safety check: PassMIT
LLM WikiCharlesHoskinson/sevenlayer116—~1.5kAutomated safety check: PassCustom licence
Knowledge Base Health Lintjason-effi-lab/karpathy-llm-wiki-vault720—~336Automated safety check: PassNone
Lintjackwener/llm-wiki104—~450Automated safety check: PassApache-2.0

Similar skills

  • LLM Wiki

    lewislulu/llm-wiki-skill

    Build and maintain a Karpathy-style LLM knowledge base — a self-compiling Obsidian markdown wiki where an Agent ingests raw sources, compiles cross-linked concept/entity/summary pages, answers…

    655 GitHub stars~3.7k tokensUpdated 5 mo ago
    Knowledge ManagementAuto-check passed
  • Kb

    compozy/kb

    Operate the kb CLI to build and maintain topic-based Karpathy-style knowledge bases: gated ingestion, decision-model classification, linking, retrieval and review, wiki compilation, lint-and-heal…

    110 GitHub stars~4.2k tokensUpdated 13 days ago
    Knowledge ManagementAuto-check passed
  • LLM Wiki

    CharlesHoskinson/sevenlayer

    Builds and maintains a persistent, interlinked Obsidian-compatible markdown knowledge wiki in a git repo via three operations — ingest a source into linked pages, answer a question from the…

    116 GitHub stars~1.5k tokensUpdated 1 mo ago
    Knowledge ManagementAuto-check passed
  • Knowledge Base Health Lint

    jason-effi-lab/karpathy-llm-wiki-vault

    Scans an Obsidian-style wiki for broken double-link references, orphan pages, files missing from the index and unresolved knowledge conflicts, then reports the findings.

    720 GitHub stars~336 tokensUpdated 5 mo ago
    Knowledge ManagementAuto-check passed
  • Lint

    jackwener/llm-wiki

    Audit and safely maintain an LLM Wiki vault. An agent skill from jackwener/llm-wiki.

    104 GitHub stars~450 tokensUpdated 3 mo ago
    Knowledge ManagementAuto-check passed
  • Wiki All

    Pratiyush/llm-wiki

    Run the complete llmwiki pipeline from scratch — init, sync, graph, build, lint, and serve.

    397 GitHub stars~587 tokensUpdated 3 mo ago
    Knowledge ManagementAuto-check passed

More from 312362115/claude

All 20 skills in this repo
  • Diagram

    312362115/claude

    专业图表生成技能:根据需求自动选择合适的图表类型,生成符合设计规范的 PNG 图表. An agent skill from 312362115/claude.

    107 GitHub stars~2.7k tokensUpdated 4 mo ago
    Auto-check passed
  • Deep Research

    312362115/claude

    深度调研技能:对任意命题进行系统性调研并输出专业研究报告. An agent skill from 312362115/claude.

    107 GitHub stars~6.6k tokensUpdated 4 mo ago
    Auto-check passed
  • Preview Md

    312362115/claude

    MD 文件浏览器预览:GitHub 风格渲染 + 左侧自动目录. An agent skill from 312362115/claude.

    107 GitHub stars~636 tokensUpdated 4 mo ago
    Auto-check passed
  • Writing

    312362115/claude

    通用写作技能:以"内容→组件→组合"的方式产出技术文档、产品文档、汇报材料. An agent skill from 312362115/claude.

    107 GitHub stars~1.6k tokensUpdated 4 mo ago
    Auto-check passed
  • Code Walkthrough

    312362115/claude

    代码导读技能:帮助快速理解不熟悉的项目或模块,建立心智模型. An agent skill from 312362115/claude.

    107 GitHub stars~1k tokensUpdated 4 mo ago
    Auto-check: notes
  • DB Review

    312362115/claude

    数据库代码审查 + Migration 安全检查. An agent skill from 312362115/claude.

    107 GitHub stars~1.8k tokensUpdated 4 mo ago
    Auto-check passed

Questions about Docs Management

What does Docs Management do?

项目知识库引擎:持续维护 docs/ 目录作为活的知识库. An agent skill from 312362115/claude. Docs Management is an agent skill from 312362115/claude.

When should I use Docs Management?

Docs Management fits situations like: tasks that involve Technical writing; tasks that involve Task management; tasks that involve Linting and formatting.

How do I install Docs Management in Claude Code?

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

How do I install Docs Management in Codex?

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

Can I use Docs Management 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 312362115/claude --skill docs-management -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-management, .gemini/skills/docs-management, .github/skills/docs-management and .opencode/skills/docs-management in your project.

What does Docs Management need to run?

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

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

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

About 1.2k tokens (SKILL.md is roughly 4.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 Docs Management?

Skills that share tags, products or a category with Docs Management: LLM Wiki (lewislulu/llm-wiki-skill, 655 stars), Kb (compozy/kb, 110 stars), LLM Wiki (CharlesHoskinson/sevenlayer, 116 stars) and Knowledge Base Health Lint (jason-effi-lab/karpathy-llm-wiki-vault, 720 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Docs Management?

312362115 (a GitHub user) maintains it in 312362115/claude, which has 107 GitHub stars. The repository holds 20 skills in this directory. The repository was last updated on May 14, 2026.

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