Added Official Agent Skill for client integration.

Author: niemyjski

.agents/skills/exceptionless-javascript/SKILL.md

@@ -0,0 +1,83 @@
+---
+name: exceptionless-javascript
+description: Use this skill when a developer wants to install, configure, troubleshoot, or integrate Exceptionless JavaScript clients for browser, Node.js, React, Vue, AngularJS, Express, Next.js, SvelteKit, or custom runtimes. Use it for API keys, startup, self-hosting, sending errors/logs/feature usage/404/custom events, indexed event properties, sessions, heartbeats, user identity, PII/data exclusions, plugins, runtime client configuration values, queues, and production setup even if they only ask "how do I wire up Exceptionless?"
+---
+
+# Exceptionless JavaScript SDK
+
+Use this skill to produce source-accurate setup code, integration guidance, and technical documentation for the Exceptionless JavaScript clients.
+
+Keep answers compact. Prefer pointing to official docs for broad product behavior, and use local package READMEs/source to correct stale snippets or repo-specific package details.
+
+## Official Docs
+
+Primary docs:
+
+- JavaScript overview: https://exceptionless.com/docs/clients/javascript/
+- Configuration: https://exceptionless.com/docs/clients/javascript/client-configuration/
+- Client configuration values: https://exceptionless.com/docs/clients/javascript/client-configuration-values/
+- Sending events: https://exceptionless.com/docs/clients/javascript/sending-events/
+- Filtering and indexed data: https://exceptionless.com/docs/filtering-and-searching/
+- User sessions: https://exceptionless.com/docs/user-sessions/
+- Troubleshooting: https://exceptionless.com/docs/clients/javascript/troubleshooting/
+- Self-hosting: https://exceptionless.com/docs/self-hosting/
+
+Framework docs:
+
+- React: https://exceptionless.com/docs/clients/javascript/guides/react/
+- Vue: https://exceptionless.com/docs/clients/javascript/guides/vue/
+- Angular: https://exceptionless.com/docs/clients/javascript/guides/angular/
+- Node: https://exceptionless.com/docs/clients/javascript/node-example/
+- Express: https://exceptionless.com/docs/clients/javascript/guides/express/
+
+## Pick References
+
+Read only the reference that matches the user's runtime, then add shared references as needed:
+
+- `@exceptionless/core`: [references/client-core.md](references/client-core.md)
+- `@exceptionless/browser`: [references/client-browser.md](references/client-browser.md)
+- `@exceptionless/node`: [references/client-node.md](references/client-node.md)
+- `@exceptionless/react`: [references/client-react.md](references/client-react.md)
+- `@exceptionless/vue`: [references/client-vue.md](references/client-vue.md)
+- `@exceptionless/angularjs`: [references/client-angularjs.md](references/client-angularjs.md)
+- Sending events: [references/sending-events.md](references/sending-events.md)
+- Configuration and client configuration values: [references/configuration.md](references/configuration.md)
+- Sessions, heartbeats, and user identity: [references/sessions.md](references/sessions.md)
+- Plugins: [references/plugins.md](references/plugins.md)
+- Data exclusions and PII: [references/data-exclusions.md](references/data-exclusions.md)
+- Troubleshooting: [references/troubleshooting.md](references/troubleshooting.md)
+- Self-hosting: [references/self-hosting.md](references/self-hosting.md)
+
+## Rules
+
+- Use `Exceptionless.startup(...)` once during app startup. `startup()` with no args is used later by lifecycle plugins to resume timers/queue processing.
+- Use the singleton from the platform package when automatic capture matters. Create `ExceptionlessClient` manually only for custom pipelines or tests.
+- `submitException` and `createException` take an `Error`. For unknown caught values, use exported `toError(value)` when available.
+- `markAsCritical()` marks the event critical; `markAsCritical(false)` leaves tags unchanged.
+- `config.serverUrl` also sets `configServerUrl` and `heartbeatServerUrl`; assign custom endpoint overrides after setting `serverUrl`.
+- Use lowercase log levels in new snippets: `"trace"`, `"debug"`, `"info"`, `"warn"`, `"error"`, `"fatal"`, `"off"`.
+- For short-lived Node/serverless work, call `await Exceptionless.processQueue()` after critical submissions.
+
+## Integrator Guidance
+
+- Prefer complete, copyable snippets with imports and realistic placeholder values.
+- Include only high-level setup/configuration inline; point to official docs for broader product explanation.
+- Make privacy controls explicit in production examples that collect request, cookie, header, query, post, or user data. Read [references/data-exclusions.md](references/data-exclusions.md) for PII-sensitive examples.
+- Read [references/plugins.md](references/plugins.md) before documenting custom event enrichment, runtime filtering, or cancellation behavior.
+- Read [references/sessions.md](references/sessions.md) before documenting sessions, heartbeats, user identity, or session end behavior.
+- Explain near real-time client settings with server setting keys only for advanced docs: `@@log:*`, `@@error:*`, `@@usage:*`, `@@404:*`, `@@DataExclusions`, `@@UserAgentBotPatterns`.
+- For SSR, hot reload, or serverless examples, memoize startup and flush short-lived server work with `await Exceptionless.processQueue()`.
+- Before calling snippets "compiled" or "validated", actually type-check or run a representative compile against the workspace packages.
+
+## Source Anchors
+
+Verify behavior in:
+
+- `packages/core/src/ExceptionlessClient.ts`
+- `packages/core/src/configuration/Configuration.ts`
+- `packages/core/src/EventBuilder.ts`
+- `packages/core/src/plugins/default/EventExclusionPlugin.ts`
+- `packages/core/src/submission/DefaultSubmissionClient.ts`
+- `packages/browser/src/BrowserExceptionlessClient.ts`
+- `packages/node/src/NodeExceptionlessClient.ts`
+- Package READMEs and `example/` apps.

