CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

ax-signature

This skill helps an LLM generate correct DSPy signature code using @ax-llm/ax. Use when the user asks about signatures, s(), f(), field types, string syntax, fluent builder API, validation constraints, or type-safe inputs/outputs.

Quality

87%

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

88%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 unusually actionable, dense API reference: complete executable TypeScript in all three Standard Schema shapes, strict-vs-loose API distinctions, explicit decision rules for choosing among four creation methods, and a verified one-level-deep reference file. It is long, and a few areas — timezone-rule depth, Jev/version-specific details, and inconsistent citation forms for ax-typesafe.md — could be tightened or unified.

DimensionReasoningScore

Conciseness

The body is dense, library-specific reference material with no filler and no explanation of concepts Claude already knows — nearly every line states Ax-specific syntax or behavior. Minor trim opportunities (the two-paragraph timezone-abbreviation rules, the 'Jev 1.14' version reference, the 24-entry gallery) place it at the 'efficient; minor instances that could be trimmed' anchor rather than the lean-everything-earns-its-place anchor.

4 / 5

Actionability

Code is copy-paste ready with imports ("import { ax, s } from '@ax-llm/ax'"), complete fluent and zod builds, correct-vs-wrong contrasts ("// Wrong: nested function calls (removed)"), and a gallery whose entries are guaranteed to "parse with s() as written" — fully executable guidance whose examples cover the common cases.

5 / 5

Workflow Clarity

A single-task reference skill whose single action — composing a signature — is unambiguous: four creation methods are numbered with explicit selection rules ("String-Based (Recommended for simple cases)", "Reserve fluent/Standard Schema for zod/valibot-backed fields") plus a Critical Rules section; the framework's own validation loop ("Validation errors trigger auto-retry with correction feedback") is stated. No destructive or batch operations, so no validation cap applies.

5 / 5

Progressive Disclosure

Sections are clearly headed, and the one bundle reference is real, one level deep, and signaled at point of use ("See [decision evidence](references/ax-typesafe.md#decision-evidence-and-reranking)" — the anchor resolves to an actual heading in the file). Stays at 'good structure; minor organization gaps' rather than 5 because the same file is cited three inconsistent ways (local link, a bare "ax-typesafe.md" mention, and a GitHub URL) and substantial advanced material (boxes, Jev specifics) is inlined.

4 / 5

Total

18

/

20

Passed

Description

83%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: explicit third-person 'what' plus a 'Use when' clause listing concrete, library-specific trigger terms including the s() and f() API names. Minor gaps keep it just below top marks — features covered in the body (Standard Schema/zod, evidence fields, boxes) are absent from the enumeration, and the 'DSPy' label and 'type-safe' trigger carry slight confusion risk with the DSPy framework and the sibling ax-typesafe skill.

DimensionReasoningScore

Specificity

Names the domain ("generate correct DSPy signature code using @ax-llm/ax") and enumerates specific capability areas ("field types, string syntax, fluent builder API, validation constraints, or type-safe inputs/outputs"), matching the 'several specific actions; minor gaps' anchor. Not 5 because the 'what' is a single generate action and body-covered features (Standard Schema/zod, evidence fields, boxes) are unmentioned; not 3 because the enumerated coverage is broad, not 1-2 items.

4 / 5

Completeness

Explicitly answers both what ("This skill helps an LLM generate correct DSPy signature code using @ax-llm/ax") and when ("Use when the user asks about signatures, s(), f(), ...") with concrete trigger phrases, exactly matching the 5 anchor. Voice is third person throughout, so no voice penalty applies.

5 / 5

Trigger Term Quality

Triggers include the exact API tokens a user of this library would naturally say — "signatures, s(), f(), field types, string syntax, fluent builder API" — giving good keyword coverage. Falls short of the 5 anchor's comprehensive synonyms/extensions (e.g., 'structured output', 'zod', 'schema') but clearly exceeds anchor 3's 'missing common variations'.

4 / 5

Distinctiveness Conflict Risk

The niche is clear (@ax-llm/ax signatures, with distinctive tokens s() and f()), but "DSPy signature code" invites collision with the separate DSPy framework and "type-safe inputs/outputs" overlaps the sibling ax-typesafe skill — matching anchor 4's 'minor overlap risk with closely related skills' rather than 5's 'minimal conflict risk'.

4 / 5

Total

17

/

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

skill_md_line_count

SKILL.md is long (508 lines); consider splitting into references/ and linking

Warning

frontmatter_unknown_keys

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

Warning

Total

14

/

16

Passed

Repository

ax-llm/ax

Path

website/static/typescript/.well-known/agent-skills/ax-signature/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.