CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

phoenix-tracing

OpenInference semantic conventions and instrumentation for Phoenix AI observability. Use when implementing LLM tracing, creating custom spans, or deploying to production.

64

Quality

80%

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

Fix and improve this skill with Tessl

tessl review fix ./.agents/skills/phoenix-tracing/SKILL.md
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.

An exemplary progressive-disclosure index: every link resolves to a real, one-level-deep reference file, organized by priority, category, and language. The main weaknesses are redundant organization (the category table, quick-reference listing, and prefix globs repeat each other) and workflows whose validation checkpoints are implicit rather than explicit.

Suggestions

Merge the 'Reference Categories' table, 'Quick Reference' listing, and 'Navigation Patterns' globs into a single categorized file index to remove the triple duplication of prefix/category information.

Make the workflow checkpoints explicit: replace 'Check Phoenix' with a concrete verification step (e.g., 'Verify spans appear in the Phoenix UI at http://localhost:6006, then troubleshoot via setup-{lang}') and add a validate/fix/retry loop to the production workflow since it covers batch operations.

Inline the 3-line Python/TypeScript quick-start (from references/setup-python.md) at the top of the body so the first action is copy-paste executable before navigating to references.

DimensionReasoningScore

Conciseness

The body presents the same organizational information three times: the "Reference Categories" priority table, the "Quick Reference" per-file listing, and the "Navigation Patterns" prefix globs (e.g., `references/setup-*` appears in both the table's `setup-*` prefix and the bash block). Mostly efficient with no concept-explaining padding, but this duplication could be tightened, which matches anchor 3 rather than the minor-trimming-only anchor 4.

3 / 5

Actionability

Guidance is concrete and executable for an index-style skill: exact file links with one-line descriptions, a numbered "Reading Order", and template workflows like "setup-{lang} → instrumentation-auto-{lang} → Check Phoenix". It is not 5 because some steps are underspecified — "Check Phoenix" names a checkpoint without saying how to check, and no copy-paste-ready command for the first concrete action (e.g., a one-line quick-start from references/setup-python.md) appears in the body.

4 / 5

Workflow Clarity

"Common Workflows" and "Reading Order" give clear sequences (setup → instrumentation-auto/manual → span type), but validation checkpoints are missing or implicit — "Check Phoenix" is the only checkpoint and it is unexplained, and workflows touching production batch processing contain no verify/fix/retry loop. This matches anchor 3 (sequence present but checkpoints implicit), not 4 (most checkpoints present).

3 / 5

Progressive Disclosure

The body is a clean overview: all 33 referenced files exist in references/, are one level deep, well-signaled with links and one-line descriptions, and organized by category/priority with prefixes and language variants. Spot-checks (setup-python.md, span-agent.md) confirm the referenced files are substantive, matching anchor 5; the only blemish — an oddly placed "Reference Files" subsection under category 7 — does not impair navigation.

5 / 5

Total

15

/

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 voice, concrete domain naming, and an explicit 'Use when' clause with three concrete triggers. The only notable gap is that some capabilities covered by the bundle (querying/analyzing traces, sessions, feedback) and common synonym terms are absent from the description itself.

DimensionReasoningScore

Specificity

"OpenInference semantic conventions and instrumentation for Phoenix AI observability" names the domain concretely, and "implementing LLM tracing, creating custom spans, or deploying to production" lists several specific actions with only minor gaps (querying/analyzing traces, sessions, and feedback are not mentioned). It falls between anchors 3 and 4 because the capabilities are framed partly as trigger activities rather than direct skill actions, which keeps it below the comprehensive anchor 5.

4 / 5

Completeness

It explicitly answers 'what' ("OpenInference semantic conventions and instrumentation for Phoenix AI observability") and 'when' with a concrete "Use when implementing LLM tracing, creating custom spans, or deploying to production" clause — matching the anchor-5 pattern of the good example. It is not 4 because the 'when' clause is already explicit and specific, not merely present-but-vague.

5 / 5

Trigger Term Quality

Natural terms users would say include "LLM tracing", "custom spans", "Phoenix", "AI observability", and "deploying to production" — good coverage that is clearly relevant rather than generic. It is not 5 because common variations and synonyms (e.g., "instrument", "telemetry", "monitoring LLM apps", "traces") are missing.

4 / 5

Distinctiveness Conflict Risk

"Phoenix" and "OpenInference" pin a clear niche with distinct triggers, so conflict risk with other skills is minimal. A generic phrase like "deploying to production" alone could overlap with deployment skills, but it is anchored by the specific product/domain names, keeping this above anchor 4.

5 / 5

Total

18

/

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

referenced_paths_exist

Referenced path issues: 6 missing

Warning

Total

15

/

16

Passed

Repository

Arize-ai/phoenix

Path

.agents/skills/phoenix-tracing/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.