Name: ax-flow
Rating: 64 (1 reviews)
Author: ax-llm

ax-flow

This skill helps an LLM generate correct AxFlow workflow code using @ax-llm/ax. Use when the user asks about flow(), AxFlow, workflow orchestration, parallel execution, DAG workflows, conditional routing, map/reduce patterns, or multi-node AI pipelines.

Quality

77%

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

Quality

Content

72%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 strong, highly actionable codegen reference with copy-paste patterns across virtually every AxFlow feature. Its gaps are structural: no progressive disclosure into bundle files, and no explicit validated generation workflow, leaving both dimensions at the midpoint.

Suggestions

Move the Flow Gallery (the 10+ mermaid examples) and/or the full per-method API reference into reference files under references/, linking to them from SKILL.md to improve progressive disclosure.

Add a short sequenced workflow for generating a flow (define nodes -> wire executes -> add returns -> run getExecutionPlan/check common errors) with an explicit validation checkpoint before considering the output complete.

Trim the overlap between 'Use These Defaults' and 'Critical Rules' into a single rules block to tighten conciseness toward the top anchor.

Dimension	Reasoning	Score
Conciseness	The body is dense and code-first, assuming Claude's competence with no padding about what libraries or workflows are; minor redundancy between 'Use These Defaults' and 'Critical Rules' and the long inlined mermaid gallery keep it just below the lean 5.	4 / 5
Actionability	Throughout, guidance is fully executable copy-paste TypeScript covering the common cases (canonical pattern, sequential, auto-parallel, branching, while/feedback loops, mermaid authoring, tracing), matching the top anchor.	5 / 5
Workflow Clarity	A canonical pattern, 'Critical Rules', 'Do Not Generate', and a common-errors list provide guardrails, but there is no explicit sequenced generation workflow with validation checkpoints; this sits at 'steps present but checkpoints missing/implicit'.	3 / 5
Progressive Disclosure	Section headers organize the content well, but no bundle files exist and large blocks that could live in separate files (the 10+ diagram Flow Gallery, full API reference) are inlined; references are only external URLs/other-skill mentions, so it lands at 'some structure, content that should be separate is inline'.	3 / 5
	Total	15 / 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 well-structured with an explicit what-and-when pair and rich, natural trigger terms anchored to a clearly distinct niche. Its only weakness is specificity: it states one overarching action rather than enumerating several concrete capabilities.

Suggestions

Expand the 'what' clause to list 2-3 concrete actions (e.g., 'define nodes, wire data flow, and add branching/loops') to lift specificity toward the top anchor.

Add the package/file signal users might mention (e.g., '@ax-llm/ax' import or '.ts' AxFlow files) to round out trigger-term coverage.

Dimension	Reasoning	Score
Specificity	Names the domain ('AxFlow workflow code using @ax-llm/ax') and one concrete action ('generate correct AxFlow workflow code'), but does not enumerate several specific actions, so it sits at the 'domain + 1-2 concrete actions' anchor rather than the comprehensive 4-5 band.	3 / 5
Completeness	Explicitly answers both 'what' ('helps an LLM generate correct AxFlow workflow code using @ax-llm/ax') and 'when' ('Use when the user asks about flow(), AxFlow, workflow orchestration...') with concrete trigger phrases, matching the top anchor.	5 / 5
Trigger Term Quality	Strong keyword coverage with natural user phrases ('workflow orchestration', 'parallel execution', 'DAG workflows', 'conditional routing', 'map/reduce patterns', 'multi-node AI pipelines') plus the API name 'flow()' and 'AxFlow', though it stops short of the fully comprehensive synonym+extension list of a 5.	4 / 5
Distinctiveness Conflict Risk	A clear niche (AxFlow/@ax-llm/ax codegen) with distinctive triggers unlikely to fire for unrelated skills, matching the minimal-conflict-risk anchor.	5 / 5
	Total	17 / 20 Passed

Validation

87%

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 — 14 / 16 Passed

Validation for skill structure

Criteria	Description	Result
skill_md_line_count	SKILL.md is long (683 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-flow/SKILL.md
Commit: 1abea97

Reviewed: ~18 hours 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.