CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

phoenix-cli-development

Design and implementation guide for the Phoenix CLI (`px`). Covers the noun-verb command structure, dual-audience design (humans and coding agents), Commander.js patterns, configuration resolution, output formats, exit codes, and conventions for adding or modifying commands. Triggers when working on phoenix-cli commands — adding new commands, modifying existing ones, refactoring command structure, or reviewing CLI code. Also triggers on mentions of `px` commands, CLI design, or adding a new resource to the CLI.

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

85%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 highly actionable and workflow-oriented, with executable commands, typed examples, and an explicit validation-gated checklist — outstanding on actionability and workflow clarity. Its main weaknesses are length (a few sections could be trimmed) and the absence of progressive disclosure: the entire specification is inlined in SKILL.md with no reference files.

Suggestions

Split reference-grade material into bundle files — e.g., move the shared options-type table and the testing-harness guide into references/options.md and references/testing.md, leaving SKILL.md as a concise overview with clearly signaled one-level-deep links.

Trim the full `--help` sample output block to only the 'Examples:' portion it illustrates, and reduce the naming-conventions section to a one-line pointer to the phoenix-typescript skill it already cites.

Add a short 'Quick start' section at the top (the 3-4 most common commands) so the most frequent use case is reachable without scanning the full specification.

DimensionReasoningScore

Conciseness

The body is dense with project-specific requirements (RFC 2119 rules, tables, exact file paths) and avoids explaining concepts Claude already knows, but the full `--help` sample output and the naming-conventions section (which duplicates the referenced phoenix-typescript skill) could be trimmed — matching 'efficient; minor instances of over-explanation', not the fully lean top anchor.

4 / 5

Actionability

Guidance is copy-paste ready throughout: exact commands ('px project create --name my-project --format raw --no-input', 'pnpm test'), a complete TypeScript interface example with TSDoc requirements, specific test-harness APIs, and an 18-step checklist — fully executable with the common cases covered.

5 / 5

Workflow Clarity

The 'Checklist for Adding a New Resource Command' is explicitly sequenced with validation gates and feedback loops — 'Run `pnpm test` — fix any failures before proceeding', 'Run `pnpm build` — fix any type errors before proceeding', and a manual `--format raw` verification step — matching the top anchor with explicit validation rather than merely implied checkpoints.

5 / 5

Progressive Disclosure

No bundle files exist and all ~320 lines live in SKILL.md, including reference-grade material (the shared options-type table, the full testing-harness guide, naming conventions) that clearly belongs in separate files; section headers are well organized, placing this above 'minimal structure' but below 'good structure' since nothing is split out and the body far exceeds overview size.

3 / 5

Total

17

/

20

Passed

Description

96%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 a clear, multi-faceted 'what' and an explicit, concrete 'when' with natural trigger phrasing and synonyms. The only weakness is the unqualified 'CLI design' trigger, which introduces slight conflict risk with generic CLI work outside the Phoenix project.

DimensionReasoningScore

Specificity

Enumerates multiple concrete capability areas — 'noun-verb command structure, dual-audience design (humans and coding agents), Commander.js patterns, configuration resolution, output formats, exit codes, and conventions for adding or modifying commands' — with no notable gaps in coverage, matching the comprehensive anchor rather than the 'minor gaps' anchor.

5 / 5

Completeness

Explicitly answers both 'what' (a design and implementation guide covering the listed areas) and 'when' ('Triggers when working on phoenix-cli commands... Also triggers on mentions of `px` commands...') with concrete trigger phrases, matching the top anchor; a 4 would require the 'when' to be less explicit.

5 / 5

Trigger Term Quality

Covers natural user phrasings ('adding new commands, modifying existing ones, refactoring command structure, or reviewing CLI code') plus synonyms and the binary name ('px commands', 'phoenix-cli commands', 'CLI design'), giving comprehensive natural-term coverage; not scored 4 because both colloquial phrases and name variants are present.

5 / 5

Distinctiveness Conflict Risk

The niche is clearly the Phoenix CLI (`px`), but the unqualified trigger 'CLI design' (and 'adding a new resource to the CLI') could fire on unrelated CLI work — a minor overlap risk matching 'mostly distinct; minor overlap risk'; not 5 because of that generic trigger phrase, not 3 because everything else is tightly domain-scoped.

4 / 5

Total

19

/

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