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

git clone https://github.com/Hawksight-AI/semantica.git
cd semantica
pip install semantica        # Python 3.10+

---

Knowledge Explorer (v0.4.0)

Launch the interactive graph dashboard:

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

claude --plugin-dir ./plugins

Or inside a session:

/plugin install ./plugins

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:

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

---

Windsurf

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

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

---

Continue

Add to ~/.continue/config.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:

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

Then restart the gateway:

openclaw gateway restart

---

VS Code

Add to settings.json (GitHub Copilot Chat):

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

Or for the VS Code MCP extension:

{
  "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.