.agents/skills/exceptionless-javascript/agents/openai.yaml

@@ -0,0 +1,4 @@
+interface:
+  display_name: "Exceptionless JavaScript"
+  short_description: "Configure Exceptionless JavaScript clients"
+  default_prompt: "Use $exceptionless-javascript to configure, document, or troubleshoot an Exceptionless JavaScript client."

.agents/skills/exceptionless-javascript/references/client-angularjs.md

@@ -0,0 +1,54 @@
+# @exceptionless/angularjs
+
+Use for AngularJS 1.x apps. The official public docs currently show generic Angular with `@exceptionless/browser`; this repo also ships an AngularJS package.
+
+Docs: https://exceptionless.com/docs/clients/javascript/guides/angular/
+
+## Install
+
+```bash
+npm install @exceptionless/angularjs --save
+```
+
+CDN or bundled script:
+
+```html
+<script type="module" src="https://unpkg.com/@exceptionless/angularjs"></script>
+```
+
+## Configure
+
+```js
+import "@exceptionless/angularjs";
+
+angular.module("app", ["exceptionless"]).run([
+  "$ExceptionlessClient",
+  async ($ExceptionlessClient) => {
+    await $ExceptionlessClient.startup((config) => {
+      config.apiKey = "API_KEY_HERE";
+      config.defaultTags.push("Example", "JavaScript", "AngularJS");
+    });
+  }
+]);
+```
+
+## Send
+
+```js
+angular.module("app").controller("DemoController", [
+  "$ExceptionlessClient",
+  function ($ExceptionlessClient) {
+    this.submit = async function () {
+      await $ExceptionlessClient.submitLog("angularjs", "Hello world", "info");
+      await $ExceptionlessClient.submitFeatureUsage("DemoButton");
+    };
+  }
+]);
+```
+
+The AngularJS package decorates `$exceptionHandler` and `$log`, adds an HTTP response-error interceptor, and submits common route/state events.
+
+## Source Anchors
+
+- `packages/angularjs/README.md`
+- `packages/angularjs/src/index.ts`

.agents/skills/exceptionless-javascript/references/client-browser.md

@@ -0,0 +1,53 @@
+# @exceptionless/browser
+
+Use for vanilla browser apps, script-tag usage, Vite/browser bundles, and framework integrations that import the browser client directly.
+
+Docs: https://exceptionless.com/docs/clients/javascript/
+
+## Install
+
+```bash
+npm install @exceptionless/browser --save
+```
+
+CDN:
+
+```html
+<script type="module">
+  import { Exceptionless } from "https://unpkg.com/@exceptionless/browser";
+
+  await Exceptionless.startup("API_KEY_HERE");
+</script>
+```
+
+## Configure
+
+```js
+import { Exceptionless } from "@exceptionless/browser";
+
+await Exceptionless.startup((config) => {
+  config.apiKey = "API_KEY_HERE";
+  config.version = "1.2.3";
+  config.setUserIdentity("12345678", "Blake");
+  config.useSessions();
+  config.defaultTags.push("Example", "JavaScript", "Browser");
+});
+```
+
+## Send
+
+```js
+import { Exceptionless } from "@exceptionless/browser";
+
+await Exceptionless.startup("API_KEY_HERE");
+await Exceptionless.submitLog("browser", "Hello world", "info");
+await Exceptionless.submitFeatureUsage("New Shopping Cart Feature");
+```
+
+The browser package wires global browser error/rejection capture on first startup. For privacy and self-hosted options, read [configuration.md](configuration.md) and [self-hosting.md](self-hosting.md).
+
+## Source Anchors
+
+- `packages/browser/README.md`
+- `packages/browser/src/BrowserExceptionlessClient.ts`
+- `packages/browser/src/plugins/BrowserGlobalHandlerPlugin.ts`

.agents/skills/exceptionless-javascript/references/client-core.md

