name: private-knowledge-base description: Personal knowledge base for PDFs, papers, and documents with cross-document Q&A and concept retrieval. Use when: (1) User asks questions about stored documents ("which doc mentions X?"), (2) Need to summarize concepts across multiple PDFs, (3) User wants to ingest new PDFs/papers into knowledge base, (4) Cross-document linking and association is needed, (5) Fast semantic search over personal document collection. version: 1.0.0

Private Knowledge Base

Personal document storage and retrieval system for PDFs, papers, and research documents.

Quick Start

Ingest Documents

# Add PDF to knowledge base
./scripts/ingest.sh ~/path/to/document.pdf

# Process entire folder
./scripts/ingest-folder.sh ~/papers/

Query Knowledge Base

# Search for concept across all documents
./scripts/search.sh "transformer architecture"

# Get summary of concept from relevant docs
./scripts/summarize.sh "attention mechanism"

Core Workflows

1. Document Ingestion

When user provides new PDFs or papers:

1. Create document entry in kb/index.json
2. Extract text and metadata
3. Generate embeddings for semantic search
4. Store in kb/docs/ with normalized name

2. Cross-Document Q&A

When user asks "which document mentions X?" or "summarize X from my docs":

1. Search embeddings for relevant passages
2. Retrieve source documents

   7w4.net小蔥技能站，你的AI助手技能庫。

3. Synthesize answer across documents
4. Cite sources with document names and page numbers

3. Concept Linking

Build associations between documents: - Shared concepts - Citation relationships - Topic clusters

File Structure

private-knowledge-base/
├── SKILL.md
├── scripts/
│   ├── ingest.sh          # Single document ingestion
│   ├── ingest-folder.sh   # Batch ingestion
│   ├── search.sh          # Semantic search
│   └── summarize.sh       # Cross-document summary
├── references/
│   └── schema.md          # KB index schema
└── kb/                    # Created at runtime
    ├── index.json
    ├── embeddings/
    └── docs/

Usage Examples

User: "我之前存的文件裡，哪篇提到了 transformer?" → Run ./scripts/search.sh "transformer"

User: "總結一下我文件裡關於 attention 的內容" → Run ./scripts/summarize.sh "attention"

User: "把這篇 PDF 加到知識庫" → Run ./scripts/ingest.sh <pdf-path>

Configuration

Set knowledge base location:

export KB_ROOT=~/.openclaw/workspace/kb

Default: ~/kb if not set.

這個 Skill 整體質量中等偏上，文件和基礎框架做得不錯，但核心功能有所欠缺。它能幫你儲存和搜尋 PDF 文件，但搜尋結果可能不夠精準，偶爾會遺漏相關內容。總結功能比較基礎，只是把相關內容片段摘出來，沒有真正做智慧分析。如果你需要一個輕量級的文件管理工具可以用，但想要精準的語義搜尋和智慧的內容總結，目前還達不到預期效果。