docs: add plugin check examples

README.md

@@ -73,6 +73,9 @@ Then run:
 plugin-inspector check --config plugin-inspector.config.json
 ```
 
+Copy-ready examples live in `examples/plugin-inspector.config.json` and
+`examples/github-actions-plugin-inspector.yml`.
+
 Fixture-set configs are still supported for crabpot-style compatibility suites:
 
 ```bash

examples/github-actions-plugin-inspector.yml

@@ -0,0 +1,23 @@
+name: plugin-inspector
+
+on:
+  pull_request:
+  push:
+    branches: [main]
+
+jobs:
+  check:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v5
+      - uses: actions/setup-node@v5
+        with:
+          node-version: 24
+          cache: npm
+      - run: npm ci
+      - run: npm run plugin:check
+      - uses: actions/upload-artifact@v5
+        if: always()
+        with:
+          name: plugin-inspector-reports
+          path: reports/plugin-inspector-*

examples/plugin-inspector.config.json

@@ -0,0 +1,15 @@
+{
+  "version": 1,
+  "plugin": {
+    "id": "weather",
+    "priority": "high",
+    "seams": ["dynamic-tool"],
+    "sourceRoot": "src",
+    "expect": {
+      "registrations": ["registerTool"]
+    }
+  },
+  "openclaw": {
+    "defaultCheckoutPath": "../openclaw"
+  }
+}

package.json

@@ -38,6 +38,7 @@
   },
   "files": [
     "src",
+    "examples",
     "README.md",
     "LICENSE"
   ],