Skip to main content

Agent skills

View as Markdown

Overview​

The library repository ships an Agent Skill for AI coding assistants, such as Claude Code, Codex, Cursor, and GitHub Copilot. A skill is a folder with instructions and scripts that the assistant loads when a task needs it. The skill gives the assistant the library's own rules instead of guesses from training data.

Datafeed skill​

The charting-library-datafeed skill covers connecting market data to the library. It explains the Datafeed API and the UDF adapter, and covers symbology, trading sessions, resolutions, real-time updates and reconnects, quotes for Trading Platform, and the common issues listed in Datafeed: common issues. It also covers saving and loading and customization precedence, which often come up next to datafeed work.

The skill tells the assistant to answer a datafeed question in one of three ways:

  • Name the existing feature, featureset, or property that does what the user needs.
  • State plainly that the library does not support the requested behavior, and give a workaround if one exists.
  • Find the datafeed rule the implementation breaks, fix it, and prove the fix with the checker.

Datafeed checker​

The skill includes scripts/check-datafeed.mjs, a script that calls your datafeed the same way the library does and reports every violation it finds. Each finding names the rule, the symptom you would see on the chart, and the documentation page that explains it.

The script requires Node.js 18 or later and has no dependencies. You can run it against a datafeed module or a UDF server:

# A datafeed module that exports the datafeed object, a factory function, or a class
node .agents/skills/charting-library-datafeed/scripts/check-datafeed.mjs --datafeed ./src/datafeed.js --symbol AAPL

# A server that implements the UDF protocol
node .agents/skills/charting-library-datafeed/scripts/check-datafeed.mjs --udf https://your-server.example.com --symbol AAPL

If your datafeed only runs in the browser, wrap it before you pass it to the Widget Constructor. The wrapper does not change the datafeed's behavior. It checks every request the library makes and logs violations to the console:

import { createCheckedDatafeed } from './.agents/skills/charting-library-datafeed/scripts/datafeed-check/index.mjs';

new TradingView.widget({
    // ...
    datafeed: createCheckedDatafeed(datafeed),
});

Run the script with --help to see all options.

Install the skill​

The skill is located in the .agents/skills/charting-library-datafeed folder of the library repository 🔐 (restricted access). The commands on this page assume the skill is in .agents/skills/ of your project; adjust the path if you install it elsewhere.

Install it into your project with the skills CLI. It uses your Git access to the repository:

npx skills add tradingview/charting_library --skill charting-library-datafeed

For Trading Platform, use tradingview/trading_platform instead. You can also copy the folder by hand, for example to .claude/skills/ for Claude Code or .agents/skills/ for other agents. Installing the library as an npm package does not include the skill.

The skill in the repository always matches the library version in that repository. If you update the library, update the skill as well.