Knowledge Models

---
name: "knowledge-models"
description: "Covers MaxKB knowledge/RAG flows plus model-provider and
  local-model integration."
disable-model-invocation: true
metadata:
  disco-role: operating
license: GPL 3.0
---

# knowledge-models

Use this sub-skill for knowledge-base, vector-search, and model-provider tasks.

## Owns
- `apps/knowledge/*` knowledge/document/paragraph/problem/termbase surfaces.
- `apps/models_provider/*` provider abstraction, model CRUD, and credential handling.
- `apps/local_model/*` local model service endpoints.
- RAG search, embedding, reranker, and provider/local-model troubleshooting.

## Do not own
- Runtime bootstrap and service commands -> `runtime-architecture`.
- Workflow/chat/MCP execution -> `workflow-chat-mcp`.
- Vue/Vite UI contract -> `frontend-integration`.
- Management-only user/permission/tool/trigger pages -> `admin-access`.

## Key files
- `references/knowledge-and-models.md`
- `references/troubleshooting.md`
- `scripts/knowledge_model_surface.py`

## Guidance
- Treat retrieval and provider selection as one chain when diagnosing RAG issues.
- Make clear when a problem is in knowledge indexing versus model availability.
- Keep provider claims tied to the registered model catalog, not to assumptions about vendor SDKs.