Agent skill

Setup Open Index

Install and configure Open Index as the read/write context layer for a domain-specialized agent.

Install Setup Open Index

skills CLI

$ npx skills add DrDroidLab/open-index --skill setup-open-index -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI

$ gh skill install DrDroidLab/open-index setup-open-index --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy

$ git clone --depth 1 https://github.com/DrDroidLab/open-index.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/setup-open-index .claude/skills/setup-open-index && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Paste into Claude Code

Install the "setup-open-index" agent skill from https://github.com/DrDroidLab/open-index/tree/main/skills/setup-open-index into .claude/skills/setup-open-index/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "setup-open-index", then confirm the skill loads.

Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

$skill-installer

$skill-installer install https://github.com/DrDroidLab/open-index/tree/main/skills/setup-open-index

Type this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.

skills CLI

$ npx skills add DrDroidLab/open-index --skill setup-open-index -a codex

Project install goes to .agents/skills/; add -g for ~/.codex/skills/.

GitHub CLI

$ gh skill install DrDroidLab/open-index setup-open-index --agent codex

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/DrDroidLab/open-index.git skills-src && mkdir -p .agents/skills && cp -r skills-src/skills/setup-open-index .agents/skills/setup-open-index && rm -rf skills-src

Use ~/.agents/skills/ instead of .agents/skills for a personal install.

Codex skills documentation · loads skills from .agents/skills/

Paste into Codex

Install the "setup-open-index" agent skill from https://github.com/DrDroidLab/open-index/tree/main/skills/setup-open-index into .agents/skills/setup-open-index/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "setup-open-index", then confirm the skill loads.

Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add DrDroidLab/open-index --skill setup-open-index -a cursor

Project install goes to .agents/skills/; add -g for ~/.cursor/skills/.

GitHub CLI

$ gh skill install DrDroidLab/open-index setup-open-index --agent cursor

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/DrDroidLab/open-index.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/skills/setup-open-index .cursor/skills/setup-open-index && rm -rf skills-src

Use ~/.cursor/skills/ instead of .cursor/skills for a personal install.

Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/

Paste into Cursor

Install the "setup-open-index" agent skill from https://github.com/DrDroidLab/open-index/tree/main/skills/setup-open-index into .cursor/skills/setup-open-index/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "setup-open-index", then confirm the skill loads.

Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

gemini skills install

$ gemini skills install https://github.com/DrDroidLab/open-index.git --path skills/setup-open-index

--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.

skills CLI

$ npx skills add DrDroidLab/open-index --skill setup-open-index -a gemini-cli

Project install goes to .agents/skills/; add -g for ~/.gemini/skills/.

GitHub CLI

$ gh skill install DrDroidLab/open-index setup-open-index --agent gemini-cli

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/DrDroidLab/open-index.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/skills/setup-open-index .gemini/skills/setup-open-index && rm -rf skills-src

Use ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.

Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/

Paste into Gemini CLI

Install the "setup-open-index" agent skill from https://github.com/DrDroidLab/open-index/tree/main/skills/setup-open-index into .gemini/skills/setup-open-index/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "setup-open-index", then confirm the skill loads.

Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

GitHub CLI

$ gh skill install DrDroidLab/open-index setup-open-index

Installs for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).

skills CLI

$ npx skills add DrDroidLab/open-index --skill setup-open-index -a github-copilot

Project install goes to .agents/skills/; add -g for ~/.copilot/skills/.

Manual copy

$ git clone --depth 1 https://github.com/DrDroidLab/open-index.git skills-src && mkdir -p .github/skills && cp -r skills-src/skills/setup-open-index .github/skills/setup-open-index && rm -rf skills-src

Use ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.

GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/

Paste into GitHub Copilot

Install the "setup-open-index" agent skill from https://github.com/DrDroidLab/open-index/tree/main/skills/setup-open-index into .github/skills/setup-open-index/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "setup-open-index", then confirm the skill loads.

GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add DrDroidLab/open-index --skill setup-open-index -a opencode

OpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.

GitHub CLI

$ gh skill install DrDroidLab/open-index setup-open-index --agent opencode

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/DrDroidLab/open-index.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/skills/setup-open-index .opencode/skills/setup-open-index && rm -rf skills-src

Use ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.

OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/

Paste into OpenCode

Install the "setup-open-index" agent skill from https://github.com/DrDroidLab/open-index/tree/main/skills/setup-open-index into .opencode/skills/setup-open-index/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "setup-open-index", then confirm the skill loads.

OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

Facts

Skill name: setup-open-index
GitHub stars: 112
Token cost: ~855 tokens
SKILL.md length: 390 words
Files: 1
Skills in repo: 1
Repo updated: Aug 12, 2026
First seen: Oct 7, 2026
Licence: MIT

At a glance

Install and configure Open Index as the read/write context layer for a domain-specialized agent.

Works in 5 steps: Install → Initialize the domain brain → Connect the MCP server → …
Setting up a legal
SKILL.md covers 1. Install, 2. Initialize the domain brain, 3. Connect the MCP server and 4. Verify the agent connection, plus 2 more sections
Calls python and pip

What it does

