semantica/plugins/.claude-plugin/README.md

# Semantica Plugins (Community Guide)

> **v0.4.0** — 17 domain skills · 3 agents · 8 platform plugins · Knowledge Explorer UI

Semantica ships a shared plugin bundle under `plugins/` that works across every major AI coding assistant. Connect any supported platform to Semantica's knowledge graph engine for semantic extraction, decision intelligence, reasoning, provenance, ontology, and export workflows.

---

## Platform Plugins

Semantica provides a dedicated plugin for each platform. Every plugin shares the same `skills/`, `agents/`, and `hooks/` bundle — only the manifest format differs.

| # | Platform | Plugin Folder | Setup |
|---|----------|--------------|-------|
| 1 | **Claude Code** | `.claude-plugin/` | `claude --plugin-dir ./plugins` |
| 2 | **Cursor** | `.cursor-plugin/` | Cursor Marketplace → refresh |
| 3 | **Codex** | `.codex-plugin/` | Marketplace UI → install |
| 4 | **Cline** | `.cline-plugin/` | Cline MCP settings |
| 5 | **Windsurf** | `.windsurf-plugin/` | `mcp_config.json` |
| 6 | **Continue** | `.continue-plugin/` | `~/.continue/config.json` |
| 7 | **OpenClaw** | `.openclaw-plugin/` | `mcporter.json` |
| 8 | **VS Code** | `.vscode-plugin/` | `settings.json` MCP entry |

---

## What's Included

```
plugins/
├── skills/              # 17 domain skills (slash commands)
├── agents/              # 3 specialized agents
├── hooks/               # hooks.json
├── .claude-plugin/      # Claude Code manifest + marketplace
├── .cursor-plugin/      # Cursor manifest + marketplace
├── .codex-plugin/       # Codex manifest + marketplace
├── .cline-plugin/       # Cline manifest + marketplace
├── .windsurf-plugin/    # Windsurf manifest + marketplace
├── .continue-plugin/    # Continue manifest + marketplace
├── .openclaw-plugin/    # OpenClaw manifest + marketplace
└── .vscode-plugin/      # VS Code manifest + marketplace
```

### Skills (17)

`extract` · `ingest` · `query` · `ontology` · `validate` · `deduplicate` · `embed` · `reason` · `decision` · `causal` · `temporal` · `provenance` · `policy` · `explain` · `export` · `change` · `visualize`

### Agents (3)

`decision-advisor` · `explainability` · `kg-assistant`

---

## Prerequisites

```bash
git clone https://github.com/semantica-agi/semantica.git
cd semantica
pip install semantica        # Python 3.10+
```

---

## Knowledge Explorer (v0.4.0)

Launch the interactive graph dashboard:

```bash
semantica-explorer --graph my_graph.json --port 8000
```

Open **http://localhost:5174** to explore:

- **Graph** — interactive canvas with ForceAtlas2 layout, path highlight, community coloring
- **Decisions** — causal chains and outcome analysis
- **Reasoning** — run deductive / abductive rules
- **SPARQL** — Monaco editor for graph queries
- **Vocabulary** — ontology concept tree
- **Lineage** — provenance lineage diagram
- **Import / Export** — JSON, RDF, Parquet, GraphML

---

## Installation by Platform

### Claude Code

```bash
claude --plugin-dir ./plugins
```

Or inside a session:

```bash
/plugin marketplace add ./plugins
/plugin install semantica@semantica-local
```

Verify:

```
/semantica:decision list
/semantica:explain decision <decision_id>
```

---

### Cursor

Cursor reads `.cursor-plugin/plugin.json` and `.cursor-plugin/marketplace.json` automatically. Publish the `plugins/` directory and refresh in Cursor Marketplace to pick up updates.

Verify:

```
/semantica:visualize topology
/semantica:reason deductive "IF Person(x) THEN Mortal(x)"
```

---

### Codex

1. Ensure your repo marketplace exists at `.agents/plugins/marketplace.json`.
2. Set `source.path` to `./plugins` in the plugin entry.
3. Restart Codex and install from the marketplace UI.

Verify:

```
/semantica:causal chain --subject <decision_id> --depth 3
```

---

### Cline

In Cline MCP settings, add:

```json
{
  "semantica": {
    "command": "python",
    "args": ["-m", "semantica.mcp_server"],
    "env": {}
  }
}
```

---

### Windsurf

Add to `~/.codeium/windsurf/mcp_config.json`:

```json
{
  "mcpServers": {
    "semantica": {
      "command": "python",
      "args": ["-m", "semantica.mcp_server"]
    }
  }
}
```

---

### Continue

Add to `~/.continue/config.json`:

```json
{
  "mcpServers": [
    {
      "name": "semantica",
      "command": "python",
      "args": ["-m", "semantica.mcp_server"]
    }
  ]
}
```

All 17 Semantica skills appear in the `@semantica` context provider dropdown.

---

### OpenClaw

Add to `~/.openclaw/mcporter.json`:

```json
{
  "mcpServers": {
    "semantica": {
      "command": "python",
      "args": ["-m", "semantica.mcp_server"],
      "transport": "stdio"
    }
  }
}
```

Then restart the gateway:

```bash
openclaw gateway restart
```

---

### VS Code

Add to `settings.json` (GitHub Copilot Chat):

```json
{
  "github.copilot.chat.mcp.servers": {
    "semantica": {
      "command": "python",
      "args": ["-m", "semantica.mcp_server"]
    }
  }
}
```

Or for the VS Code MCP extension:

```json
{
  "mcp.servers": {
    "semantica": {
      "command": "python",
      "args": ["-m", "semantica.mcp_server"]
    }
  }
}
```

---

## First Commands to Try

After installing on any platform:

```
/semantica:decision record <category> "<scenario>" "<reasoning>" <outcome> <confidence>
/semantica:decision list
/semantica:causal chain --subject <decision_id> --depth 3
/semantica:explain decision <decision_id>
/semantica:validate graph
/semantica:visualize topology
```

---

## Community Notes

- Keep `name` / `version` / `keywords` updated in each manifest before publishing.
- Keep skill frontmatter (`name` + `description`) consistent for reliable discovery.
- Include `plugins/` as-is when sharing — skills, agents, and hooks must stay bundled.