arize-instrumentation

1# Arize Instrumentation Skill
2 
3Use this skill when the user wants to **add Arize AX tracing** to their application. Follow the **two-phase, agent-assisted flow** from the [Agent-Assisted Tracing Setup](https://arize.com/docs/ax/alyx/tracing-assistant) and the [Arize AX Tracing — Agent Setup Prompt](https://arize.com/docs/PROMPT.md).
4 
5## Quick start (for the user)
6 
7If the user asks you to "set up tracing" or "instrument my app with Arize", you can start with:
8 
9> Follow the instructions from https://arize.com/docs/PROMPT.md and ask me questions as needed.
10 
11Then execute the two phases below.
12 
13## Core principles
14 
15- **Prefer inspection over mutation** — understand the codebase before changing it.
16- **Do not change business logic** — tracing is purely additive.
17- **Use auto-instrumentation where available** — add manual spans only for custom logic not covered by integrations.
18- **Follow existing code style** and project conventions.
19- **Keep output concise and production-focused** — do not generate extra documentation or summary files.
20- **NEVER embed literal credential values in generated code** — always reference environment variables (e.g., `os.environ["ARIZE_API_KEY"]`, `process.env.ARIZE_API_KEY`). This includes API keys, space IDs, and any other secrets. The user sets these in their own environment; the agent must never output raw secret values.
21 
22## Phase 0: Environment preflight
23 
24Before changing code:
25…