Setup Open Index is an agent skill from DrDroidLab/open-index. Install and configure Open Index as the read/write context layer for a domain-specialized agent. Use when setting up a legal, marketing, customer support, sales, infrastructure, or other domain agent with Open Index over MCP.

Its SKILL.md is about 860 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Agent Workflows, covering Customer support, MCP servers and Agent memory. It works with Model Context Protocol. The repository describes itself as: Deterministic memory layer for your agents. The licence is MIT.

When your agent uses it

Setting up a legal
Customer support
Other domain agent with Open Index over MCP

Example prompts

“/setup-open-index”

Requirements

Python 3

Workflow steps

5 steps, taken from the step headings in SKILL.md.

Install
Initialize the domain brain
Connect the MCP server
Verify the agent connection
Production setup

What it can do on your machine

Read from SKILL.md and the folder at commit 8e7ffad. It shows what the files ask for, not the result of running them.

Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
Shell commands in SKILL.md call:
- python
- pip
From the folder's file list and the shell code blocks in SKILL.md.
Network
No URLs in SKILL.md. Its commands use pip, which can reach the network depending on how they are called.
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Setup Open Index loads about 855 tokens when it runs. Until then it costs about 61 tokens; SKILL.md has 390 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it: ~61
When it runs · the whole SKILL.md, loaded when a task matches: ~855

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from DrDroidLab/open-index at commit 8e7ffad, republished under its MIT licence (© DrDroidLab). 390 words, ~855 tokens.

