Drafting 1st version of lightningchart-js skill

Author: Niilo Keinänen

.github/workflows/validate-skill.yml

@@ -0,0 +1,22 @@
+name: Validate skill
+
+on:
+  pull_request:
+  push:
+    branches:
+      - master
+
+jobs:
+  validate:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Check out repository
+        uses: actions/checkout@v4
+
+      - name: Set up Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: 22
+
+      - name: Validate Agent Skill
+        run: npx skills-ref validate ./lightningchart-js

LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2026 LightningChart
+Copyright (c) 2026 LightningChart Ltd.
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

README.md

@@ -0,0 +1,57 @@
+# LightningChart JS Agent Skill
+
+An Agent Skill for building with LightningChart JS accurately in AI coding
+agents.
+
+The skill teaches agents to start every LightningChart JS task from the
+official LLM-friendly documentation indexes, then follow the exact
+task-specific documentation and API URLs found there. This helps prevent
+hallucinated method names, stale package names, wrong option shapes, and API
+patterns copied from unrelated charting libraries.
+
+## Installation
+
+Copy the `lightningchart-js` folder into a skills directory supported by your
+agent.
+
+Project-local Agent Skills location:
+
+```text
+.agents/skills/lightningchart-js/
+```
+
+OpenAI Codex local skills location:
+
+```text
+~/.codex/skills/lightningchart-js/
+```
+
+Windows PowerShell example for Codex:
+
+```powershell
+Copy-Item -Recurse .\lightningchart-js $env:USERPROFILE\.codex\skills\
+```
+
+VS Code and other Agent Skills compatible tools can also use this skill from a
+project-local `.agents/skills/lightningchart-js/` directory.
+
+## Example Prompts
+
+```text
+Use $lightningchart-js to add a real-time line chart to this React component.
+```
+
+```text
+Use $lightningchart-js to review this chart implementation for outdated or hallucinated LCJS APIs.
+```
+
+```text
+Use $lightningchart-js to migrate this existing chart to LightningChart JS and verify the API usage with local type checks if possible.
+```
+
+## License
+
+This Agent Skill is licensed under the MIT License.
+
+LightningChart JS is separate proprietary software with its own licensing terms:
+https://lightningchart.com/js-charts/

lightningchart-js/SKILL.md

@@ -0,0 +1,68 @@
+---
+name: lightningchart-js
+description: >
+  Use LightningChart JS to build accurate high-performance charts, graphs,
+  dashboards, and data visualizations in JavaScript or TypeScript. Activate
+  when working with LightningChart, LCJS, real-time data, large datasets,
+  financial charts, scientific visualization, WebGL charting, or any task that
+  adds or modifies charting/data visualization code.
+license: MIT
+compatibility: Requires internet access or locally cached copies of the LightningChart JS LLM documentation indexes.
+metadata:
+  author: LightningChart Ltd
+  version: "1.0"
+  docs: https://lightningchart.com/js-charts/docs/
+---
+
+## Purpose
+
+Use this skill to work with LightningChart JS without relying on stale model
+training data. LightningChart JS is a WebGL-accelerated JavaScript charting
+library for high-performance rendering of large datasets, real-time streams,
+financial charts, dashboards, and scientific visualization.
+
+## Mandatory Source Of Truth
+
+Always use these two LLM index files as the source of truth for
+LightningChart JS usage:
+
+- Documentation index: https://lightningchart.com/js-charts/docs/llms.txt
+- API index: https://lightningchart.com/js-charts/api-documentation/v8.3.1/llms.txt
+
+These files are indexes. Read them to find the exact task-specific
+documentation or API reference URL, then read that specific referenced page
+before making assumptions how LCJS API works.
+
+NEVER guess LCJS APIs, method names, constructor options, enum names,
+configuration objects, import paths, or documentation URLs from memory.
+
+## Common Errors
+
+- Version matters. Prefer the URLs and API entries discovered from the supplied
+  v8.3.1 API index unless the user or project explicitly targets another LCJS
+  version.
+- The correct NPM package is `@lightningchart/lcjs`, NOT `@arction/lcjs`.
+  Always install using the latest tag with `npm i @lightningchart/lcjs@latest`
+  unless specified otherwise, but do not leave `latest` in `package.json`.
+- License key MUST be supplied to the `lightningChart()` function. Load it from
+  an environment variable according to practices utilized in the local
+  repository. Setup trial license information in advance like this:
+
+```ts
+lightningChart({
+    license: "...",
+    licenseInformation: {
+        appTitle: "LightningChart JS Trial",
+        company: "LightningChart Ltd."
+    },
+})
+```
+
+- Tell the user to write their license to the environment variable or download
+  their license from https://lightningchart.com/js-charts/
+- LCJS versions under v9.0 override the passed DIV `style.position`. If using
+  CSS, use `!important` syntax. If using JS, style after creating the chart.
+
+## Validation
+
+If possible, rely on local type checks to confirm correct LCJS API usage.

lightningchart-js/agents/openai.yaml

@@ -0,0 +1,7 @@
+interface:
+  display_name: "LightningChart JS"
+  short_description: "Accurate LightningChart JS charting guidance"
+  default_prompt: "Use $lightningchart-js to create high-performing and interactive data visualization components"
+
+policy:
+  allow_implicit_invocation: true