CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

phoenix-frontend

Frontend development guidelines for the Phoenix AI observability platform. Use when writing, reviewing, or modifying React components, TypeScript code, styles, or UI features in the js/app/ directory. Triggers on any frontend task — new components, UI changes, styling, accessibility fixes, form handling, or component refactoring. Also use when the user asks about frontend conventions or component patterns for this project. For design system rules (error display, layout, dialogs, tokens), use the phoenix-design skill.

72

Quality

91%

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 rule-based skill body: token-efficient, organized by scenario, with precise API/path-level guidance and a well-structured reference table pointing to real, one-level-deep bundle files. The residual gaps are minor — a couple of directives ('verify with browser tooling', 'preserve URL state') remain high-level without a concrete example.

Suggestions

In the Verification section, name a concrete verification action (e.g., which browser tool command or what to check) instead of the generic 'use the available browser tooling'.

Add a 3-4 line example of a handle.agentRoute metadata object in Routes.tsx so the Route Metadata rule is copy-paste-ready rather than field-name-only.

Show one concrete URL-state pattern (e.g., a route/search param mapping for a selected tab) to make the URL State section executable rather than directional.

DimensionReasoningScore

Conciseness

Lean and efficient throughout: short sections of project-specific rules with no explanation of concepts Claude already knows (no React/Relay primers, no padding). Every token carries a project-specific instruction, matching the 5 anchor; it is clearly above the 4 anchor's 'minor instances of over-explanation'.

5 / 5

Actionability

Names exact, executable targets: 'useAgentDataChangeFetchKey from @phoenix/hooks in the query owner', 'handle.agentRoute metadata in js/app/src/Routes.tsx' with field-level detail ('label', 'description'), and 'encode it in route params or search params'. It sits between anchors: mostly executable with minor gaps (4) rather than fully copy-paste-ready (5) — phrases like 'use the available browser tooling to verify' and 'preserve the relevant URL state' give direction without a concrete example or command.

4 / 5

Workflow Clarity

An explicit starting step ('Before starting work, explore js/app/src/components/ and js/app/package.json… then follow these rules') plus scenario-conditioned rules and a verification section give a clear structure with most checkpoints present (4). Not a 5 because it is a rule collection rather than a sequenced workflow — there are no explicit feedback/recovery checkpoints — and not a 3 because the per-section when/what pairs are unambiguous and validation guidance ('use the available browser tooling to verify the UI looks correct', 'check its usages across the app') is present.

4 / 5

Progressive Disclosure

A concise overview body with a 'when to read' table cleanly mapping all five real reference files (components.md, relay.md, accessibility.md, test-ids.md, resize-svg-logo-assets.md) to task conditions, references exactly one level deep (verified: reference files point only to the bundled script, not to further .md files), and out-of-scope areas delegated to sibling skills (phoenix-storybook, phoenix-design). Matches the 5 anchor's clear overview with well-signaled one-level-deep references.

5 / 5

Total

18

/

20

Passed

Description

95%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: it states what the skill covers, gives explicit and varied 'use when' triggers including a catch-all, scopes itself to a directory in a named project, and cleanly delegates adjacent scope to a sibling skill. The only soft spot is that the 'what' is framed as general 'guidelines' rather than enumerated capabilities. Suggestions are minor.

DimensionReasoningScore

Specificity

Lists several concrete actions — 'writing, reviewing, or modifying React components, TypeScript code, styles, or UI features' plus 'new components, UI changes, styling, accessibility fixes, form handling, or component refactoring' — matching the 'several specific actions; minor gaps' anchor. It falls short of the 5 anchor because the framing 'Frontend development guidelines' is slightly generic relative to 'multiple specific concrete actions; comprehensive coverage', and it is above the 3 anchor which expects only 1-2 concrete actions.

4 / 5

Completeness

Explicitly answers both: what ('Frontend development guidelines for the Phoenix AI observability platform') and when ('Use when writing, reviewing, or modifying…', 'Triggers on any frontend task…', 'Also use when the user asks about frontend conventions or component patterns'). Clearly matches the 5 anchor with concrete trigger phrases; the 4 anchor applies only when 'when' is less explicit.

5 / 5

Trigger Term Quality

Comprehensive natural-term coverage with synonyms: 'new components', 'UI changes', 'styling', 'accessibility fixes', 'form handling', 'component refactoring', 'frontend conventions', 'component patterns', plus concrete anchors like 'React', 'TypeScript', and 'js/app/ directory'. Not the 4 anchor because it goes beyond 'a few natural terms missing' — the enumerated trigger list and the 'any frontend task' catch-all cover the domain's common phrasings.

5 / 5

Distinctiveness Conflict Risk

Clear niche scoped to a named platform and directory ('js/app/'), with explicit boundary guidance diverting design-system rules to the 'phoenix-design' skill. Distinct triggers ('React components', 'TypeScript', 'data-testid'-adjacent a11y work) and minimal conflict risk, matching the 5 anchor; it is well above the 3/4 anchors' residual overlap concern.

5 / 5

Total

19

/

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-frontend/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.