card-news-generator-v2

Create 600x600 Instagram-style card news series automatically with optional background images. User provides topic, colors, and optional images - Claude generates content and creates multiple cards with proper text wrapping.

Quality

54%

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 ./skills/card-news-generator-v2/SKILL.md

Quality

Content

50%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 highly actionable with concrete commands and examples, but it is verbose for a single-file skill, lacks a validation checkpoint in its batch workflow, and inlines material that would benefit from separate reference files. Trimming known-concept explanations and adding a verify step would lift the weakest dimensions.

Suggestions

Remove or condense the "RGB to Hex Conversion" and "Recommended Colors" sections — Claude already knows these — and merge the redundant "Example Workflows" into the core workflow.

Add an explicit validation checkpoint after auto_generator.py runs (e.g. verify the expected PNG files exist and report any missing) before presenting download links.

Split the technical details, color palette, and extended examples into reference files under references/ and link to them from SKILL.md to improve progressive disclosure and token efficiency.

Dimension	Reasoning	Score
Conciseness	The ~300-line body includes several padded sections Claude does not need — "RGB to Hex Conversion", a six-entry "Recommended Colors" table, and an "Example Workflows" section that largely restates the core workflow. Not a 1 because the core heredoc commands and content guidelines are genuinely useful and not pure fluff.	2 / 5
Actionability	Provides copy-paste-ready commands for auto_generator.py and generate_card.py with full flags plus complete heredoc content examples covering solid-color, background-image, and single-card cases. Not a 5 because the referenced scripts are not bundled in the skill, leaving a minor gap between instruction and execution.	4 / 5
Workflow Clarity	Steps 1–4 are clearly sequenced, but this is a batch operation with no validation/verification checkpoint confirming cards were generated before presenting download links, so workflow_clarity is capped at 3 per the batch-operation rule.	3 / 5
Progressive Disclosure	Section headers give reasonable structure, but at ~300 lines the file is monolithic with no external references and inlines content (color palette, technical specs, example workflows) that would fit better in separate files. Not a 4 because nothing is split out and no references are signaled.	3 / 5
	Total	12 / 20 Passed

Description

58%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 clearly conveys what the skill does with several concrete actions and a distinct niche, but it omits any explicit "Use when..." trigger guidance and has only partial natural-keyword coverage. Adding an explicit trigger clause would lift the two lowest dimensions.

Suggestions

Add an explicit 'Use when...' clause with concrete triggers, e.g. 'Use when the user asks for card news, Instagram card series, or visual card content (e.g. 카드 뉴스, 인스타용 카드).'

Expand trigger-term coverage with synonyms and the natural Korean phrases users say ('카드 뉴스 만들어줘', '카드 시리즈') to raise trigger_term_quality.

Mention the concrete output (e.g. saves PNG cards to an output directory) to round out specificity toward comprehensive coverage.

Dimension	Reasoning	Score
Specificity	Lists several concrete actions — "Create 600x600 Instagram-style card news series", "generates content and creates multiple cards", "proper text wrapping", "optional background images" — with only minor gaps (e.g., output saving not stated). Not a 5 because coverage is not comprehensive and a few capabilities are only implied.	4 / 5
Completeness	The "what" is clear (create card news series with images/text wrapping), but there is no "Use when..." clause or equivalent explicit trigger guidance, which caps completeness at 3 per the rubric guidelines.	3 / 5
Trigger Term Quality	Contains the natural term "card news" and "Instagram-style" plus "background images", but misses common variations/synonyms and any file-extension triggers. Not a 4 because keyword coverage is partial rather than good.	3 / 5
Distinctiveness Conflict Risk	The "600x600 Instagram-style card news" niche is fairly distinct with low conflict risk against generic skills. Not a 5 because the missing explicit triggers leave minor overlap ambiguity with general image/card 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
relative_links	Relative link issues: 2 suspicious	Warning

	Total	15 / 16 Passed

Repository: bear2u/my-skills
Path: skills/card-news-generator-v2/SKILL.md
Commit: 8ed5784

Reviewed: 10 days 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.