Merge task/t8-plugin

Author: jdrhyne

docs/PLUGIN.md

@@ -0,0 +1,56 @@
+# Claude Code Plugin: dws-cli
+
+## Install
+
+1. Build the CLI:
+
+```sh
+npm install
+npm run build
+```
+
+2. Add the plugin to Claude Code by pointing it at:
+
+```
+plugin/manifest.json
+```
+
+## Use
+
+The plugin exposes the CLI commands directly. The general form is:
+
+```sh
+dws <command> [args]
+```
+
+> Note: Several commands are **stubs** until the DWS API integration is wired in. They will emit placeholder output with `status: "stub"`.
+
+### Examples
+
+```sh
+dws setup --api-key <key>
+```
+
+```sh
+dws preflight <htmlPath>
+```
+
+```sh
+dws convert <htmlPath> --output output.pdf --deterministic
+```
+
+```sh
+dws benchmark --suite W1-W6 --out results.json
+```
+
+```sh
+dws report --in results.json --out report.md
+```
+
+```sh
+dws skills list
+```
+
+```sh
+dws skills add /path/to/skill
+```

plugin/manifest.json

@@ -0,0 +1,31 @@
+{
+  "name": "dws-cli",
+  "version": "0.1.0",
+  "description": "CLI for DWS setup, validation, conversion, benchmarking, reporting, and skills.",
+  "commands": {
+    "setup": {
+      "command": "dws setup",
+      "description": "Initialize or configure the DWS environment."
+    },
+    "preflight": {
+      "command": "dws preflight <htmlPath>",
+      "description": "Run preflight checks on an HTML file (stub output)."
+    },
+    "convert": {
+      "command": "dws convert <htmlPath> --output <path>",
+      "description": "Convert HTML to PDF (stub output)."
+    },
+    "benchmark": {
+      "command": "dws benchmark --suite <name>",
+      "description": "Run benchmark placeholders and write results JSON."
+    },
+    "report": {
+      "command": "dws report --in <results.json> --out <report.md>",
+      "description": "Generate a markdown report from benchmark results."
+    },
+    "skills": {
+      "command": "dws skills <subcommand>",
+      "description": "List or manage DWS skills."
+    }
+  }
+}