---
name: Moda Claude Code skill
description: Let AI integrate Moda into your codebase automatically.
---

# Moda Claude Code skill

The Moda Claude Code skill teaches AI coding assistants how to integrate Moda's LLM observability SDK into TypeScript or Python projects. It detects the project stack and LLM provider, chooses the right initialization and conversation strategy, and configures telemetry.

## When to use

Use this skill when a project needs Moda observability, conversation tracking, or LLM analytics for OpenAI, Anthropic, a supported framework, or a generic TypeScript/Python LLM application.

## How to use

Prerequisites: Claude Code must be available in the terminal and the project needs a Moda API key from the Moda dashboard.

Install the SDK that matches the application:

```bash
# TypeScript / Node.js
npm install moda-ai

# Python
pip install moda-ai
```

For a Claude Agent SDK integration, install the separate Python instrumentation package:

```bash
pip install moda-claude-agent-sdk
```

Install the skill per project by placing the skill files under `.claude/skills/moda-setup/`:

```bash
mkdir -p .claude/skills
cp -r path/to/moda-setup/ .claude/skills/moda-setup/
```

Then ask Claude Code to add Moda observability, integrate LLM analytics, or set up conversation tracking. The skill should detect the framework, initialize Moda at the correct entry point, choose an explicit conversation ID for agent frameworks, and add a cleanup `flush()`.

Authoritative guide: https://docs.moda.dev/ingestion/claude-code-skill