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

66%

Does it follow best practices?

Impact

Pending

No eval scenarios have been run

Securityby

Passed

No known issues

Optimize this skill with Tessl

npx tessl skill review --optimize ./.claude/skills/card-news-generator-v2/SKILL.md

Quality

Discovery

67%

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

This description excels at specificity and distinctiveness with clear, concrete capabilities around Instagram card creation. However, it lacks an explicit 'Use when...' trigger clause and could benefit from more natural user-facing keywords like 'social media', 'carousel', or 'IG' to improve discoverability.

Suggestions

Add an explicit 'Use when...' clause, e.g., 'Use when the user wants to create Instagram posts, social media cards, or carousel content.'

Include additional trigger terms users might naturally say: 'social media posts', 'carousel', 'IG cards', 'infographic series', 'square posts'.

Dimension	Reasoning	Score
Specificity	Lists multiple concrete actions: 'Create 600x600 Instagram-style card news series', 'optional background images', 'generates content', 'creates multiple cards with proper text wrapping'. These are specific, actionable capabilities.	3 / 3
Completeness	Clearly describes WHAT it does (create Instagram card news with images, text wrapping, etc.) but lacks an explicit 'Use when...' clause. The when is only implied through the description of inputs.	2 / 3
Trigger Term Quality	Includes some natural terms like 'Instagram', 'card news', 'cards', but missing common variations users might say like 'social media posts', 'carousel', 'infographic cards', or 'IG posts'.	2 / 3
Distinctiveness Conflict Risk	Very specific niche: '600x600 Instagram-style card news series' with specific dimensions and format. Unlikely to conflict with general image or document skills due to the precise Instagram card focus.	3 / 3
	Total	10 / 12 Passed

Implementation

64%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

This skill provides highly actionable, executable guidance for card news generation with good examples and clear command syntax. However, it's verbose with some redundant explanations and lacks validation checkpoints in the workflow. The monolithic structure could benefit from splitting technical details into separate reference files.

Suggestions

Add a validation step after card generation (e.g., 'Verify output: check that all cards exist and text fits within canvas bounds')

Move Technical Details, Recommended Colors, and Error Handling sections to a separate REFERENCE.md file to reduce main skill length

Remove the RGB to Hex conversion section - Claude can perform this conversion without explicit instructions

Dimension	Reasoning	Score
Conciseness	The skill contains some redundancy (e.g., explaining RGB to hex conversion that Claude knows, repeating similar example conversations). The good/bad content examples are helpful but the overall document could be tightened by ~30%.	2 / 3
Actionability	Provides fully executable bash commands with heredoc syntax, complete parameter lists, and copy-paste ready examples for both solid color and background image modes. All commands include concrete paths and values.	3 / 3
Workflow Clarity	Steps are clearly numbered (1-4) with good sequencing, but lacks validation checkpoints. No verification step after card generation to check if text overflowed or images loaded correctly. Error handling section exists but isn't integrated into the workflow.	2 / 3
Progressive Disclosure	Content is reasonably organized with clear sections, but the document is monolithic at ~250 lines. Technical details, color recommendations, and example workflows could be split into separate reference files for better navigation.	2 / 3
	Total	9 / 12 Passed

Validation

100%

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 — 11 / 11 Passed

Validation for skill structure

No warnings or errors.

Repository: bear2u/my-skills
Commit: 1be5394

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