knowledge-base-manager — скилл для Claude Code
Скилл knowledge-base-manager для Claude Code помогает выбрать архитектуру базы знаний и выстроить её поддержку. Охватывает отбор контента, контроль качества и версионирование.
MIT 131 установок ★ 29 обновлён 2026-08-17
npx skills add oakoss/agent-skills --skill knowledge-base-manager -a claude-codeЧто делает knowledge-base-manager
Скилл предлагает методику выбора архитектуры базы знаний по типам запросов: документная подходит для документов и FAQ, графовая — для связей между сущностями, гибридная объединяет оба подхода. Он охватывает аудит источников, отбор и очистку контента, метрики качества, версии и правила поддержки.
В рекомендациях есть проверка базы на реальных вопросах, отслеживание актуальности и фиксация источников знаний. Для retrieval-пайплайнов отдельно предназначен rag-implementer, а для проектирования графа знаний — knowledge-graph-builder. Гибридная архитектура сложнее, поэтому её стоит выбирать только под соответствующие запросы.
Какие задачи решает
- выбрать архитектуру базы знаний под типы запросов
- составить процесс отбора и очистки контента
- оценить качество базы на вопросах пользователей
- настроить версионирование и аудит изменений
- организовать контроль актуальности знаний
Примеры запросов агенту
- Выбери архитектуру базы знаний для документов, FAQ и запросов о связях между сущностями.
- Составь процесс отбора, очистки и проверки качества контента для базы знаний.
- Предложи правила версионирования и контроля актуальности знаний.
Как установить knowledge-base-manager
1Через Skills CLI (Vercel)
npx skills add oakoss/agent-skills --skill knowledge-base-manager -a claude-code2Вручную: положить файлы
~/.claude/skills/knowledge-base-manager/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/knowledge-base-manager/
1Через Skills CLI (Vercel)
npx skills add oakoss/agent-skills --skill knowledge-base-manager -a codex2Вручную: положить файлы
.agents/skills/knowledge-base-manager/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add oakoss/agent-skills --skill knowledge-base-manager -a cursor2Вручную: положить файлы
.cursor/skills/knowledge-base-manager/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install oakoss/agent-skills skills/knowledge-base-manager2Вручную: положить файлы
.github/skills/knowledge-base-manager/SKILL.md1Через Skills CLI (Vercel)
npx skills add oakoss/agent-skills --skill knowledge-base-manager -a gemini-cli2Командой платформы
gemini skills install https://github.com/oakoss/agent-skills --path skills/knowledge-base-managerВручную: положить файлы
.devin/skills/knowledge-base-manager/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add oakoss/agent-skills --skill knowledge-base-manager -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о knowledge-base-manager
Как установить knowledge-base-manager в Claude Code?
Выполните npx skills add oakoss/agent-skills --skill knowledge-base-manager -a claude-code. Файл скилла находится по пути ~/.claude/skills/knowledge-base-manager/SKILL.md.
Что делает knowledge-base-manager?
Помогает выбрать архитектуру базы знаний, организовать работу с контентом и определить подходы к проверке качества, версиям и поддержке.
Когда выбирать гибридную базу знаний?
Когда запросы требуют сочетать поиск по документам с обходом связей между сущностями. В скилле этот вариант отмечен как наиболее сложный.
Исходный текст
SKILL.md · MIT
--- name: knowledge-base-manager description: 'Knowledge base architecture selection, curation, and governance. Use when choosing between document-based (RAG), entity-based (graph), or hybrid KB architectures, establishing content curation workflows, implementing versioning and governance, or evaluating quality metrics. For building retrieval pipelines, use the rag-implementer skill. For building knowledge graphs, use the knowledge-graph-builder skill.' license: MIT metadata: author: oakoss version: '1.1' --- # Knowledge Base Manager ## Overview Provides a structured methodology for selecting, designing, and governing knowledge bases. Covers architecture decisions (document-based vs entity-based vs hybrid), content curation, quality metrics, versioning strategies, and maintenance governance. Use when choosing a KB architecture, establishing curation workflows, or building governance processes for organizational knowledge. **When NOT to use:** Static documentation suffices, fewer than 50 FAQ items cover all questions, or no maintenance resources are available. For implementing retrieval pipelines (chunking, embeddings, vector stores), use the `rag-implementer` skill. For implementing knowledge graphs (ontology, entity extraction, graph databases), use the `knowledge-graph-builder` skill. ## Quick Reference | Aspect | Options | Key Considerations | | ---------------------- | -------------------------------------------------- | ------------------------------------------------------------------ | | **Architecture** | Document-based (RAG), Entity-based (Graph), Hybrid | Match to query patterns; start simple, add complexity when needed | | **Document-based** | Vector DB (Pinecone, Weaviate, pgvector) | Best for docs, FAQs, manuals; semantic search; easy to add content | | **Entity-based** | Graph DB (Neo4j, ArangoDB) | Best for org charts, catalogs, networks; relationship traversal | | **Hybrid** | Both + linking layer | Enterprise, medical, legal; combined queries; highest complexity | | **When to skip KB** | Static docs, <50 FAQ items | No maintenance resources, information never changes | | **Implementation** | 6 phases | Audit, Curation, Storage, Quality, Versioning, Governance | | **Accuracy target** | >90% on test questions | Create 100+ test questions with known correct answers | | **Coverage target** | >80% questions answerable | Validate against real user queries continuously | | **Freshness target** | <30 days average age | Automated freshness monitoring + scheduled updates | | **Consistency target** | >95% conflict-free | Deduplication + single source of truth | | **Query latency** | <100ms median | Caching and optimization for common access patterns | | **Storage tech** | pgvector, Pinecone, Weaviate, Chroma | pgvector for existing Postgres; Pinecone for managed scale | | **Index types** | HNSW, IVFFlat | HNSW for recall; IVFFlat for frequently rebuilt indexes | | **Ingestion pipeline** | Load, clean, chunk, embed, store | Chunk at semantic boundaries; 512 tokens max; 10-15% overlap | | **Deduplication** | Content hashing, semantic similarity | Hash for exact dupes; cosine similarity >0.95 for semantic dupes | | **Quality testing** | Recall@K, MRR, accuracy sampling | 100+ test questions; measure recall@10 >0.8 and MRR >0.7 | | **Drift detection** | Embedding distribution monitoring | Track mean shift; alert when >0.1 threshold | | **Versioning** | Snapshot, Event-sourced, Git-style | Snapshot for simple; event-sourced for audit; git-style for teams | | **Maintenance** | Daily, Weekly, Monthly, Quarterly | Establish schedule from day 1; monitor errors and user feedback | ## Common Mistakes | Mistake | Correct Pattern | | ---------------------------------------------------------- | -------------------------------------------------------------------------------------- | | Ingesting raw data without curation or normalization | Curate, clean, and deduplicate before ingesting; quality over quantity | | Skipping version control for KB content | Implement versioning from day one with rollback and audit trail | | Building a KB without validating against user questions | Start with user research and test against real queries for >90% accuracy | | Choosing hybrid architecture when document-based suffices | Match architecture to actual query patterns; start simple, add complexity when needed | | Launching without freshness monitoring or update schedules | Set up automated freshness checks and scheduled content reviews | | No provenance tracking on knowledge entries | Always track source URL, timestamp, author, and confidence score | | Duplicate information across sources | Establish single source of truth; merge similar entries with conflict resolution rules | | Perfectionism delaying launch | Launch at 80% coverage and iterate based on real usage data | ## Delegation - **Audit existing knowledge sources and classify content types**: Use `Explore` agent to inventory documents, assess quality, and identify gaps - **Implement end-to-end KB pipeline with storage and retrieval**: Use `Task` agent to deploy database, configure search, and run quality checks - **Design KB architecture and governance model**: Use `Plan` agent to select between document-based, entity-based, or hybrid approaches > For implementing document retrieval pipelines (chunking, embeddings, vector stores, hybrid search), use the `rag-implementer` skill. For implementing knowledge graphs (ontology design, entity extraction, graph databases), use the `knowledge-graph-builder` skill. ## References - [Architecture and Types](references/architecture.md) -- KB types, decision framework, knowledge classification - [Curation and Ingestion](references/curation.md) -- extraction, cleaning, deduplication, provenance tracking - [Storage and Retrieval](references/storage.md) -- database selection, interfaces, technology stacks - [Quality Control](references/quality-control.md) -- metrics, validation strategies, continuous monitoring - [Versioning](references/versioning.md) -- snapshot, event-sourced, and git-style approaches - [Governance](references/governance.md) -- maintenance schedules, roles, change processes
© oakoss · MIT · oakoss/agent-skills