knowledge-base-manager

Codex Skill for maintaining structured knowledge bases, living documents, and personal knowledge systems.

knowledge-base-manager helps turn scattered notes, excerpts, documents, meeting notes, and research materials into a cleaner knowledge base. It is designed for ongoing knowledge management, not one-time summarization.

Skills

Skill	What It Does	Best For
knowledge-system-curator	Merges new materials into an existing knowledge base, removes duplication, improves structure, and preserves important source wording.	Personal knowledge bases, book notes, research systems, Feishu/Lark docs, Markdown documents

Why This Exists

Knowledge bases become hard to maintain when new information keeps arriving, similar notes repeat across documents, and useful source wording gets compressed away.

This repository packages a reusable Codex workflow for keeping a knowledge base organized over time.

What It Does

• Reads the existing knowledge system before changing it.
• Breaks new material into knowledge units.
• Classifies whether each unit supplements, duplicates, conflicts with, or restructures the existing system.
• Proposes a diagnosis and execution plan before complex edits.
• Integrates content without adding outside material unless explicitly requested.
• Validates coverage, deduplication, structure, source boundaries, and formatting after editing.

Quick Start

Clone the repository:

git clone https://github.com/linhai0603/knowledge-base-manager.git

Copy the skill into your local Codex skills directory:

mkdir -p ~/.codex/skills
cp -R knowledge-base-manager/knowledge-system-curator ~/.codex/skills/

Restart Codex or open a new Codex session so the skill can be discovered.

Examples

Chinese knowledge-base update:

用 $knowledge-system-curator 把这些新增内容整合进这个知识库文档。
目标文档：...
新增资料：...
要求：只基于我提供的资料，不新增外部内容；如果需要调整目录，先给我计划，确认后再执行。

English knowledge-base update:

Use $knowledge-system-curator to update this knowledge base.
Target document: ...
New sources: ...
Requirements:
1. Use only the materials I provide.
2. Deduplicate overlapping content.
3. Preserve important original wording.
4. Decide whether the outline should change before editing.
5. Give me a plan first, then wait for confirmation.

Demo

See the demo workflow:

• Input notes
• Curator workflow
• Integrated output

The demo uses reading notes as sample source material. The skill itself is domain-neutral and can support research systems, operating manuals, product knowledge bases, and Feishu/Lark docs.

Repository Structure

knowledge-base-manager/
  README.md
  LICENSE
  .gitignore
  .github/
    CHANGELOG.md
    CONTRIBUTING.md
    docs/
      github-metadata.md
      repository-layout.md
      repository-settings.md
    scripts/
      pre-publish-review.sh
      check-sensitive-files.sh
      check-skill-structure.sh
      check-repo-package.sh
      verify-readme-links.sh
  knowledge-system-curator/
    README.md
    SKILL.md
    docs/
    examples/
    agents/

Requirements

• Codex with local skill support.
• Git for cloning this repository.
• No API key or private service login is required by default.

Limitations

• The skill does not add outside knowledge unless explicitly requested.
• It depends on the quality and completeness of the source material supplied by the user.
• Live document updates require the relevant document tools and permissions.
• It is a knowledge-management workflow, not a replacement for expert review in legal, medical, financial, or other high-stakes contexts.

Security & Privacy

• Do not paste credentials, API keys, account numbers, private customer data, or sensitive internal documents unless the task explicitly requires it and you are allowed to share them with Codex.
• Prefer redacted or summarized examples when working with private materials.
• Public examples are intentionally non-confidential.

Contributing

See .github/CONTRIBUTING.md.

Release Notes

See .github/CHANGELOG.md.

License

This repository is released under the GPL-3.0 license.