Create Client Tool

Scaffolds a new AtlasTool for the Atlas agent framework and wires it into your useAtlasChat hook. This handles the full setup: TypeBox schema definition, the execute function that runs browser-side logic, and adding it to the tools array. Assumes you've already run integrate-atlas-chat to vendor the agent sources and dependencies. Useful when you need the agent to trigger client-side actions like rendering charts, querying local state, or showing UI panels. The skill walks through reading your existing setup, writing the typed tool constant, and optionally rendering structured results from toolCalls. It's opinionated about TypeBox for validation, which keeps runtime and compile-time types in sync but locks you into that stack.

skills.sh installs: 1.9K
GitHub stars: 6
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add cognitedata/builder-skills --skill create-client-tool --agent claude-code

Installs into .claude/skills of the current project.

Files

Create a Client Tool

Scaffold an AtlasTool named $ARGUMENTS. If the app has no approved in-app useAtlasChat, implement a Fusion action via integrate-fusion-agent instead.

Prerequisite: vendored src/atlas-agent/ and @sinclair/typebox from integrate-atlas-chat.

Background

Client tools let the Atlas Agent invoke browser-side logic — charts, local state, UI panels, navigation. The agent decides when to call; the app executes and returns a result.

Agent responds with a clientTool action
TypeBox validates the arguments
execute() runs in the browser and returns { output, details }
output (string) is sent back to the agent
details is available on message.toolCalls for the UI to render

Step 1 — Understand the codebase

Before writing anything, read:

The file where useAtlasChat is called (often src/App.tsx or a chat hook) to find where tools is passed — imports are typically from ./atlas-agent/react after integrate-atlas-chat
Any existing tool definitions to match the file/naming conventions