CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

phoenix-client-development

Development guide for the @arizeai/phoenix-client TypeScript SDK — run and resume experiments, manage OpenTelemetry tracer providers with stack-based attach/detach, and write vitest unit and integration tests. Use when adding features to phoenix-client, debugging experiment lifecycle or provider cleanup, modifying dataset/prompt/session/span APIs, or writing tests for the js/packages/phoenix-client/ directory.

79

1.21x
Quality

85%

Does it follow best practices?

Impact

92%

1.21x

2 of 3 eval scenarios. Add 1 more for a full score.

SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

65%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.

The body is admirably lean and free of padding, and its rule-file table is a well-designed progressive-disclosure index in intent. However, the four referenced rule files are absent from the bundle, leaving the skill with only one executable command and no sequenced development workflow — the detailed guidance the structure promises is unreachable.

Suggestions

Include the four referenced rule files (rules/experiments.md, rules/prompts.md, rules/tracing.md, rules/testing.md) in the bundle, or inline their key guidance into SKILL.md so the pointer table resolves to real content.

Add an explicit ordered workflow for typical changes — e.g. read the relevant rule file, read existing code in the target module, write the change, run 'pnpm --filter phoenix-client test' to validate, fix and re-run on failure — so validation is a checkpoint rather than an afterthought.

Add one short executable code example (e.g. a minimal vitest test or a typical SDK API call) so the build/test section demonstrates the pattern a developer should follow, not just the command to run.

DimensionReasoningScore

Conciseness

The ~35-line body is lean with zero padding: 'TypeScript SDK for Phoenix AI observability: datasets, experiments, prompts, sessions, spans, traces.' and 'Read existing code in the directory you're working in before writing new code.' each convey only non-obvious, project-specific information. Every token earns its place and nothing explains concepts Claude already knows, matching the 5 anchor exactly.

5 / 5

Actionability

There is one fully executable command ('pnpm --filter phoenix-client test') and concrete test conventions ('Test files live in test/ named *.test.ts'), but the actual development guidance is delegated to four rules/*.md files that are not present in the bundle, so key details are missing. This fits the 3 anchor ('some concrete guidance but incomplete... missing key details') better than the 4 anchor, which presumes only minor gaps in executable guidance.

3 / 5

Workflow Clarity

The workflow is only implied: 'Read existing code... before writing new code' plus a test command, with no explicit step sequence and no validation checkpoint beyond running tests. This matches the 3 anchor ('sequence present but checkpoints missing or implicit'); it does not merit 4 because the steps are not enumerated as an ordered process with verification gates.

3 / 5

Progressive Disclosure

The 'Rule Files' table with a 'When to read' column is well-signaled and one level deep in form, but the referenced files (rules/experiments.md, rules/prompts.md, rules/tracing.md, rules/testing.md) do not exist in the bundle, so the disclosure chain cannot actually be followed. Scored against the actual bundle structure, this lands at the 3 anchor — structure and references exist but navigation is broken — rather than 4 or 5, which require references that resolve.

3 / 5

Total

14

/

20

Passed

Description

100%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.

The description is excellent: it names concrete capabilities in third person, includes an explicit and specific 'Use when...' trigger clause with natural user phrasing, and is tightly scoped to a single SDK and directory so conflict risk is minimal. It matches the rubric's good_overall_examples pattern closely, with no padding or over-claims.

DimensionReasoningScore

Specificity

Quotes multiple specific concrete actions — 'run and resume experiments', 'manage OpenTelemetry tracer providers with stack-based attach/detach', and 'write vitest unit and integration tests' — giving comprehensive coverage of the SDK's development surface. It clearly matches the 5 anchor ('lists multiple specific concrete actions; comprehensive coverage') rather than the 4 anchor, which would require minor gaps in coverage.

5 / 5

Completeness

Both questions are answered explicitly: the 'what' ('Development guide for the @arizeai/phoenix-client TypeScript SDK — run and resume experiments, manage OpenTelemetry tracer providers...') and a concrete 'Use when' clause with multiple trigger scenarios. This is a direct match for the 5 anchor with concrete trigger phrases; the 4 anchor would require a less explicit or less specific 'when'.

5 / 5

Trigger Term Quality

Natural trigger phrases are comprehensive and include synonyms and path identifiers: 'adding features to phoenix-client', 'debugging experiment lifecycle or provider cleanup', 'modifying dataset/prompt/session/span APIs', and 'writing tests for the js/packages/phoenix-client/ directory'. This matches the 5 anchor (comprehensive natural terms including synonyms and file paths); it is not the 4 anchor because no common user phrasing for this SDK is obviously missing.

5 / 5

Distinctiveness Conflict Risk

The description is scoped to one named package ('@arizeai/phoenix-client') and one directory ('js/packages/phoenix-client/'), giving it a clear niche with distinct triggers and minimal conflict risk. It matches the 5 anchor; even the 4 anchor's 'minor overlap risk with closely related skills' is not present, since no other skill would claim this exact SDK and directory.

5 / 5

Total

20

/

20

Passed

Validation

93%

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

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_field

'metadata' should map string keys to string values

Warning

Total

15

/

16

Passed

Repository

Arize-ai/phoenix

Path

js/packages/phoenix-client/.agents/skills/phoenix-client-development/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.