CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

phoenix-rest-api

REST API development for Phoenix. Use when adding, modifying, or reviewing endpoints in src/phoenix/server/api/routers/v1/.

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

100%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 an exemplary lean skill file: a commit-gated checklist of exact commands, file paths, and test-registry identifiers, with all detail correctly pushed into three well-signaled reference files that exist and match their stated purpose. No dimension shows a gap against the highest anchors.

DimensionReasoningScore

Conciseness

The ~20-line body explains nothing Claude already knows and wastes no tokens: it opens with the endpoints path, a numbered checklist of exact commands, and a two-column reference table. Every line is operational, matching the lean anchor 5; anchor 4's "minor instances of over-explanation" do not exist here.

5 / 5

Actionability

Guidance is fully executable: exact commands ("make openapi", "make lint-python"), the exact file to edit ("tests/integration/_helpers.py"), the exact list names (_COMMON_RESOURCE_ENDPOINTS, _ADMIN_ONLY_ENDPOINTS, _VIEWER_BLOCKED_WRITE_OPERATIONS), and path-parameter conventions ("fake-id-{}", "test-tag"). Copy-paste ready with no gaps, matching anchor 5.

5 / 5

Workflow Clarity

The section is explicitly framed as a checklist "run before committing any endpoint change" with a numbered 3-step sequence and an explicit validation gate with a fix loop ("make lint-python — fix any lint errors before committing"). Anchor 5 requires explicit validation steps, error-recovery feedback, and checklist form — all present; anchor 4's "minor validation gaps" do not apply since lint gatekeeping is stated.

5 / 5

Progressive Disclosure

The body is a pure overview routing to three real, one-level-deep bundle files via a Reference/When table ("references/endpoint-patterns.md", "references/openapi-codegen.md", "references/testing-patterns.md" — all verified present on disk with matching content). Combined with its under-50-line length and clean section organization, this matches anchor 5's clear overview with well-signaled references.

5 / 5

Total

20

/

20

Passed

Description

73%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 concise, well-scoped description that explicitly answers both what and when with a concrete trigger clause and a highly specific scope boundary. Its main weakness is that the "what" names the domain category without enumerating the concrete actions the skill actually performs (regenerating OpenAPI artifacts, wiring test coverage lists, linting).

Suggestions

Enumerate the concrete capabilities in the description, e.g. "REST API development for Phoenix: add or modify endpoints, regenerate OpenAPI schema and client types, and wire up integration test coverage" — this would lift specificity from anchor 3 toward anchors 4-5.

Include natural trigger variations users might say, such as "route", "router", or "OpenAPI", to improve trigger-term coverage from good (anchor 4) toward comprehensive (anchor 5).

Optionally mention the test-coverage checklist duty (registering endpoints in tests/integration/_helpers.py) in the description so reviewers searching for "endpoint test coverage" find this skill.

DimensionReasoningScore

Specificity

"REST API development for Phoenix" names the domain and "adding, modifying, or reviewing endpoints" states actions, but all actions target one artifact and no further capabilities (codegen, testing) are enumerated — matching anchor 3 rather than anchor 4's several distinct actions. It is clearly above anchor 2, whose actions are minimal or generic with no concrete target.

3 / 5

Completeness

Both parts are present: a clear "what" ("REST API development for Phoenix") and an explicit "when" with concrete triggers ("Use when adding, modifying, or reviewing endpoints in src/phoenix/server/api/routers/v1/"). Not 5 because the "what" is a category label rather than enumerated concrete actions as in the 5-anchor example; not 3 because the "when" is explicit, not weakly implied.

4 / 5

Trigger Term Quality

"REST API", "endpoints", and "adding, modifying, or reviewing" are natural phrases users would say when requesting this skill, giving good keyword coverage; a few natural variations are missing ("routes", "router", "handlers", "OpenAPI/schema"). Falls between anchor 3 (missing common synonyms) and anchor 4 (a few natural terms missing), noticeably above the midpoint, so 4.

4 / 5

Distinctiveness Conflict Risk

The description is pinned to a specific framework (Phoenix) and an exact directory path ("src/phoenix/server/api/routers/v1/"), establishing a clear niche with distinct triggers and minimal conflict risk with other skills. No neighboring anchor fits better.

5 / 5

Total

16

/

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-rest-api/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.