CtrlK
BlogDocsLog inGet started
Tessl Logo

ax-go-audio

Use when writing Go code with `github.com/ax-llm/ax/packages/go` for audio input/output, OpenAI Responses audio mapping, realtime event folding, and generated package audio examples.

63

Quality

79%

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 ./website/static/go/.well-known/agent-skills/ax-go-audio/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

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

A lean, dense reference skill that trusts the reader and captures highly specific package behavior (key names, defaults, option precedence). Its weaknesses are the long inline API symbol list that belongs in a bundled reference file, an incomplete core code snippet, and the absence of an explicit verification loop for validating request mappings.

Suggestions

Move the 'Relevant API Surface' symbol list into a references/ file (or defer entirely to API.md) and link it explicitly, keeping SKILL.md as an overview (progressive_disclosure).

Add a short validate-then-run loop, e.g. confirm the provider request mapping with a no-key example before making a live call (workflow_clarity).

Make the Core Pattern snippet self-contained (imports and a runnable snippet drawn from examples/) so it is copy-paste ready (actionability).

DimensionReasoningScore

Conciseness

The body is dense and assumes competence — it never explains what Go, audio, or providers are, and every section carries package-specific facts. It sits at anchor 4 rather than 5 because a few sentences (notably the long JSON-body Content-Type bullet) are convoluted run-ons that could be tightened, and the symbol list duplicates information available in the referenced API.md.

4 / 5

Actionability

The Core Pattern gives near-executable Go code and the bullets supply exact key names, default models ("gpt-4o-mini-tts" with the "alloy" voice), and option names ("renderAudio" / "render_audio"). This matches anchor 4 (mostly executable, minor gaps) rather than 5 because the code snippet is incomplete (no imports or function context) and no full runnable example is inlined.

4 / 5

Workflow Clarity

Guardrails sequence the approach: start from package examples, use no-key examples for deterministic local checks, and keep provider-api examples behind explicit credentials — a clear decision path with an implicit validation checkpoint. It misses anchor 5 because there is no explicit validate-and-retry loop (e.g., how to confirm a request mapping against a no-key run before touching live credentials).

4 / 5

Progressive Disclosure

Sections are well organized and Package Facts points to API.md, axir-api.json, and examples/, but no bundle files (references/, scripts/, assets/) exist in the skill, and the ~25-line 'Relevant API Surface' symbol list is inline content that duplicates the referenced API.md and belongs in a separate reference file. This matches anchor 3 (content that should be separate is inline) rather than 4, where references are clearly signaled and content is appropriately placed.

3 / 5

Total

15

/

20

Passed

Description

78%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, distinct description with an explicit 'Use when' trigger and a specific list of task areas. Its main weaknesses are missing natural synonyms (speech, voice, TTS, transcription) that users would plausibly say, and a topic-list 'what' rather than concrete action verbs.

Suggestions

Add natural user synonyms such as 'speech', 'voice', 'TTS', or 'transcription' to broaden trigger matching (trigger_term_quality).

Lead the description with concrete actions in third person (e.g., 'Maps speech, transcription, and realtime audio events...') and keep the 'Use when' clause for triggers (specificity, completeness).

DimensionReasoningScore

Specificity

"audio input/output, OpenAI Responses audio mapping, realtime event folding, and generated package audio examples" lists several specific capabilities in the Go audio domain, with minor gaps (e.g., speech synthesis and transcription defaults are covered by the skill but not surfaced in the description). This matches anchor 4 (several specific actions, minor coverage gaps) rather than anchor 5, whose coverage is comprehensive across the skill's full scope.

4 / 5

Completeness

The "Use when writing Go code with github.com/ax-llm/ax/packages/go for ..." clause supplies an explicit trigger (when) and the trailing list names the task areas (what). Both are present, matching anchor 4; it falls short of anchor 5 because the "what" is a nominal list of topics rather than clearly stated concrete actions, and the trigger could name audio/speech user intents more specifically.

4 / 5

Trigger Term Quality

Natural terms a user would say are present: "Go code", "audio input/output", "OpenAI Responses audio", "realtime", "audio examples". It sits above anchor 3 because keyword coverage is genuinely good, but below anchor 5 because common synonyms users would naturally say — "speech", "voice", "TTS", "transcription", "text-to-speech" — are missing.

4 / 5

Distinctiveness Conflict Risk

The full import path `github.com/ax-llm/ax/packages/go` plus the audio/realtime/OpenAI Responses scope carves out a clear niche with distinct triggers and minimal conflict risk against generic Go or audio skills. It clearly matches anchor 5; anchor 4's "minor overlap risk with closely related skills" does not apply since the package path disambiguates even against a sibling non-audio ax skill.

5 / 5

Total

17

/

20

Passed

Validation

93%

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

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

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

Warning

Total

15

/

16

Passed

Repository
ax-llm/ax
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.