CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

best-api

Design, review or repair a Plate public call shape using live Slate-based contracts, ideal call sites, inference and ownership.

52

Quality

65%

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

Fix and improve this skill with Tessl

tessl review fix ./.agents/skills/best-api/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

65%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 exceptionally token-efficient and states real decision rules, but its guidance stays abstract: no examples of ideal call sites, findings, or the referenced probe, and no section structure separating the three operating modes. Sequencing and verification checkpoints are implied rather than explicit, which limits actionability and workflow clarity.

Suggestions

Split the body into '## Design', '## Review', and '## Repair' sections so each mode's steps and gates are immediately locatable.

Add one concrete miniature example per mode: an ideal call site with actual public imports, a sample P0–P3 ranked finding, and the shape of benchmark's matched pre-acceptance probe.

Signal external dependencies explicitly — link or path VISION.md, the Plan playbook, and the benchmark/verdict skills, and state when each is consulted.

DimensionReasoningScore

Conciseness

The ~30-line body is lean and dense with no padding, no explanation of concepts Claude already knows, and no filler; every line carries a directive ('Compare keeping, deleting, merging, inlining and replacing', 'rank concrete findings P0 through P3'). It clearly matches anchor 5 ('lean and efficient; assumes Claude's competence; every token earns its place') and shows none of the over-explanation that would drop it to anchor 4.

5 / 5

Actionability

There is some concrete guidance — 'Search the old names and their word variants with `git grep --untracked`' and 'rank concrete findings P0 through P3' — but most directives are abstract decision rules ('Classify every noun by its honest package, registry or application owner', 'a matched pre-acceptance probe') with no example of an ideal call site, a ranked finding, or what the probe is. This fits anchor 3 ('some concrete guidance but incomplete; missing key details'), below anchor 4's 'mostly executable guidance'.

3 / 5

Workflow Clarity

A rough sequence exists for each mode (read → inspect → show → classify → compare for design; rank → recommend for review; update contract → search old names → regenerate → forward-test for repair), but steps are never enumerated and checkpoints are implicit rather than explicit; only 'forward-test the real call' reads as verification. This matches anchor 3 ('steps listed but validation gaps; checkpoints missing or implicit') and does not reach anchor 4's 'clear sequence with most checkpoints present'.

3 / 5

Progressive Disclosure

No bundle files exist, so everything lives in a single body that is under 50 lines, but organization is a wall of flowing prose under one '# Best API' heading with no sections for the design/review/repair modes. External artifacts ('VISION.md', '`benchmark`', 'the Plan playbook', 'verdict') are referenced without being clearly signaled or linked. This fits anchor 3 ('some structure but could be better organized; references present but not clearly signaled'), below the well-organized-sections bar of the simple-skill exception.

3 / 5

Total

14

/

20

Passed

Description

53%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.

The description clearly states what the skill does for a well-defined niche (Plate/Slate API call shapes), but it lacks any 'Use when...' trigger guidance and leans on internal jargon ('call shape', 'inference and ownership') instead of natural user vocabulary. It is a solid mid-range description with an easy fix available.

Suggestions

Append an explicit trigger clause, e.g. 'Use when designing or reviewing Plate/Slate plugin APIs, public exports, or call sites, or when repairing a published API surface.'

Replace or augment jargon like 'call shape' and 'inference and ownership' with natural terms users would actually say: 'API', 'public interface', 'breaking changes', 'call sites'.

Mirror the verbs users would use ('design an API', 'review an API change', 'fix a breaking change') so trigger matching works on real phrasing, not just 'design, review or repair'.

DimensionReasoningScore

Specificity

The description names its domain ('a Plate public call shape') and three actions ('Design, review or repair'), but phrases like 'live Slate-based contracts, ideal call sites, inference and ownership' are jargon-dense rather than concrete capabilities. It matches anchor 3: domain plus a couple of concrete actions, not comprehensive; it is below anchor 4 because the supporting terms add abstraction rather than specific, scannable capabilities.

3 / 5

Completeness

The 'what' is clear (design, review, or repair a Plate public call shape), but there is no 'Use when...' clause or equivalent explicit trigger guidance anywhere, which caps completeness at 3 per the judging guidelines. It fits anchor 3 ('clear what but when is missing or only weakly implied') and cannot reach anchor 4, which requires both what and when.

3 / 5

Trigger Term Quality

Relevant keywords exist ('Plate', 'Slate', 'call shape', 'review', 'repair') but common natural variations users would say — 'API', 'public API', 'interface', 'breaking change' — are missing, and 'call shape' is not a phrase a user would naturally utter. This sits at anchor 3 ('some relevant keywords but missing common variations or synonyms'), below anchor 4's 'good keyword coverage'.

3 / 5

Distinctiveness Conflict Risk

Naming the specific stack ('Plate', 'Slate') gives it a clear niche with low risk of triggering for unrelated skills, fitting mostly-anchor-4 ('mostly distinct; minor overlap risk'). It falls short of anchor 5 because without explicit trigger phrases it could still overlap with generic code-review or API-design skills in the same repo, and distinctness rests on framework names rather than distinct triggers.

4 / 5

Total

13

/

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

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

13

/

16

Passed

Repository

udecode/plate

Path

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