@@ -0,0 +1,47 @@
+# @exceptionless/core
+
+Use for custom runtimes, tests, or advanced pipelines that do not need browser or Node automatic capture.
+
+Docs: https://exceptionless.com/docs/clients/javascript/
+
+## Install
+
+```bash
+npm install @exceptionless/core --save
+```
+
+## Configure
+
+```js
+import { ExceptionlessClient } from "@exceptionless/core";
+
+const client = new ExceptionlessClient();
+
+await client.startup((config) => {
+  config.apiKey = "API_KEY_HERE";
+  config.version = "1.2.3";
+  config.setUserIdentity("12345678", "Blake");
+  config.defaultTags.push("Example", "JavaScript", "Core");
+  config.defaultData["deployment"] = { environment: "production" };
+});
+```
+
+## Send
+
+```js
+import { ExceptionlessClient } from "@exceptionless/core";
+
+const client = new ExceptionlessClient();
+await client.startup("API_KEY_HERE");
+await client.submitLog("custom-runtime", "Hello world", "info");
+await client.submitFeatureUsage("New Shopping Cart Feature");
+```
+
+For full event examples, read [sending-events.md](sending-events.md). For all configuration patterns, read [configuration.md](configuration.md).
+
+## Source Anchors
+
+- `packages/core/README.md`
+- `packages/core/src/ExceptionlessClient.ts`
+- `packages/core/src/configuration/Configuration.ts`
+- `packages/core/src/EventBuilder.ts`

.agents/skills/exceptionless-javascript/references/client-node.md

@@ -0,0 +1,77 @@
+# @exceptionless/node
+
+Use for Node.js scripts, CLIs, workers, Express, Next.js server runtime, SvelteKit server hooks, and serverless functions.
+
+Docs:
+
+- Node: https://exceptionless.com/docs/clients/javascript/node-example/
+- Express: https://exceptionless.com/docs/clients/javascript/guides/express/
+
+## Install
+
+```bash
+npm install @exceptionless/node --save
+```
+
+## Configure
+
+```js
+import { Exceptionless } from "@exceptionless/node";
+
+await Exceptionless.startup((config) => {
+  config.apiKey = process.env.EXCEPTIONLESS_API_KEY ?? "API_KEY_HERE";
+  config.version = process.env.npm_package_version ?? "0.0.0";
+  config.defaultTags.push("Example", "JavaScript", "Node");
+});
+```
+
+## Send
+
+```js
+import { Exceptionless } from "@exceptionless/node";
+
+await Exceptionless.startup("API_KEY_HERE");
+await Exceptionless.submitLog("node", "Hello world", "info");
+await Exceptionless.submitFeatureUsage("WorkerStarted");
+```
+
+## Express Sketch
+
+```js
+import { Exceptionless, KnownEventDataKeys, toError } from "@exceptionless/node";
+import express from "express";
+
+await Exceptionless.startup("API_KEY_HERE");
+
+const app = express();
+
+app.use(async (error, req, res, next) => {
+  if (res.headersSent) {
+    next(error);
+    return;
+  }
+
+  await Exceptionless.createUnhandledException(toError(error), "express")
+    .setContextProperty(KnownEventDataKeys.RequestInfo, req)
+    .submit();
+
+  res.status(500).send("Something broke");
+});
+```
+
+For short-lived scripts, route handlers, and serverless work, flush after critical submissions:
+
+```js
+import { Exceptionless } from "@exceptionless/node";
+
+await Exceptionless.processQueue();
+```
+
+## Source Anchors
+
+- `packages/node/README.md`
+- `packages/node/src/NodeExceptionlessClient.ts`
+- `packages/node/src/plugins/NodeGlobalHandlerPlugin.ts`
+- `packages/node/src/plugins/NodeRequestInfoPlugin.ts`
+- `example/express/app.js`
+- `example/nextjs/README.md`

.agents/skills/exceptionless-javascript/references/client-react.md

@@ -0,0 +1,61 @@
+# @exceptionless/react
+
+Use for React web apps. This package re-exports the browser client and adds `ExceptionlessErrorBoundary`.
+
+Docs: https://exceptionless.com/docs/clients/javascript/guides/react/
+
+## Install
+
+```bash
+npm install @exceptionless/react --save
+```
+
+## Configure
+
+```jsx
+import { Component } from "react";
+import { Exceptionless, ExceptionlessErrorBoundary } from "@exceptionless/react";
+
+class App extends Component {
+  async componentDidMount() {
+    await Exceptionless.startup((config) => {
+      config.apiKey = "API_KEY_HERE";
+      config.setUserIdentity("12345678", "Blake");
+      config.defaultTags.push("Example", "React");
+    });
+  }
+
+  render() {
+    return (
+      <ExceptionlessErrorBoundary>
+        <div>Application content</div>
+      </ExceptionlessErrorBoundary>
+    );
+  }
+}
+```
+
+## Send
+
+```js
+import { Exceptionless, toError } from "@exceptionless/react";
+
+await Exceptionless.startup("API_KEY_HERE");
+
+try {
+  throw new Error("Profile save failed");
+} catch (error) {
+  await Exceptionless.submitException(toError(error));
+}
+
+await Exceptionless.submitLog("react", "Hello world", "info");
+await Exceptionless.submitFeatureUsage("New Shopping Cart Feature");
+```
+
+React error boundaries do not catch event handler, async, or manually swallowed errors. Submit those explicitly.
+
+## Source Anchors
+
+- `packages/react/README.md`
+- `packages/react/src/ExceptionlessErrorBoundary.tsx`
+- `example/react/src/App.jsx`