ax-python-llm

Use when writing Python code with `axllm` for using the generated Ax package, factory functions, package docs, examples, and API reference.

Quality

65%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./packages/python/skills/ax-python-llm/SKILL.md

Quality

Content

68%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 tight, well-structured quick reference with executable core code, concrete symbol lists, and clearly signaled external references. Its main weakness is the absence of an explicit workflow sequence with validation checkpoints for fragile operations.

Suggestions

Add a short ordered workflow for common tasks (e.g. 1. pick entrypoint from examples, 2. configure provider/no-key transport, 3. validate response) with an explicit validation checkpoint.

Move the long API surface list into the referenced API.md/axir-api.json and keep only the top entrypoints inline to improve progressive disclosure.

Trim the opening paragraph that restates the description to reduce redundancy.

Dimension	Reasoning	Score
Conciseness	The body is lean with well-organized sections and a dense, useful API surface list; only the opening restatement of the description is a minor instance of over-explanation that could be trimmed.	4 / 5
Actionability	The Core Pattern gives copy-paste-ready executable code and the API surface lists concrete symbols plus actionable Guardrails, with only minor gaps in per-feature runnable examples.	4 / 5
Workflow Clarity	There is clear directional guidance ('Start from package examples for exact native syntax') but no explicit multi-step sequence or validation checkpoints, leaving the workflow implicit rather than sequenced.	3 / 5
Progressive Disclosure	Content is organized into clear sections with well-signaled one-level-deep references (API.md, axir-api.json, axir-capabilities.json, examples/); the large inline API surface list is the minor organization gap that could live in a referenced file.	4 / 5
	Total	15 / 20 Passed

Description

62%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 pairs a clear 'Use when' trigger with a specific package (`axllm`) and lists several resources, but its verbs are generic and the trigger scenario is narrow. It is solidly above average with room to add concrete actions and synonyms.

Suggestions

Replace vague verbs ('writing', 'using') with concrete actions like 'build', 'configure', 'route', or 'optimize' agents and flows with axllm.

Broaden trigger terms with synonyms users might say, e.g. 'Ax Python SDK', 'axllm agents', 'Ax generated package'.

Tighten the 'when' clause with explicit scenarios, e.g. 'Use when building Ax agents, flows, or optimizers in Python with the axllm package.'

Dimension	Reasoning	Score
Specificity	Names the domain ('writing Python code with `axllm`') and lists resources (factory functions, package docs, examples, API reference), but the verbs are weak ('writing', 'using') rather than concrete distinct actions, so it lands at domain-plus-actions without comprehensive coverage.	3 / 5
Completeness	It explicitly states both what (write Python code with axllm using factory functions, docs, examples, API reference) and when ('Use when writing Python code with `axllm`'), though the 'when' could be more specific about scenarios.	4 / 5
Trigger Term Quality	'Use when writing Python code with `axllm`' includes the natural phrase and package name a user would say, but offers few variations or synonyms beyond 'Ax package', matching the some-relevant-keywords anchor.	3 / 5
Distinctiveness Conflict Risk	The `axllm` package name carves a clear niche unlikely to fire for unrelated skills, with only minor overlap risk against other Python LLM-package skills.	4 / 5
	Total	14 / 20 Passed

Validation

93%

Warnings & errors only

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

Criteria	Description	Result
frontmatter_unknown_keys	Unknown frontmatter key(s) found; consider removing or moving to metadata	Warning

	Total	15 / 16 Passed

Repository: ax-llm/ax
Path: packages/python/skills/ax-python-llm/SKILL.md
Commit: e690b48

Reviewed: 1 hour ago

Table of Contents

Discovery Implementation Validation

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.