How do I install the Engraph skill?

Run npx skillmds@latest add tomevault-io/engraph in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Engraph safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Engraph?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Engraph free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Engraph?

tomevault-io (@tomevault-io) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Engraph by tomevault-io — Agent Skill

Name: Engraph
Author: tomevault-io

Engraph

Index and search document collections using hybrid semantic + graph + full-text search. Use when users need to search knowledge bases, find connections between documents, discover related content via link graphs, or query indexed markdown collections. Use when this capability is needed.

tomevault-io Updated Sep 17, 2026

File contents

Engraph — Hybrid Semantic & Graph Search for Document Collections

Local knowledge engine for markdown document collections. Combines semantic embeddings, full-text search (BM25), wikilink graph traversal, temporal scoring, and cross-encoder reranking.

Status

!engraph --version 2>/dev/null || echo "Not installed: brew install devwhodevs/tap/engraph"

Indexing

engraph index /path/to/documents        # Incremental; only changed files re-embedded
engraph index /path/to/documents --rebuild
engraph status                          # File count, stats, index freshness
engraph clear                           # Drop the index (--all also removes models)

Search

engraph search "how does the auth flow work"
engraph search "performance regressions last month" --explain
engraph search "architecture decisions" -n 5 --json

Flag	Description
`-n, --top-n <N>`	Number of results (default: from config or 10)
`--explain`	Show per-lane RRF score breakdown
`--json`	Machine-readable JSON output

Query Tips

Conceptual / vague: Use natural language. The orchestrator classifies intent and boosts semantic weight automatically.
Keyword-heavy: Exact terms, identifiers, and names work well via the BM25 lane.
Temporal: "last week", "yesterday", "March 2026" — the temporal lane activates automatically.

Graph Inspection

engraph graph show "path/to/note.md"    # Connections for a document
engraph graph show "#docid"             # By document ID
engraph graph stats                     # Nodes, edges, density

Context Queries

engraph context topic "authentication" --budget 8000
engraph context who "Person Name"
engraph context project "Project Name"
engraph context vault-map                 # Collection structure overview
engraph context read "path/to/note.md"    # Full content + metadata
engraph context list --tags architecture  # Filter by tags, folder, created_by, etc.

Health diagnostics (orphans, broken links, stale notes, tag hygiene) are exposed through the MCP health tool and the HTTP GET /api/health endpoint — see references/http-rest-api.md.

Setup

engraph index /path/to/documents
engraph search "your query"

References

references/mcp-setup.md — configure engraph as an MCP server (Claude Code, Claude Desktop).
references/http-rest-api.md — HTTP REST API endpoints, authentication, and examples for web agents and scripts.

Source: devwhodevs/engraph — distributed by TomeVault.

---name: engraphdescription: Index and search document collections using hybrid semantic + graph + full-text search. Use when users need to search knowledge bases, find connections between documents, discover related content via link graphs, or query indexed markdown collections. Use when this capability is needed.---# Engraph — Hybrid Semantic & Graph Search for Document CollectionsLocal knowledge engine for markdown document collections. Combines semantic embeddings, full-text search (BM25), wikilink graph traversal, temporal scoring, and cross-encoder reranking.## Status!`engraph --version 2>/dev/null || echo "Not installed: brew install devwhodevs/tap/engraph"`## Indexing```bashengraph index /path/to/documents # Incremental; only changed files re-embeddedengraph index /path/to/documents --rebuildengraph status # File count, stats, index freshnessengraph clear # Drop the index (--all also removes models)```## Search```bashengraph search "how does the auth flow work"engraph search "performance regressions last month" --explainengraph search "architecture decisions" -n 5 --json```| Flag | Description || ----------------- | ---------------------------------------------- || `-n, --top-n <N>` | Number of results (default: from config or 10) || `--explain` | Show per-lane RRF score breakdown || `--json` | Machine-readable JSON output |### Query Tips- **Conceptual / vague**: Use natural language. The orchestrator classifies intent and boosts semantic weight automatically.- **Keyword-heavy**: Exact terms, identifiers, and names work well via the BM25 lane.- **Temporal**: "last week", "yesterday", "March 2026" — the temporal lane activates automatically.## Graph Inspection```bashengraph graph show "path/to/note.md" # Connections for a documentengraph graph show "#docid" # By document IDengraph graph stats # Nodes, edges, density```## Context Queries```bashengraph context topic "authentication" --budget 8000engraph context who "Person Name"engraph context project "Project Name"engraph context vault-map # Collection structure overviewengraph context read "path/to/note.md" # Full content + metadataengraph context list --tags architecture # Filter by tags, folder, created_by, etc.```> Health diagnostics (orphans, broken links, stale notes, tag hygiene) are exposed through the MCP `health` tool and the HTTP `GET /api/health` endpoint — see `references/http-rest-api.md`.## Setup```bashengraph index /path/to/documentsengraph search "your query"```## References- `references/mcp-setup.md` — configure engraph as an MCP server (Claude Code, Claude Desktop).- `references/http-rest-api.md` — HTTP REST API endpoints, authentication, and examples for web agents and scripts.---> Source: [devwhodevs/engraph](https://github.com/devwhodevs/engraph) — distributed by [TomeVault](https://tomevault.io).

Frequently asked questions