CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

convex-http-actions

Retired. Points to the skill that replaced convex-http-actions in builder-skills 3.0. Use when /convex-http-actions is invoked by name or the user asks where convex-http-actions went.

Quality

87%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Critical

Do not install without reviewing

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 model of a retirement tombstone: minimal, unambiguous about the replacement, and provides an executable install command plus concrete follow-up URLs. Main minor gap is the implicit handling of the 'replacement already installed' branch and the loosely sequenced cleanup instruction. Structure is appropriately flat with no unnecessary bundle files.

DimensionReasoningScore

Conciseness

The ~12-line body is lean with every line actionable: the redirect instruction, a copy-paste install command, two URLs, and a cleanup note, with no explanation of concepts Claude already knows. This matches the 'every token earns its place' anchor; the time-sensitive details (version pin, old-content URL) are confined to a deprecation-style pointer rather than padded explanation.

5 / 5

Actionability

Concrete, copy-paste-ready guidance is present: "npx skills add convex/agent-skills --skill convex-design" and a specific agent-setup URL, plus a clear instruction to tell the user. It falls short of 5 because "load the replacement if it is installed" leaves the installed-vs-not check implicit, and the follow-up flow (tell user, load, install) is not fully laid out in one unambiguous sequence.

4 / 5

Workflow Clarity

For this simple single-purpose skill the action sequence is clear: tell the user it moved, use convex-design, install it via the given command if needed. It is not 5 because the conditional ordering (load if installed, then install instructions) could be merged into one explicit step sequence, and the "Delete this folder after you switch" cleanup step is stated without any sequencing context.

4 / 5

Progressive Disclosure

The skill is under 50 lines with no need for external reference files (no references/ or scripts/ exist), and the body is well organized: heading, redirect statement, install command, setup link, and old-content pointer. Per the rubric's simple-skill guideline, this earns the top score; external URLs are one level deep and clearly signaled.

5 / 5

Total

18

/

20

Passed

Description

82%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 is an exemplary tombstone: it states the skill's single purpose (redirect to the replacement) and gives explicit, natural triggers for when the retired skill's name comes up. Both 'what' and 'when' are fully answered with concrete trigger phrases, and the narrow name-scoped triggers make conflict with other skills unlikely. Only minor gains possible from covering a few more natural phrasings.

DimensionReasoningScore

Specificity

"Points to the skill that replaced convex-http-actions in builder-skills 3.0" names a single concrete action (redirect to replacement) in third person, matching the anchor for 1-2 concrete actions without comprehensive coverage. It is not a 4 because only one action is listed, and not a 2 because the action is concrete rather than generic.

3 / 5

Completeness

"Retired. Points to the skill that replaced..." clearly answers what the skill does, and the explicit "Use when..." clause answers when with concrete trigger phrases. This matches the top anchor exactly; the 4-anchor's weaker 'when' does not apply since triggers are fully explicit.

5 / 5

Trigger Term Quality

"Use when /convex-http-actions is invoked by name or the user asks where convex-http-actions went" gives good, natural trigger coverage for the retirement scenario (name invocation, asking where it went). It is not a 5 because natural variations like "convex http actions" without the exact skill name are absent, and not a 3 because both key phrasings users would actually say are explicitly present.

4 / 5

Distinctiveness Conflict Risk

The description is anchored to the exact skill name ("convex-http-actions") with triggers scoped to that name and its disappearance, giving a clear niche with minimal conflict risk against other skills. No overlap risk is apparent since no other skill would claim these triggers.

5 / 5

Total

17

/

20

Passed

Validation

100%

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

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

waynesutton/convexskills

Path

skills/convex-http-actions/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.