CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

yao-image

Image expert. ALWAYS invoke this skill when you need to read, analyze, describe, or generate images. Use for screenshots, photos, charts, diagrams, AI-generated images, or any visual content.

70

Quality

88%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

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.

Highly actionable, executable content: every command is copy-paste ready and tool selection is unambiguous. The only deductions are minor duplicated parameter documentation between image_generate and image_edit and a fully-inline API reference that could live in a separate file.

DimensionReasoningScore

Conciseness

The body is a lean CLI reference with no explanations of concepts Claude already knows, but rows like background, output_format, output_compression, quality, extra, provider, model, and dimensions are duplicated between the image_generate and image_edit tables, and the note "If `output` is omitted, the image is saved to a default path" appears twice. This is the 'efficient with minor trimming possible' anchor, not the every-token-earns-its-place anchor 5.

4 / 5

Actionability

Every example is a copy-paste-ready `tai tool ...` command covering the common cases (local file, URL, specific provider, mask, transparent background, WebP output), backed by complete parameter tables and an explicit unsupported-parameters list in the Constraints section. Fully matches the anchor-5 example.

5 / 5

Workflow Clarity

This is a toolbox of single-action commands rather than a multi-step process, so the simple-skill note applies: each invocation is unambiguous and tool selection is explicitly disambiguated ("For editing an existing image, use `image_edit` instead" and image_providers --capability flags). No destructive or batch operations exist, so the validation cap does not apply.

5 / 5

Progressive Disclosure

No bundle files exist (no references/, scripts/, or assets/), and the single file is well-sectioned with per-tool headers, parameter tables, and a Constraints section for easy navigation. It scores 4 rather than 5 because at ~155 lines it exceeds the under-50-line simple-skill exemption, so the fully-inline API reference counts as a minor organization gap rather than an automatic pass.

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 with explicit what-and-when structure and natural trigger terms. Its main gaps are the missing 'edit' trigger (despite an image_edit tool in the body), absent file extensions, and second-person voice that incurs the specificity penalty.

Suggestions

Mention image editing as a capability (e.g., 'read, analyze, describe, edit, or generate images') so the image_edit tool is represented in the triggers.

Add common file extensions to the trigger list (e.g., 'PNG, JPEG, GIF, WebP images or .png/.jpg files') for comprehensive synonym coverage.

Rewrite in third person (e.g., 'Reads, analyzes, describes, edits, and generates images. Invoke when working with...') to avoid the second-person specificity penalty.

DimensionReasoningScore

Specificity

"read, analyze, describe, or generate images" lists multiple concrete actions, but the second-person phrasing "ALWAYS invoke this skill when you need to" triggers the rubric's third-person penalty (base 5 reduced by 1). It is above anchor 3 because four distinct concrete actions exceed '1-2 concrete actions'.

4 / 5

Completeness

Both what ("read, analyze, describe, or generate images") and when ("ALWAYS invoke this skill when you need to... Use for screenshots, photos, charts, diagrams...") are explicitly stated with concrete trigger phrases, matching the anchor-5 example pattern.

5 / 5

Trigger Term Quality

"screenshots, photos, charts, diagrams, AI-generated images, visual content" gives good natural-term coverage, but misses 'edit'/'editing' (the skill includes an image_edit tool) and file extensions like .png/.jpg, so it falls short of the comprehensive-synonyms anchor 5.

4 / 5

Distinctiveness Conflict Risk

It carves a clear image niche, but "charts, diagrams" and "any visual content" create minor overlap risk with dedicated charting/dataviz or PDF skills. Not 5 because of that overlap; not 3 because the domain is coherent and largely non-overlapping.

4 / 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

YaoApp/yao

Path

tools/skills/yao-image/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.