CtrlK
BlogDocsLog inGet started
Tessl Logo

baoyu-article-illustrator

Analyzes article structure, identifies positions requiring visual aids, generates illustrations with Type × Style × Palette three-dimension approach. Use when user asks to "illustrate article", "add images", "generate images for article", or "为文章配图".

67

Quality

84%

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

85%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 well-architected instruction skill: a tight overview with one-level-deep references that all resolve, a gated 6-step workflow with blocking validation and retry feedback loops, and consistently actionable guidance with exact paths and flags. The only slack is mild verbosity in the backend-resolution branches and reliance on references for full prompt templates.

DimensionReasoningScore

Conciseness

The body is dense and mostly actionable with exact paths, flags, and naming conventions, and the ⛔ guardrails earn their tokens; it is efficient with only minor over-explanation. It is not a 5 because the multi-branch backend-resolution list and some repeated caveats could be trimmed, and not a 3 because the content is largely necessary domain-specific policy rather than padding.

4 / 5

Actionability

Concrete, executable guidance pervades the body — exact file naming (NN-{type}-{slug}.md), flag syntax (--type/--style/--palette/--preset), path tables, and a numbered 6-step workflow. It is not a 5 because the actual prompt templates and detailed sub-procedures are delegated to references rather than inlined, leaving minor gaps in self-contained executability; not a 3 because what is written is specific and actionable, not pseudocode.

4 / 5

Workflow Clarity

The 6-step workflow is a checklist with explicit blocking validation gates ("⛔ BLOCKING", "Hard gate", prompt-files-must-exist-before-generation), confirmation policy, and feedback loops (retry once on failure, regenerate-from-corrected-prompt for text fixes). This matches the 5 anchor (clear sequence + explicit validation + feedback loops + checklists), and the batch/destructive operation correctly includes validation.

5 / 5

Progressive Disclosure

SKILL.md is a clear overview that signals one-level-deep references via markdown links and a References table (workflow.md, styles.md, style-presets.md, prompt-construction.md, codex-imagegen.md, config/*), and all referenced paths exist as real bundle files. Content is appropriately split (procedures, styles/, palettes/), giving easy navigation matching the 5 anchor.

5 / 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 that concretely states what the skill does and when to use it, with natural trigger phrases in both English and Chinese. It is held back only by minor coverage gaps in action enumeration and some overlap-prone generic image triggers.

Suggestions

Add a couple more natural trigger variations (e.g., "配图", "插图", "add pictures to article") to push trigger-term coverage toward comprehensive.

Sharpen distinctiveness by leading with the article-scoped framing (e.g., "For articles only") so generic "add images" requests don't match a general image-gen skill first.

Optionally mention the edit/refine action in the description so the action list reads as comprehensive rather than generation-only.

DimensionReasoningScore

Specificity

"Analyzes article structure, identifies positions requiring visual aids, generates illustrations with Type × Style × Palette three-dimension approach" names three concrete actions plus the organizing approach, listing several specific actions with only minor coverage gaps. It is not a 3 (only 1–2 actions) nor a 5 (not fully comprehensive — it omits refinement/editing actions covered later in the body).

4 / 5

Completeness

It explicitly answers both what (analyze structure, identify positions, generate illustrations via Type×Style×Palette) and when ("Use when user asks to 'illustrate article'...") with concrete trigger phrases, matching the 5 anchor. It clearly exceeds 4 because the 'when' clause is concrete and explicit rather than weakly implied.

5 / 5

Trigger Term Quality

Includes natural phrases users say — "illustrate article", "add images", "generate images for article", and the Chinese synonym "为文章配图" — giving good keyword coverage with a translated variant. It falls short of 5 because common variations like "配图", "插图", or "add pictures" are absent.

4 / 5

Distinctiveness Conflict Risk

The article-illustration niche with Type×Style×Palette framing is mostly distinct and well-targeted, but generic triggers like "add images" and "generate images" create minor overlap risk with general image-generation skills such as baoyu-image-gen. It is not a 5 because of that residual overlap, and not a 3 because the niche is clearly bounded.

4 / 5

Total

17

/

20

Passed

Validation

68%

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

Validation — 11 / 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, 2 deeper-than-1-level

Warning

referenced_paths_exist

Referenced path issues: 1 missing, 4 deeper-than-1-level

Warning

Total

11

/

16

Passed

Repository
JimLiu/baoyu-skills
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.