@neat.is/claude-skill 0.2.5

package/README.md

@@ -0,0 +1,17 @@
+# @neat.is/claude-skill
+
+Drop-in MCP config that hooks NEAT's nine MCP tools into Claude Code.
+
+See [SKILL.md](./SKILL.md) for the tool list, install steps, and prerequisites.
+
+The shipped artifact is `claude_code_config.json` — a single object you merge into your `~/.claude.json` under `mcpServers.neat`. The `neat skill` CLI verb (in `@neat.is/core`) handles the merge for you.
+
+## Files
+
+- `claude_code_config.json` — the MCP server snippet
+- `SKILL.md` — what the skill exposes and how to install
+- `package.json` — workspace metadata; this package ships no compiled code
+
+## When this drifts
+
+If the nine MCP tools change shape or the `@neat.is/mcp` package ships a different stdio entrypoint, this snippet needs to keep up. The contract test in `packages/core/test/audits/contracts.test.ts` enforces the snippet shape — `command: 'npx'`, args wired to `@neat.is/mcp`, type `stdio`, plus `NEAT_API_URL` env wired through.

package/SKILL.md

@@ -0,0 +1,63 @@
+# NEAT — Claude Code skill
+
+This skill exposes NEAT's live semantic graph to Claude Code over MCP. Once installed, Claude can ask the running NEAT daemon (`neatd`) about a project's services, dependencies, recent errors, and policy violations — same as any other agent NEAT supports.
+
+## What you get
+
+Nine MCP tools, served by `@neat.is/mcp` over stdio:
+
+| Tool | What it does |
+|------|--------------|
+| `get_graph` | Snapshot of the full graph for a project — every node, every edge, with provenance. |
+| `get_node` | One node by id, with its incoming and outgoing edges. |
+| `get_dependencies` | Transitive closure of `DEPENDS_ON` / `CONNECTS_TO` from a starting node. |
+| `get_root_cause` | Walks incoming edges from a failing node and returns the first divergence — typically a version mismatch or a config gap. |
+| `get_blast_radius` | BFS outbound from a starting node — every service / database / config that would feel a change here. |
+| `get_recent_errors` | Last N error events, ordered by `lastObserved`. |
+| `semantic_search` | Embedding-based search over node names + descriptions. |
+| `check_policies` | Runs the project's `policy.json` rules against the live graph. Returns active violations. |
+| `get_compatibility` | Compatibility matrix lookups — what's known about a `<driver, engine>` pair. |
+
+All nine read from the live graph the daemon maintains in memory. No fs reads of `graph.json` at request time.
+
+## Install
+
+The simplest path: add the snippet from `claude_code_config.json` to your Claude Code MCP config.
+
+**macOS / Linux:**
+
+```bash
+# Print the snippet
+cat node_modules/@neat.is/claude-skill/claude_code_config.json
+
+# Or, with the neat CLI:
+neat skill --print-config
+```
+
+Merge `mcpServers.neat` into your existing `~/.claude.json`.
+
+**One-shot install** via the NEAT CLI:
+
+```bash
+neat skill --apply
+```
+
+This merges the `neat` server into `~/.claude.json` without touching other entries.
+
+## Prerequisites
+
+- `neat init <repo>` has registered at least one project.
+- `neatd start` is running (or you're OK with `npx -y @neat.is/mcp` spawning per request — slower, but works).
+- The `NEAT_API_URL` env var points at the running daemon's REST endpoint. Default is `http://localhost:8080`, which matches the daemon's default port.
+
+## What's not in MVP
+
+- Auto-detection of an alternate Claude Code config path. The installer assumes `~/.claude.json`.
+- Per-project skill overrides. The skill is user-scoped; project-level MCP config can be added later as a follow-up.
+- Tool-level disable flags. All nine tools are wired in; if you want to hide one, edit the snippet by hand.
+
+## Where to look when it doesn't work
+
+- `neatd status` — confirms the daemon is running and which projects are registered.
+- `~/.claude.json` — the config file. Look for `mcpServers.neat`.
+- `claude mcp list` — Claude Code's built-in inventory of MCP servers.

package/claude_code_config.json

@@ -0,0 +1,12 @@
+{
+  "mcpServers": {
+    "neat": {
+      "type": "stdio",
+      "command": "npx",
+      "args": ["-y", "@neat.is/mcp"],
+      "env": {
+        "NEAT_API_URL": "http://localhost:8080"
+      }
+    }
+  }
+}

package/package.json

@@ -0,0 +1,20 @@
+{
+  "name": "@neat.is/claude-skill",
+  "version": "0.2.5",
+  "description": "Claude Code skill drop-in for NEAT — wires the @neat.is/mcp server into Claude's MCP config",
+  "license": "BUSL-1.1",
+  "homepage": "https://neat.is",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/NEAT-Technologies/Neat.git",
+    "directory": "packages/claude-skill"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": ["README.md", "SKILL.md", "claude_code_config.json"],
+  "scripts": {
+    "test": "vitest run --passWithNoTests",
+    "lint": "eslint . --no-error-on-unmatched-pattern || true"
+  }
+}