Skip to content
Skills Library
DevOps & cloud · Tool integration

setup

/setup

Set up, repair or check the knowledge-base plugin backend (database, embedding model via Ollama, server binary), or move it from Postgres to SQLite. Use after installing the plugin, when the knowledge-base MCP server fails to connect, or when the user asks about the knowledge base installation.

Licence
MIT
Last repository change
10.11.2026

Assessment and security

92/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content27 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
1
Scripts
0
HTML comments
0
URLs in SKILL.md
0
Deprecation

No signals detected. Repository changed on 10.11.2026, without references to retired models or APIs.

Licence

MIT, open: use and modify while retaining author attribution.

What it does and when to use it

Set up, repair or check the knowledge-base plugin backend (database, embedding model via Ollama, server binary), or move it from Postgres to SQLite. Use after installing the plugin, when the knowledge-base MCP server fails to connect, or when the user asks about the knowledge base installation.

Arguments

/setup [--migrate-to-sqlite] [--database-url URL] [--postgres] [--embedding openai]
Original author description

Set up, repair or check the knowledge-base plugin backend (database, embedding model via Ollama, server binary), or move it from Postgres to SQLite. Use after installing the plugin, when the knowledge-base MCP server fails to connect, or when the user asks about the knowledge base installation.

How it works

SKILL.md has no level-two headings · 41 lines, 383 words

SKILL.md preview
---
name: setup
description: Set up, repair or check the knowledge-base plugin backend (database, embedding model via Ollama, server binary), or move it from Postgres to SQLite. Use after installing the plugin, when the knowledge-base MCP server fails to connect, or when the user asks about the knowledge base installation.
argument-hint: "[--migrate-to-sqlite] [--database-url URL] [--postgres] [--embedding openai]"
---

Set up the backend of the knowledge-base plugin. Run every command below exactly as written with the Bash tool:
the paths are filled in for this installation.

1. Check the current state:

   ```bash
   CLAUDE_PLUGIN_DATA="${CLAUDE_PLUGIN_DATA}" "${CLAUDE_PLUGIN_ROOT}/scripts/setup.sh" --status
   ```

2. Explain the result to the user in a few lines. Before going on, ask about what you cannot decide alone:
   - **Database**: by default the knowledge base is a SQLite file (`~/.local/share/knowledge-base/knowledge.db`);
     nothing to install. Alternatives, only if the user wants them: `--database-url postgres://...` (an existing
     Postgres with pgvector, e.g. a server shared by a team) or `--postgres` (a local Postgres in Docker).
     An existing configuration keeps its database.
   - **Postgres in Docker in use** (status shows the container): offer `--migrate-to-sqlite`. It copies everything
     (IDs, history) into the SQLite file, switches the configuration and stops the container; the Docker volume
     stays as a backup. Docker is then no longer needed. Use it only after the user agrees.
   - **Missing prerequisites**: Ollama (local embeddings); without it `--embedding openai` (needs
     `OPENAI_API_KEY` in the environment). Go is only needed if no release binary exists for this version or
     platform. The user installs them; do not install system software yourself.
   - **Pre-plugin installation found**: it runs alongside the plugin and would duplicate every hook and tool.
     Recommend `--remove-legacy` (it removes the old hooks, rules file and MCP registration and takes over
     the old configuration; the data stays). Use it only after the user agrees.
   - If `$ARGUMENTS` contains options, use them.

3. Run the setup with the agreed options (it is idempotent; the first build can take a minute):

   ```bash
   CLAUDE_PLUGIN_DATA="${CLAUDE_PLUGIN_DATA}" "${CLAUDE_PLUGIN_ROOT}/scripts/setup.sh" [options]
   ```

4. If it fails, read the message, fix what you can (e.g. start the setup again after the user started
   Docker or Ollama) and otherwise tell the user what is missing. If it succeeds, tell the user to run
   `/reload-plugins` (or restart Claude Code) so that the MCP server connects, and that the configuration
   lives in `~/.config/knowledge-base/config.env`. After `--migrate-to-sqlite` the reload is urgent (running
   sessions write into Postgres until then); pass on the script's hint about deleting the Docker volume later.

Never run `setup.sh --purge` unless the user explicitly asks to delete all knowledge: it deletes the SQLite file,
the Docker Postgres including its volume, and the configuration. Never delete the Docker volume yourself either.

Versions

RepositoryScoreLicence
This page · Bibob7/knowledge-base92MIT
HwangSlater/harness-fit100MIT
nesquikm/dev-process-toolkit100MIT
userKael/rastro100MIT
als-apg/osprey100BSD-3-Clause
dedujeong/gemba100Apache-2.0
eigenwise/eigenwise-toolshed100MIT
awrshift/agent-memory-kit100MIT
lifecycle-innovations-limited/claude-ops100MIT

Database snapshot: 13.11.2026 · package version 9e00d94c6a8e (SHA-256 digest of the entire package)

Downloads in the last 30 days: 0 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 100mcp-server-sqlite
    Use this skill when installing, configuring, and executing tools with the local SQLite file inspection and query execution SQLite MCP server.
  • 100knowledge-connect
    Manage knowledge integration via MCP, Vector DBs, and A2A connectors. Use when: Connect to knowledge base, Ingest documentation, Query vector database, Setup RAG pipeline, Index project files.
  • 90agentdb-setup-diagnostics
    Set up and diagnose the agentdb plugin and its MCP server — which profile and database are in use, whether the server is connected, what it holds, and why a tool is missing or refused. Use when AgentDB tools are missing, a call is refused, the user asks "is agentdb working", or…
  • 100kb-init
    Use when setting up a new knowledge base, bootstrapping an Obsidian vault, or when user says 'init kb', 'new knowledge base', 'create kb', or 'setup vault'. Triggers on any request to initialize or scaffold a knowledge base project.
  • 100unifi-network-setup
    Configure the UniFi Network MCP server for a supported MCP client — set controller host, credentials, and permissions. Also use when the unifi-network server failed to start or its tools are missing, especially right after a plugin update, because in Claude Code the plugin no…
  • 100unifi-access-setup
    Configure the UniFi Access MCP server for a supported MCP client — set controller host, credentials, API key, and permissions. Also use when the unifi-access server failed to start or its tools are missing, especially right after a plugin update, because in Claude Code the…

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.