CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

phoenix-server

Backend development guide for the Phoenix AI observability platform (Strawberry GraphQL, SQLAlchemy async, FastAPI). Use this skill when writing or modifying Python server code in the phoenix repo — adding mutations, types, migrations, or tests. Trigger on any backend task touching src/phoenix/server/, src/phoenix/db/, or tests/unit/server/.

70

Quality

88%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

86%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

An exemplary router/orientation skill: dense with non-inferable project knowledge, well-structured navigation into verified one-level-deep references, and no filler. The only refinement space is sequencing the everyday commands into an explicit change→validate workflow and possibly inlining one minimal mutation example.

Suggestions

Add a short ordered workflow (e.g. edit → make format → make typecheck-python → uv run pytest path/to/test) so validation commands become explicit checkpoints rather than an unordered list.

Consider inlining a minimal skeleton of one mutation (or pointing to it by section name the way the Hard Rules do) so the most common task has a concrete starting template without opening a reference.

DimensionReasoningScore

Conciseness

Every line carries project-specific knowledge Claude could not infer (memoized startup shortcuts, import side effects, daemon-test patterns, naming conventions) with zero padding or explanation of known concepts. Commands are given bare with inline comments only where they add facts. Matches the "lean and efficient; every token earns its place" anchor.

5 / 5

Actionability

Copy-paste-ready commands ("make dev-backend", "uv run pytest path/to/test -n auto", "make graphql") and concrete before/after naming examples ("createThing, patchThing, setThing, deleteThing — not applyThingChanges"). Not a 5 because the body itself contains no code template; the templates are delegated to the reference files, so a reader must hop to a reference for the common case of writing a mutation.

4 / 5

Workflow Clarity

The "What Are You Doing?" routing table gives an unambiguous task→reference decision sequence, and validation commands (tests, make typecheck-python, make format) are listed up front. Not a 5 because the body never sequences these into an explicit step order or feedback loop (e.g. change → format → typecheck → test), though as a router skill its real workflows live in the well-structured references.

4 / 5

Progressive Disclosure

A clear overview with a task→reference table pointing one level deep to four real files (graphql-patterns.md, test-patterns.md, llm-trace-tests.md, database-patterns.md), each existing in the bundle with the cited section headers verified present ("Query vs Mutation", "Naming: use the HTTP verb", "Waiting on Daemons", "Startup Shortcuts"). Inlined content is appropriately the hard rules and orientation; details correctly live in references.

5 / 5

Total

18

/

20

Passed

Description

87%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A strong description: third-person, concise, with an explicit and concrete trigger clause anchored to specific directories. Minor gains available only by naming a few more task verbs (subscriptions, REST endpoints) or natural synonyms.

DimensionReasoningScore

Specificity

Names the domain and several concrete actions — "adding mutations, types, migrations, or tests" — with a specific tech stack (Strawberry GraphQL, SQLAlchemy async, FastAPI). Not a 5 because common backend tasks like subscriptions, REST routers, and dataloaders are not mentioned, leaving minor coverage gaps.

4 / 5

Completeness

Explicitly answers both: what ("Backend development guide for the Phoenix AI observability platform...") and when ("Use this skill when writing or modifying Python server code in the phoenix repo... Trigger on any backend task touching src/phoenix/server/, src/phoenix/db/, or tests/unit/server/"). The trigger clause is concrete and path-anchored, matching the 5 anchor exactly.

5 / 5

Trigger Term Quality

Good natural keyword coverage: "backend task", "Python server code", "mutations", "types", "migrations", "tests", plus concrete directory paths. A few natural terms a user might say are missing (e.g. "GraphQL", "API", "database"), which keeps it below the comprehensive-synonym anchor of 5.

4 / 5

Distinctiveness Conflict Risk

Clear niche (Phoenix backend) with distinct triggers pinned to repo-specific directories, making conflict with other skills very unlikely. Matches the "clear niche with distinct triggers; minimal conflict risk" anchor.

5 / 5

Total

18

/

20

Passed

Validation

87%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_version

'metadata.version' is missing

Warning

metadata_field

'metadata' should map string keys to string values

Warning

Total

14

/

16

Passed

Repository

Arize-ai/phoenix

Path

.agents/skills/phoenix-server/SKILL.md

Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.