CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

phoenix-docs

Write and restructure Phoenix documentation in docs/ using the Diátaxis framework, with ASD-STE100 Simplified Technical English for technical content. Use when adding, editing, or reviewing any docs page.

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

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.

The body is a tight, actionable rulebook: a concrete type-identification procedure, hard STE constraints, and correctly factored references for card/banner generation. The only gaps are a slightly generic accessibility section and the absence of an explicit end-to-end editing sequence.

Suggestions

Trim the accessible images/videos section to the project-specific rules (alt="" convention, Card img, banner text fallback) and drop generic WCAG-style guidance Claude already knows.

Add a short ordered workflow for editing a page (identify type, apply type rules, apply STE if how-to/reference, then image/card checks) so the sections have an explicit application order.

DimensionReasoningScore

Conciseness

Lean and imperative nearly everywhere ("Each page has one type. Do not mix types.", "One instruction per sentence. Max 20 words in procedures, 25 in descriptions."), but the accessibility section repeats generic alt-text and video guidance Claude already knows. Anchor 4 ('efficient; minor instances of over-explanation') fits better than 5.

4 / 5

Actionability

Instruction-only skill with concrete, checkable rules: a two-question type algorithm ("action or cognition? study or work?"), hard limits (max 20/25 words), ordering rules with inline examples ("If X, do Y.", "Set the variable.", alt=""). Per the rubric's code-vs-instruction note, absent code is not penalized when guidance is this actionable; not below 5 because specific examples cover the common cases.

5 / 5

Workflow Clarity

A clear entry point exists ("Before you write, identify the type") plus per-topic rules, but the body is a rulebook rather than a sequenced edit/review workflow — no explicit ordering across sections or review checklist. No destructive/batch operations, so the cap at 3 does not apply; anchor 4's 'minor gaps' is the best fit.

4 / 5

Progressive Disclosure

A ~40-line overview keeps core operating rules inline and defers detail via two well-signaled, verified, one-level-deep references (card-images.md, card-design.md), each annotated with scope and a read-when hint. Design values correctly live in scripts/ and data in assets/, matching anchor 5's clear overview with easy navigation.

5 / 5

Total

18

/

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: it states what the skill does, names the frameworks it applies, and gives an explicit 'Use when' trigger clause with natural terms. Minor room to add synonyms (MDX, tutorial, guide) and slightly broaden the action list.

DimensionReasoningScore

Specificity

Enumerates several concrete actions ("Write and restructure", "adding, editing, or reviewing") and pins them to named methods (Diátaxis, ASD-STE100) and a location (docs/), matching anchor 4's 'several specific actions; minor gaps'. Not 5 because coverage of what each action involves is not comprehensive, and not 3 since more than 1-2 actions are explicitly listed.

4 / 5

Completeness

Explicitly answers both questions: what ("Write and restructure Phoenix documentation in docs/ using the Diátaxis framework, with ASD-STE100 Simplified Technical English") and when ("Use when adding, editing, or reviewing any docs page") with concrete trigger phrases. Anchor 4's caveat that 'when could be more explicit' does not apply.

5 / 5

Trigger Term Quality

Natural phrases a user would say are present: "documentation", "docs", "docs page", "adding, editing, or reviewing". Falls short of anchor 5's comprehensive synonym coverage — terms like MDX, tutorial, or guide are missing.

4 / 5

Distinctiveness Conflict Risk

"Phoenix documentation in docs/" carves a clear project-specific niche with triggers anchored to it, giving minimal conflict risk with other skills. Voice is third person, so no specificity penalty applies.

5 / 5

Total

18

/

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