CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

baoyu-article-illustrator

Article illustrations: type × style × palette consistency.

Quality

71%

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 ./optional-skills/creative/baoyu-article-illustrator/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

86%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 content is an exemplary operational skill body: concrete tool calls, exact file layouts, a well-sequenced 7-step workflow with blocking gates and retry loops, and clean progressive disclosure into a verified one-level-deep bundle. The only real weaknesses are a redundant Pitfalls section that duplicates earlier guidance and a missing download-verification checkpoint in an otherwise batch workflow.

DimensionReasoningScore

Conciseness

The body is table-driven and terse, explaining nothing Claude already knows — tool constraints are stated once as facts ('image_generate returns a URL... does NOT accept an output path'). The trimmable redundancy is the Pitfalls section, which restates five points already made in Core Principles and Step 6 ('Strip secrets', 'Prompt files are mandatory', aspect-ratio mapping, URL-not-file, backend non-selectable). This is efficient with minor instances of duplication that could be merged, matching anchor 4 rather than 5.

4 / 5

Actionability

Fully executable guidance throughout: exact tool invocations ('image_generate(prompt=..., aspect_ratio=...)'), a copy-paste download command ('curl -sSL -o "{output-dir}/NN-{type}-{slug}.png" "{url}"'), a concrete output directory tree, filename/slug/conflict rules, an aspect-ratio enum mapping ('16:9 → landscape'), and a fully specified clarify-question table with options and skip conditions. Copy-paste-ready commands cover the common cases, matching anchor 5.

5 / 5

Workflow Clarity

A 7-step checklist with an explicit blocking checkpoint (prompt file must exist before any image), an error-recovery loop (auto-retry once on generation failure), and a final X/N completion report. It falls short of anchor 5 because the batch download step lacks verification — curl -sSL can fail silently and there is no check that each PNG downloaded successfully before inserting paths into the article — leaving a minor validation gap typical of anchor 4.

4 / 5

Progressive Disclosure

The body is a true overview: procedures, galleries, presets, and prompt templates each live in one-level-deep reference files (references/workflow.md, styles.md, style-presets.md, prompt-construction.md, usage.md — all present in the bundle, with style and palette galleries further split into per-item files under references/styles/ and references/palettes/). Each section links its reference inline with anchored targets (e.g. workflow.md#step-4-generate-outline) and a summary References table aids navigation, matching anchor 5.

5 / 5

Total

18

/

20

Passed

Description

48%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 admirably concise and names a distinct, well-scoped niche, but its extreme terseness costs it: no concrete actions, no trigger phrases, and no 'Use when' guidance. Users searching for 'add images to article' or '为文章配图' would rely on lucky keyword overlap rather than explicit triggers.

Suggestions

Add an explicit 'Use when...' clause naming natural trigger phrases, e.g. 'Use when the user asks to illustrate an article, add images to content, or says "为文章配图" / "illustrate article" / "add images".'

Include at least 2-3 concrete action verbs so the capability is explicit, e.g. 'Analyzes articles, identifies illustration positions, generates images with Type × Style × Palette consistency, and inserts them into the article.'

Add common synonyms (配图, figures, illustrations, article images) to widen trigger coverage without significantly increasing length.

DimensionReasoningScore

Specificity

The description names the domain ('Article illustrations') and the three control dimensions ('type × style × palette consistency'), but lists no concrete actions — no verbs like analyze, generate, or insert appear anywhere. It matches anchor 2 (names the domain but actions are minimal or generic); it is above anchor 1 because the domain and dimension framework are concrete rather than pure abstraction, and below anchor 3 because no specific actions are enumerated at all.

2 / 5

Completeness

The 'what' is reasonably clear (producing article illustrations consistent across type, style, and palette), but there is no 'Use when...' clause or equivalent trigger guidance, which caps completeness at 3 per the judging guidelines. It stays above 2 because the 'what' is more specific than vague examples like 'Helps with documents'.

3 / 5

Trigger Term Quality

'Article illustrations' plus 'type', 'style', and 'palette' are relevant, on-point keywords a user might use. However, common natural variations — 'illustrate article', 'add images', '配图', 'figures' — are absent, which fits anchor 3 (some relevant keywords but missing common variations or synonyms) rather than 4.

3 / 5

Distinctiveness Conflict Risk

The niche — article illustration governed by a type × style × palette consistency model — is mostly distinct from document/data-processing skills, with only minor overlap risk against generic image-generation skills. It falls short of 5 because the terse description provides no trigger context that would sharpen the boundary.

4 / 5

Total

12

/

20

Passed

Validation

75%

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

Validation — 12 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_version

'metadata.version' is missing

Warning

metadata_field

'metadata' should map string keys to string values

Warning

frontmatter_unknown_keys

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

Warning

relative_links

Relative link issues: 1 missing

Warning

Total

12

/

16

Passed

Repository

NousResearch/hermes-agent

Path

optional-skills/creative/baoyu-article-illustrator/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.