setup

setup is a skill for Claude Code from nicholasglazer/gnosis-mcp. It costs 30 tokens per session (1,755 once invoked), scanned A, original, MIT.

A setup wizard for Gnosis MCP, a tool that lets an AI assistant search your own documents. It installs the software, prepares its database, imports a folder, and connects it to an editor.

In plain words
What is it for?
Installing Gnosis MCP, importing documents, choosing search and database options, and connecting the document search to an editor.
Why use it?
It removes the manual setup work needed before an assistant can search local documentation.

Skill for Claude Code

Written for Claude Code: $ARGUMENTS substitution. Also seen: reads .claude/ paths; mentions Claude Code; built for cline.

Part of the gnosis plugin — 8 skills, 5 agents, 1 hook, 1 MCP server shipped together

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add skills/nicholasglazer/gnosis-mcp/setup
Any agent
npx skills add nicholasglazer/gnosis-mcp --skill setup
Clone the repo
git clone --depth 1 https://github.com/nicholasglazer/gnosis-mcp

Made for: Claude Code.

Or install gnosis, the plugin that ships this one along with the rest of its 8 skills, 5 agents, 1 hook, 1 MCP server.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for setup

README.md
[![agentmods](https://agentmods.dev/badge/skills/nicholasglazer/gnosis-mcp/setup.svg)](https://agentmods.dev/skills/nicholasglazer/gnosis-mcp/setup)
Your own site
<a href="https://agentmods.dev/skills/nicholasglazer/gnosis-mcp/setup"><img src="https://agentmods.dev/badge/skills/nicholasglazer/gnosis-mcp/setup.svg" alt="Measured on agentmods" height="20"></a>
Per session 30 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 1,755 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 1 finding. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00030 $0.01755
Opus 5 $0.00015 $0.00877
Sonnet 5 $0.00006 $0.00351
Haiku 4.5 $0.00003 $0.00176

Measured 6d ago against content hash ab3ffa43d28f, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-06, from the pricing page.

Security

Grade A, and why

setup scanned grade A with 1 finding against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 6d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Makes network callslowCapability

Not a fault in itself. Listed so you know the mod talks to something, and to what.

Then: `curl http://127.0.0.1:8000/api/search?q=auth&limit=5`.
skills/setup/SKILL.md · 277 lines

How it starts

The opening of the file, as written. The whole thing — 277 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Setup

Gets you from nothing to "agent searching my docs" in 60 seconds.

Usage

/gnosis:setup                      # Interactive — asks where your docs live
/gnosis:setup /path/to/docs        # Same, but ingest that folder right away
/gnosis:setup --postgres           # Print PostgreSQL setup instructions too

Target: $ARGUMENTS


Step 1 — Install

Pick the extras you need. They're additive.

pip install gnosis-mcp                        # core (SQLite, keyword search)
pip install 'gnosis-mcp[embeddings]'          # + local ONNX embeddings (hybrid search)
pip install 'gnosis-mcp[web]'                 # + web crawler (sitemap / BFS)
pip install 'gnosis-mcp[postgres]'            # + PostgreSQL backend
pip install 'gnosis-mcp[rst,pdf]'             # + .rst and .pdf file ingestion
pip install 'gnosis-mcp[reranking]'           # + cross-encoder reranker
                                              #   (OFF by default; tune before turning on —
                                              #    the bundled MS-MARCO model can HURT
                                              #    dev-doc retrieval by ~27 nDCG@10)

Full stack in one shot:

pip install 'gnosis-mcp[embeddings,web,postgres,rst,pdf]'

Verify:

gnosis-mcp --version     # should print the semver (≥ 0.10.13)

Step 2 — Pick a backend (usually SQLite)

SQLite (default): zero config. Database auto-creates at ~/.local/share/gnosis-mcp/docs.db. Great up to ~100 k chunks.

PostgreSQL: use when you have multiple concurrent writers, need a shared index across machines, or corpus > 100 k chunks.

# Postgres (only if you need it)
export GNOSIS_MCP_DATABASE_URL="postgresql://user:pass@localhost:5432/mydb"

Check that pgvector is available on the server:

psql "$GNOSIS_MCP_DATABASE_URL" -c "CREATE EXTENSION IF NOT EXISTS vector;"

Step 3 — Initialise the database

Idempotent. Safe to run any time.

gnosis-mcp init-db

Read the full file on GitHub · 277 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 6d ago First seen · 277 lines · 30 tokens per session scan A ab3ffa43d28f

Subscribe to this mod's changes

setup is a skill published in the GitHub repository nicholasglazer/gnosis-mcp (29 stars, last pushed 16d ago), licensed MIT. It adds 30 tokens to every session and 1,755 once invoked, about $0.0002 per session on Opus 5. A static security scan graded it A with 1 finding (makes network calls). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

Other skills, from other repositories

accreta-setup

Set up an accreta knowledge base over a corpus — pick a preset, write the config and a source declaration, generate the constitution, wire up MCP, and verify the first ingest. Use when someone wants an agent-maintained knowledge base with provenance and drift detection over a codebase, a document collection, or a…

francescofioredev/accreta · 100 tokens

karpathy-llm-wiki

Use when building or maintaining a personal LLM-powered knowledge base. Triggers: ingesting sources into a wiki, querying wiki knowledge, linting wiki quality, 'add to wiki', 'what do I know about', or any mention of 'LLM wiki' or 'Karpathy wiki'.

Astro-Han/karpathy-llm-wiki · 67 tokens

neurolink-guide

Guide for using the NeuroLink SDK and CLI. Invoke when users ask how to use neurolink, integrate AI providers, add MCP tools, configure RAG, set up memory, deploy servers, or work with multimodal content. Covers SDK, CLI, providers, tools, and enterprise features.

juspay/neurolink · 65 tokens

memobase

База знаний по документам — загрузка источников, ответы с цитатами, честный отказ.

maximskorohod/memobase · 25 tokens

mistake-analyzer

Analyze incorrect answers from text, documents, or images; identify root causes of mistakes; classify error types; explain correct reasoning; and generate targeted improvement suggestions, wrong-question notebook entries, or similar practice questions. Use when the user provides a wrong answer, asks why they were…

mingchen666/Reviva · 72 tokens

learning-visualization-skill

Generate single-file HTML visual explanations for learning and review. Use this skill when the user wants concept maps, process diagrams, principle demos, comparison diagrams, timelines, AI/ML model visualizations, or animated teaching pages that make a topic easier to understand,复习, or present.

mingchen666/Reviva · 64 tokens