Download SKILL.mdSave it as .claude/skills/setup-open-index/SKILL.md (or your agent's skills folder).

name: setup-open-index
description: Install and configure Open Index as the read/write context layer for a domain-specialized agent. Use when setting up a legal, marketing, customer support, sales, infrastructure, or other domain agent with Open Index over MCP.

Set up Open Index for a domain agent

Open Index gives a domain-specialized agent structured context it can search, traverse, and maintain. It is read/write by default; use --read-only only when the agent must never update domain knowledge.

1. Install

From a local checkout:

bash

python -m venv .venv
. .venv/bin/activate
pip install -e '.[mcp]'

If Open Index is published as a package, install the equivalent open-index[mcp] release instead. Never invent or hardcode credentials during setup.

2. Initialize the domain brain

Choose a short directory name and describe the actual domain in brain.yaml:

bash

open-index init <brain-name>
cd <brain-name>
open-index validate
open-index index

Replace the example note schema with concepts meaningful to the domain. For example, a legal agent might model matters, clauses, obligations, and precedents; a support agent might model products, issues, customer segments, and resolutions.

3. Connect the MCP server

Configure the agent runtime to launch this command from the brain directory:

bash

open-index mcp --brain /absolute/path/to/<brain-name>

Generic MCP configuration shape:

json

{
  "mcpServers": {
    "open-index": {
      "command": "open-index",
      "args": ["mcp", "--brain", "/absolute/path/to/<brain-name>"]
    }
  }
}

Adapt the location of this configuration to the selected client. Claude Code's optional adapter is .mcp.json; OpenClaw and Hermes may install this SKILL.md in their own skills directory while their MCP connection is configured according to that runtime's current documentation.

For retrieval-only access, append --read-only. Do not add it by default.

Show full SKILL.md (202 more words)Show less

4. Verify the agent connection

Confirm the connected server exposes these default tools:

navigation_guidelines
search_brain
get_entity
put_entity
create_doc_type

The MCP host should inject the server's dynamic domain-context instructions into the agent prompt. navigation_guidelines() is a refresh/fallback for hosts that do not support server instructions or after the schema/index changes.

Run a safe smoke test using synthetic content:

Search the brain and confirm the welcome entity is returned.
Create a synthetic entity that matches an existing doc type.
Fetch it by ID and verify its fields.
Remove it if the setup should remain clean.

In read-only mode, verify put_entity and create_doc_type are absent.

5. Production setup

Use open-index serve for a remote MCP endpoint and configure authentication. Use the OpenSearch backend for shared or multi-writer deployments. Keep secrets in environment variables, never in brain.yaml, skill files, examples, or logs.

Guardrails

Treat the brain's domain context according to its sensitivity and access policy.
Do not put credentials, private keys, tokens, or unrelated personal data in it.
Reuse existing doc types and relationship meanings before creating new ones.
Run open-index validate after changing file-backed schemas or entities.
Do not claim setup is complete until tool discovery and a synthetic query pass.

Files

Just SKILL.md in skills/setup-open-index of DrDroidLab/open-index.

Open the folder on GitHubat commit 8e7ffad

Compare with similar skills

Setup Open Index next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Setup Open Index compared with similar skills
Skill	Stars	Used in	Tokens	Auto-check	Licence	Repo updated
Setup Open Index this skillDrDroidLab/open-index	112	—	~855	Automated safety check: Pass	MIT	1 mo ago
MemPalace Setup and OperationMemPalace/mempalace	59k	—	~2.2k	Automated safety check: Pass	MIT	today
agentmemory Setup and Diagnosticsrohitg00/agentmemory	29k	—	~1k	Automated safety check: Notes	Apache-2.0	yesterday
Qmdbreferrari/obsidian-mind	4.9k	—	~1.7k	Automated safety check: Pass	MIT	yesterday
Memori MCP Memory UsageMemoriLabs/Memori	17k	—	~3.8k	Automated safety check: Pass	MIT	5 days ago
Shared Agent Knowledge Commonsmozilla-ai/cq	1.3k	—	~6.5k	Automated safety check: Pass	Apache-2.0	yesterday

Similar skills

MemPalace Setup and Operation
MemPalace/mempalace
Installs and configures MemPalace as a private local palace, a shared-brain hub or a client of an existing hub, including MCP registration and version-correct initialization.
59k GitHub stars~2.2k tokensUpdated today
Agent WorkflowsAuto-check passed
agentmemory Setup and Diagnostics
rohitg00/agentmemory
Sets up and troubleshoots a local agentmemory install, covering the MCP connection, environment variables, ports, authentication and optional feature flags.
29k GitHub stars~1k tokensUpdated yesterday
Agent WorkflowsAuto-check: notes
Qmd
breferrari/obsidian-mind
Search the vault using QMD semantic search. An agent skill from breferrari/obsidian-mind.
4.9k GitHub stars~1.7k tokensUpdated yesterday
Agent WorkflowsAuto-check passed
Memori MCP Memory Usage
MemoriLabs/Memori
Teaches an MCP-connected agent when and how to call Memori's recall, summary, compaction, augmentation, feedback and quota tools to keep context across sessions.
17k GitHub stars~3.8k tokensUpdated 5 days ago
Agent WorkflowsAuto-check passed
Shared Agent Knowledge Commons
mozilla-ai/cq
Queries a shared knowledge store before acting, proposes newly discovered insights, and confirms or flags existing entries, so agents stop rediscovering the same failures.
1.3k GitHub stars~6.5k tokensUpdated yesterday
Agent WorkflowsAuto-check passed
Agent Recall
Goldentrii/AgentRecall-X
Persistent compounding memory for AI agents. An agent skill from Goldentrii/AgentRecall-X.
371 GitHub stars~5.2k tokensUpdated 10 days ago
Agent WorkflowsAuto-check: notes

Works with

Model Context Protocol

Questions about Setup Open Index

What does Setup Open Index do?

Install and configure Open Index as the read/write context layer for a domain-specialized agent. Setup Open Index is an agent skill from DrDroidLab/open-index. Install and configure Open Index as the read/write context layer for a domain-specialized agent.

When should I use Setup Open Index?

Setup Open Index fits situations like: setting up a legal; customer support; other domain agent with Open Index over MCP.

How do I install Setup Open Index in Claude Code?

Run `npx skills add DrDroidLab/open-index --skill setup-open-index -a claude-code`. Or copy the skill folder (skills/setup-open-index in DrDroidLab/open-index) into .claude/skills/setup-open-index in your project. Claude Code loads it when a task matches its description.

How do I install Setup Open Index in Codex?

Run `npx skills add DrDroidLab/open-index --skill setup-open-index -a codex`. Or copy the skill folder (skills/setup-open-index in DrDroidLab/open-index) into .agents/skills/setup-open-index in your project. Codex loads it when a task matches its description.

Can I use Setup Open Index in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add DrDroidLab/open-index --skill setup-open-index -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/setup-open-index, .gemini/skills/setup-open-index, .github/skills/setup-open-index and .opencode/skills/setup-open-index in your project.

What does Setup Open Index need to run?

Going by SKILL.md and its folder, Setup Open Index needs the command-line tools its instructions call (python and pip). Our summary lists: Python 3.

Does Setup Open Index access the network?

SKILL.md contains no URLs. Its commands use pip, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Setup Open Index safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Setup Open Index use?

Setup Open Index is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Setup Open Index use?

About 855 tokens (SKILL.md is roughly 3.4k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Setup Open Index?

Skills that share tags, products or a category with Setup Open Index: MemPalace Setup and Operation (MemPalace/mempalace, 59k stars), agentmemory Setup and Diagnostics (rohitg00/agentmemory, 29k stars), Qmd (breferrari/obsidian-mind, 4.9k stars) and Memori MCP Memory Usage (MemoriLabs/Memori, 17k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Setup Open Index?

DrDroidLab (a GitHub organization) maintains it in DrDroidLab/open-index, which has 112 GitHub stars. The repository was last updated on August 12, 2026.

Source: DrDroidLab/open-index on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.

Install Setup Open Index

Facts

At a glance

What it does

When your agent uses it

Example prompts

Requirements

Workflow steps

What it can do on your machine

Tool permissions

Runs code

Network

Credentials

Context cost

Safety

SKILL.md

Set up Open Index for a domain agent

1. Install

2. Initialize the domain brain

3. Connect the MCP server

4. Verify the agent connection

5. Production setup

Guardrails

Files

Compare with similar skills

Similar skills

MemPalace Setup and Operation

agentmemory Setup and Diagnostics

Qmd

Memori MCP Memory Usage

Shared Agent Knowledge Commons

Agent Recall

Related

Questions about Setup Open Index