feat(skills): add agent skill

Author: jsynowiec

README.md

@@ -133,6 +133,12 @@ engraph serve
 
 Now Claude can search your vault, read notes, build context bundles, and create new notes — all through structured tool calls.
 
+**AI Agent Skills** — Install the Engraph skills using the skills CLI (recommended):
+
+```bash
+npx skills add devwhodevs/engraph
+```
+
 **Enable HTTP REST API:**
 
 ```bash

skills/engraph/SKILL.md

@@ -0,0 +1,74 @@
+---
+name: engraph
+description: 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.
+license: MIT
+compatibility: Requires engraph CLI. Install via `brew install devwhodevs/tap/engraph` or from GitHub releases.
+metadata:
+  author: jsynowiec
+  version: "1.0.0"
+allowed-tools: Bash(engraph:*), mcp__engraph__*
+---
+
+# 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 status 2>/dev/null || echo "Not installed: brew install devwhodevs/tap/engraph"`
+
+## Indexing
+
+```bash
+engraph index /path/to/documents        # Incremental; only changed files re-embedded
+engraph index /path/to/documents --rebuild
+engraph status                          # File count, health, stats
+engraph clear                           # Drop cached data and models
+```
+
+## Search
+
+```bash
+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
+
+```bash
+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
+
+```bash
+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 health                  # Orphans, broken links, stale content, tag hygiene
+engraph context read "path/to/note.md"  # Full content + metadata
+engraph context list --tag architecture # Filter by tag, folder, created_by, etc.
+```
+
+## Setup
+
+```bash
+engraph index /path/to/documents
+engraph search "your query"
+```

skills/engraph/references/http-rest-api.md

@@ -0,0 +1,42 @@
+# Engraph HTTP REST API
+
+Enable alongside MCP for web agents, scripts, and integrations:
+
+```bash
+engraph serve --http              # Default port 3000
+engraph serve --http --port 8080 --host 0.0.0.0
+engraph serve --http --no-auth    # Local dev only (127.0.0.1)
+```
+
+## Key Endpoints
+
+| Method | Endpoint                | Description                                                      |
+| ------ | ----------------------- | ---------------------------------------------------------------- |
+| POST   | `/api/search`           | Hybrid search with semantic + FTS5 + graph + reranker + temporal |
+| GET    | `/api/read/{file}`      | Read full document content + metadata                            |
+| GET    | `/api/read-section`     | Read specific section by heading                                 |
+| GET    | `/api/list`             | List documents with tag/folder filters                           |
+| GET    | `/api/vault-map`        | Collection structure overview                                    |
+| POST   | `/api/context`          | Rich topic context with token budget                             |
+| GET    | `/api/health`           | Collection health diagnostics                                    |
+| POST   | `/api/create`           | Create new document                                              |
+| POST   | `/api/edit`             | Section-level editing                                            |
+| POST   | `/api/rewrite`          | Full body rewrite (preserves frontmatter)                        |
+| POST   | `/api/edit-frontmatter` | Granular frontmatter mutations                                   |
+
+## Authentication
+
+All HTTP requests require an API key via the `Authorization` header:
+
+```bash
+curl -H "Authorization: Bearer eg_abc123..." http://localhost:3000/api/search \
+  -H "Content-Type: application/json" -d '{"query": "architecture", "top_n": 5}'
+```
+
+Generate keys:
+
+```bash
+engraph configure --add-api-key       # Interactive
+engraph configure --list-api-keys     # List existing
+engraph configure --revoke-api-key    # Revoke
+```

skills/engraph/references/mcp-setup.md

@@ -0,0 +1,36 @@
+# Engraph MCP Server Setup
+
+## Install
+
+```bash
+brew install devwhodevs/tap/engraph
+engraph index /path/to/documents
+```
+
+## Configure MCP Client
+
+**Claude Code** (`~/.claude/settings.json`):
+
+```json
+{
+  "mcpServers": {
+    "engraph": { "command": "engraph", "args": ["serve"] }
+  }
+}
+```
+
+**Claude Desktop** (`~/Library/Application Support/Claude/claude_desktop_config.json`):
+
+```json
+{
+  "mcpServers": {
+    "engraph": { "command": "engraph", "args": ["serve"] }
+  }
+}
+```
+
+## HTTP Mode
+
+```bash
+engraph serve --http              # Port 3030
+```