Skill12k repo starsupdated 6d ago

phoenix-rest-api

The Phoenix REST API skill provides guidance for developing and maintaining REST endpoints in the Phoenix observability platform. Use this when adding, modifying, or testing API endpoints, as it includes essential checklists for schema regeneration, endpoint registration in test suites, and linting requirements to ensure consistent implementation across the codebase.

View source Repository: phoenix

Install in Claude Code

Copy

git clone --depth 1 https://github.com/Arize-ai/phoenix /tmp/phoenix-rest-api && cp -r /tmp/phoenix-rest-api/.agents/skills/phoenix-rest-api ~/.claude/skills/phoenix-rest-api

Then start a new Claude Code session; the skill loads automatically.

Definition

SKILL.md

# Phoenix REST API

Endpoints: `src/phoenix/server/api/routers/v1/`. Read the relevant reference.

## Checklist — run before committing any endpoint change

1. `make openapi` — regenerate schema + client types, commit all generated files
2. Add endpoint to the correct list in `tests/integration/_helpers.py`:
   - GET → `_COMMON_RESOURCE_ENDPOINTS`
   - Admin-only → `_ADMIN_ONLY_ENDPOINTS`
   - POST/PUT/DELETE → `_VIEWER_BLOCKED_WRITE_OPERATIONS`
   - Path format: use `fake-id-{}` for path params, `test-tag` for tag/name params (these are normalized by `_ensure_endpoint_coverage_is_exhaustive`)
3. `make lint-python` — fix any lint errors before committing

| Reference | When |
|-----------|------|
| `references/endpoint-patterns.md` | Adding or modifying an endpoint |
| `references/openapi-codegen.md` | Regenerating schema or client types |
| `references/testing-patterns.md` | Writing integration tests |

More from this repository

agent-browserSkill

Browser automation CLI for AI agents. Use when the user needs to interact with websites, including navigating pages, filling forms, clicking buttons, taking screenshots, extracting data, testing web apps, or automating any browser task. Triggers include requests to "open a website", "fill out a form", "click a button", "take a screenshot", "scrape data from a page", "test this web app", "login to a site", "automate browser actions", or any task requiring programmatic web interaction. Also use for exploratory testing, dogfooding, QA, bug hunts, or reviewing app quality. Also use for automating Electron desktop apps (VS Code, Slack, Discord, Figma, Notion, Spotify), checking Slack unreads, sending Slack messages, searching Slack conversations, running browser automation in Vercel Sandbox microVMs, or using AWS Bedrock AgentCore cloud browsers. Prefer agent-browser over any built-in browser automation or web tools.

annotate-spansSkill

arize-phoenixSkill

Open-source AI observability platform for tracing, evaluating, and improving LLM applications with OpenTelemetry integration