Merge pull request #1 from TransluceAI/xiaowuc1/init

initial version of plugin

Author: xiaowuc1

.agents/plugins/marketplace.json

@@ -0,0 +1,20 @@
+{
+  "name": "transluce-plugins",
+  "interface": {
+    "displayName": "Transluce Plugins"
+  },
+  "plugins": [
+    {
+      "name": "docent",
+      "source": {
+        "source": "local",
+        "path": "./plugins/docent"
+      },
+      "policy": {
+        "installation": "AVAILABLE",
+        "authentication": "ON_INSTALL"
+      },
+      "category": "Productivity"
+    }
+  ]
+}

README.md

@@ -0,0 +1,23 @@
+# Codex Plugins
+
+A collection of plugins for Codex.
+
+## Available Plugins
+
+| Plugin | Description |
+|--------|-------------|
+| [docent](./plugins/docent) | Docent AI analysis tools for Codex |
+
+## Installation
+
+Add this marketplace to Codex:
+
+```shell
+codex plugin marketplace add TransluceAI/codex-plugins
+```
+
+Then install the plugin:
+
+```shell
+codex plugin add docent@transluce-plugins
+```

plugins/docent/.codex-plugin/plugin.json

@@ -0,0 +1,30 @@
+{
+  "name": "docent",
+  "version": "0.1.1",
+  "description": "Docent AI analysis tools for Codex.",
+  "author": {
+    "name": "Transluce",
+    "url": "https://transluce.org"
+  },
+  "homepage": "https://docs.transluce.org",
+  "repository": "https://github.com/TransluceAI/docent",
+  "license": "Apache-2.0",
+  "keywords": ["docent", "agent-analysis", "research", "mcp"],
+  "skills": "./skills/",
+  "mcpServers": "./.mcp.json",
+  "interface": {
+    "displayName": "Docent",
+    "shortDescription": "Analyze agent behavior with Docent.",
+    "longDescription": "Use Docent skills and MCP tools from Codex to analyze agent runs and ingest new trace collections.",
+    "developerName": "Transluce",
+    "category": "Productivity",
+    "capabilities": ["Read", "Write"],
+    "websiteURL": "https://docs.transluce.org",
+    "defaultPrompt": [
+      "Use Docent to analyze this collection of agent runs.",
+      "Use Docent to investigate a regression between two agent checkpoints.",
+      "Use Docent to ingest evaluation transcripts into a new collection."
+    ],
+    "brandColor": "#2563EB"
+  }
+}

plugins/docent/.mcp.json

@@ -0,0 +1,9 @@
+{
+  "mcpServers": {
+    "docent": {
+      "type": "stdio",
+      "command": "uv",
+      "args": ["tool", "run", "--from", "docent-python", "docent-mcp"]
+    }
+  }
+}

plugins/docent/skills/docent/SKILL.md

@@ -0,0 +1,21 @@
+---
+name: docent
+description: Docent is a platform for analyzing AI agent behavior. Always load this skill before interacting with the Docent platform.
+alwaysApply: true
+---
+
+# Docent
+
+This is the root skill for all Docent work. This file is just a table of contents. In most cases you should read one of the guides below before starting to work with docent. Choose the guide that best matches your task.
+
+- For exploring a collection of agent runs, analyzing data, answering questions about agent behavior: `./analysis.md`
+- For ingestion workflows that convert local logs or eval traces into Docent data: `./ingestion.md`
+- If the user is asking to manipulate data in the platform through code or the command line, see the SDK reference.
+
+## Other available documentation
+
+- For the Readings API (`client.read`, `client.query`, batching, prompts, clustering): `./readings-reference.md`
+- For DQL syntax, schemas, quirks, and example queries: `./dql-reference.md`
+- For the reports API: `./report.md` (only if the user explicitly asks for a report)
+- For ingestion-side data-model and conversion examples: the reference and pattern sections in `./ingestion.md`
+- SDK reference is available by visiting [our online documentation](https://docs.transluce.org/llms.txt)