Coding agents
Give your coding agent Vela™'s skills, docs and llms.txt index, shipped inside the npm packages so they match the version you installed.
Vela™ and its UI kit ship what a coding agent needs to use them well, inside the npm packages, so the guidance always matches the installed version:
- Agent skills in the open Agent Skills format: short instructions an agent loads when a task matches them, with the rules that prevent the common mistakes and the checks that prove the work.
- The docs:
node_modules/@luxalgo/vela/docsandnode_modules/@luxalgo/vela-ui/docs. - An
llms.txtindex in each package, listing the skills, the guides and the reference. - The component manifest:
node_modules/@luxalgo/vela-ui/dist/manifest.json, every component's import, props, parts, settings and an example.
Install the skills
npx skills add LuxAlgo/Vela # from the repository, in any project
npx skills experimental_sync # or link the ones shipped in node_modulesexperimental_sync reads the packages your project depends on: installing @luxalgo/vela
brings the UI kit's skills along with Vela's own. Both commands come from the open-source
skills CLI and support the common coding agents.
| Skill | Package | For |
|---|---|---|
building-vela-charts | @luxalgo/vela | Charts and chart apps, data providers, indicators, themes, saved state |
using-vela-data-providers | @luxalgo/vela | The bundled providers, symbol routing, and a provider for any other source |
adding-vela-indicators | @luxalgo/vela | Built-in studies, Pine Script® through an engine, native indicators, scripting engines, new built-in studies |
using-vela-drawing-tools | @luxalgo/vela | The drawing toolbar, drawings from code, saving them, adding a tool to Vela |
extending-vela-with-plugins | @luxalgo/vela | Buttons, menu rows, side panels, overlays, chart types and renderer layers through the plugin SDK |
upgrading-vela | @luxalgo/vela | Moving a project from 0.9 to 0.10 (Upgrading) |
using-vela-ui-components | @luxalgo/vela-ui | Building UI with the kit's components |
theming-vela-ui | @luxalgo/vela-ui | Themes, tokens, component settings and part-by-part restyles (Theming) |
writing-vela-ui-components | @luxalgo/vela-ui | New components the theme can restyle (Writing a component) |
Point your agent at the packages
Agents that read an AGENTS.md file pick up a note like this one. npx @luxalgo/vela-ui add
offers to write the UI kit's part for you.
## Vela
Before writing chart code, read `node_modules/@luxalgo/vela/llms.txt`, and before writing UI
with the kit, `node_modules/@luxalgo/vela-ui/llms.txt`: they index the skills, guides and
reference of the installed versions.How the skills stay accurate
The skills live in the Vela repository next to the code they describe. Its test suite checks every skill against the Agent Skills specification and checks that every file a skill points an agent at ships in the package. Their examples are typechecked against the release.