CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

phoenix-sqlean

Maintaining packages/phoenix-sqlean, the vendored fork of nalgeon/sqlean.py published as arize-phoenix-sqlean. Use when bumping the bundled SQLite or sqlean versions, changing its wheel matrix, or touching its publish path. Trigger on any change under packages/phoenix-sqlean/, .github/workflows/phoenix-sqlean-*.yml, or the sqlean jobs in .github/workflows/publish.yaml.

Quality

86%

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

82%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 excellent internal maintenance skill: highly actionable commands, dense non-obvious repo knowledge, explicit verification steps, and well-organized sections. Its only weaknesses are mild — some rationale clauses could be tightened, error recovery is consolidated in Gotchas rather than inline, and the long body has one plausible split point for a reference file.

DimensionReasoningScore

Conciseness

Dense and repo-specific throughout — the pin-partner table, "GitHub's source archives are generated on demand and not byte-stable", and the gotchas are all knowledge Claude could not already have, with no generic concept explanations. A few long justifying clauses (e.g., the git-vs-archive checksum rationale) could be trimmed, so it sits at the 4 anchor rather than the 5 anchor's every-token-earns-its-place.

4 / 5

Actionability

Fully executable, copy-paste-ready commands cover the common cases: "./scripts/check-upstream.sh sqlite --apply", "git ls-remote <repo> 'refs/tags/<version>*'", "make prepare-src download-sqlite download-sqlean", "python setup.py build_ext -i", "python -m tests". Required edits are tied to exact files (Makefile pins, setup.py, PLATFORMS), matching the 5 anchor.

5 / 5

Workflow Clarity

The bump flow is sequenced (resolve via script or by hand, then a Verify section running the full build/test chain) with the automated check-sqlean-pin checkpoint and error-recovery guidance ("Regenerate it against sqlite/time/duration.c", "touch src/sqlean.c after editing"). Recovery guidance lives in a separate Gotchas section rather than inline validate-fix-retry loops, and steps are not given as an ordered list, so it fits the 4 anchor rather than the 5.

4 / 5

Progressive Disclosure

No bundle files exist and none are needed; sections (Bumping / Staying current / Gotchas / Wheels and publishing) are well-organized with clear headers and the body's script mentions are repo paths, not dangling references. At ~135 lines the wheels-and-publishing detail could arguably be split into a reference file, which is the minor organization gap of the 4 anchor rather than the 5 anchor's fully appropriate split.

4 / 5

Total

17

/

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 names the package and its purpose, enumerates the concrete maintenance actions, and gives explicit trigger conditions down to exact paths and workflow globs. Only minor gaps in action coverage and synonym terms keep specificity and trigger_term_quality at 4.

DimensionReasoningScore

Specificity

Lists several concrete actions — "bumping the bundled SQLite or sqlean versions, changing its wheel matrix, or touching its publish path" — but coverage has minor gaps (e.g., license/SPDX upkeep and extension-module changes are not named). It exceeds the 3 anchor (only 1-2 actions) but is not the comprehensive coverage of the 5 anchor.

4 / 5

Completeness

Explicitly answers both questions: what ("Maintaining packages/phoenix-sqlean, the vendored fork of nalgeon/sqlean.py published as arize-phoenix-sqlean") and when ("Use when bumping... Trigger on any change under packages/phoenix-sqlean/...") with concrete trigger phrases. This clearly matches the 5 anchor and exceeds the 4 anchor's "when could be more explicit".

5 / 5

Trigger Term Quality

Good natural keyword coverage — "bump", "sqlean", "SQLite", "wheel matrix", "publish" — plus concrete path globs ("packages/phoenix-sqlean/", ".github/workflows/phoenix-sqlean-*.yml") that function as file-extension triggers. A few natural synonyms (PyPI, release, cibuildwheel) are absent, keeping it below the 5 anchor.

4 / 5

Distinctiveness Conflict Risk

Scoped to a single vendored package and its exact workflow file paths, so it occupies a clear niche with minimal conflict risk against any other skill. The 4 anchor's "minor overlap risk" does not apply — the triggers are path-specific and unique to this package.

5 / 5

Total

18

/

20

Passed

Validation

81%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 13 / 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

referenced_paths_exist

Referenced path issues: 2 missing

Warning

Total

13

/

16

Passed

Repository

Arize-ai/phoenix

Path

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