AI Agents

TrackJS publishes an Agent Skill that teaches AI coding agents how to use the TrackJS Data API. With the skill installed, you can ask your agent for your top errors, an investigation of an error spike, or an export of errors for a date range. The agent knows the endpoints, the paging and sorting rules, and which endpoint answers which question, so you do not need to paste the API reference into a prompt.

The skill is a single markdown file. You can read the skill exactly as an agent sees it, or download the raw file.

What the skill does

The skill covers the read endpoints of the Data API. That includes individual errors, errors grouped by day, hour, message, and URL, page views by day and hour, and account usage by hour. It explains paging, sorting, and the difference between count and userCount, and it walks the agent through four common workflows. Those are finding the top errors by user impact, investigating an error spike, computing error rate over time, and exporting every error in a date range.

The agent will ask you for your Customer ID and API Key the first time it needs them. Both are only visible to Account Owners in your Account Settings. The skill tells the agent never to log or echo the API Key.

Install in Claude Code

Claude Code loads skills from a folder named after the skill that contains a SKILL.md file. A personal skill lives in your home directory and applies to every project on your machine.

mkdir -p ~/.claude/skills/trackjs-data-api
curl -o ~/.claude/skills/trackjs-data-api/SKILL.md https://docs.trackjs.com/ai/skills/trackjs-data-api/SKILL.md
Install as a personal skill

A project skill lives inside the repository and is shared with everyone who clones it.

mkdir -p .claude/skills/trackjs-data-api
curl -o .claude/skills/trackjs-data-api/SKILL.md https://docs.trackjs.com/ai/skills/trackjs-data-api/SKILL.md
Install as a project skill

Claude Code picks up the skill the next time it starts. See the Claude Code skills documentation for more on how skills load.

Install in claude.ai

Skills installed in Claude Code do not automatically apply in claude.ai. Custom skills upload to claude.ai as a zip file from Settings, on Pro, Max, Team, and Enterprise plans with code execution enabled.

  1. Download the raw skill file into a folder named trackjs-data-api.
  2. Zip the folder.
  3. In claude.ai, open Settings, find Skills, and upload the zip.

See the Agent Skills documentation for the current upload steps.

Other agents

The skill follows the open Agent Skills format, which many agents support, including Cursor, Codex, Gemini CLI, GitHub Copilot, VS Code, and OpenCode. Each tool has its own skills folder. The Agent Skills client list links to the install instructions for each one.

Try it

Once the skill is installed, ask your agent about your TrackJS data in plain language. Some prompts to start with:

What are my top errors by user impact this week?
Errors spiked yesterday afternoon. What caused it?
Show the error rate per day for the last 30 days.
Export every error from the checkout application for September to a CSV file.
Example prompts

Every result the API returns includes a link into the TrackJS dashboard, so the agent can hand you a report where each error opens directly in TrackJS.