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.

83

1.47x
Quality

88%

Does it follow best practices?

Impact

99%

1.47x

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

SecuritybySnyk

High

Do not use without reviewing

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.

A highly actionable, well-sequenced specification with concrete examples, exact file paths, and explicit validation checkpoints for command development. Its main structural weakness is that everything lives in one long SKILL.md with no bundle files or references to split detailed material out.

Suggestions

Split reference-style material — the shared options-shapes table, the testing-harness conventions, and the StructuredError/help-format details — into references/ files (e.g., references/options.md, references/testing.md) and link them from the body, keeping SKILL.md as an overview.

Trim the 18-item checklist by removing items that restate rules already specified in earlier sections (e.g., items 15-18 duplicate the interactive-mode, help-example, and output rules), or fold them into a shorter cross-referenced checklist.

Consider moving the detailed MSW test-harness usage examples into the proposed testing reference file, keeping only the 'tests MUST cover' list inline.

DimensionReasoningScore

Conciseness

The body is a dense, project-specific specification with no padding about concepts Claude already knows — tables, file paths, and examples all convey non-obvious conventions. Minor instances could be trimmed (e.g., the 18-item checklist partially restates rules already specified in earlier sections), placing it at the 4 anchor rather than the 5 anchor's 'every token earns its place'.

4 / 5

Actionability

Guidance is fully executable throughout: concrete bash invocations with sample output ('px project create --name foo --format raw' → JSON line), TypeScript interfaces with TSDoc blocks, exact module paths (src/config.ts, src/io.ts, src/exitCodes.ts), and a test harness recipe. This matches the 5 anchor ('fully executable; copy-paste ready; examples cover the common cases') rather than the 4 anchor with 'minor gaps'.

5 / 5

Workflow Clarity

The 'Checklist for Adding a New Resource Command' is a clearly sequenced 18-step process with explicit validation checkpoints and feedback loops: 'Run pnpm test — fix any failures before proceeding', 'Run pnpm build — fix any type errors before proceeding', and 'Run manually with --format raw and --no-input to verify'. Validation is explicit and repeated, not implicit, matching the 5 anchor.

5 / 5

Progressive Disclosure

The skill is a single ~300-line file with no references/, scripts/, or assets/ directories and no disclosure mechanism at all; reference-style material (the options-shapes table, testing-harness conventions) is inlined that could plausibly live in a references file. This matches the 3 anchor ('content that should be separate is inline') better than the 4 anchor, but the clear section headers and coherent structure keep it above the 2 anchor's header-less inlined reference.

3 / 5

Total

17

/

20

Passed

Description

88%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 that clearly and concretely states both what the skill covers and when to use it, with mostly natural trigger terms. The only weakness is the slightly over-broad 'CLI design' trigger and a few missing common variations.

DimensionReasoningScore

Specificity

The description enumerates multiple concrete capabilities — 'noun-verb command structure', 'Commander.js patterns', 'configuration resolution', 'output formats, exit codes' — giving comprehensive, non-generic coverage of what the skill provides. It fits the 5 anchor ('lists multiple specific concrete actions; comprehensive coverage') better than the 4 anchor, which requires minor gaps in coverage that are not evident here.

5 / 5

Completeness

It explicitly answers both questions: the 'what' ('Design and implementation guide for the Phoenix CLI (`px`). Covers...') and the 'when' ('Triggers when working on phoenix-cli commands — adding new commands, modifying existing ones...'). Both are concrete, matching the 5 anchor rather than the 4 anchor's weaker 'when'.

5 / 5

Trigger Term Quality

Natural trigger phrases like 'adding new commands', 'modifying existing ones', 'px commands', and 'reviewing CLI code' cover the ways a developer would phrase a request. A few common variations (e.g., 'subcommand', 'flags', 'output formatting') are missing, so it sits between the 4 and 5 anchors — closer to 4.

4 / 5

Distinctiveness Conflict Risk

Triggers are tightly bound to the niche ('phoenix-cli commands', '`px` commands'), but the catch-all trigger 'CLI design' is broad enough to fire for unrelated CLI work, creating minor overlap risk. This places it between the 4 and 5 anchors; the broad trigger keeps it at 4.

4 / 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

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.