CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

x-image-cards

Create X/Twitter cards that look like images, not marketing banners. Use when asked to "create OG images", "set up X cards", "make social cards", or "twitter card without text".

86

1.78x
Quality

81%

Does it follow best practices?

Impact

91%

1.78x

Average score across 6 eval scenarios

SecuritybySnyk

—

The risk profile of this skill

SKILL.md
Quality
Evals
Security

Quality

Content

75%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 lean, knowledge-dense skill body that delivers X-specific constraints Claude would not know (retina sizing, safe margins, crawler timeouts, the zero-width space trick) with mostly executable code. Its weaknesses are small but real: two code examples contain placeholders or an await-in-non-async-callback bug, and the workflow lacks error-recovery guidance for failed card previews.

Suggestions

Fix the pre-generated route example — 'await db.get()' appears inside a non-async callback — and replace the '/* ... */' placeholder in the Express example with runnable code.

Add a short error-recovery note after the validator checklist item, e.g. what to check when the validator shows a blank preview (cold-start timeout, image URL reachability).

DimensionReasoningScore

Conciseness

The spec table ('2400×1200 physical (1200×600 logical)', 'X clips edges on mobile', 'X crawlers timeout after ~5 seconds') packs non-obvious domain knowledge densely with no tutorial filler, and nothing explains concepts Claude already knows. Minor trimmable padding exists — the promotional footer ('Built for BondTerminal...') and 'Pre-generation ensures instant response for crawlers' restating the earlier Risk note — which keeps it just below anchor 5's 'every token earns its place'.

4 / 5

Actionability

The meta-tags block and the @vercel/og route are concrete and nearly copy-paste ready. Minor gaps hold it at anchor 4: the Express example embeds '/* ... */' pseudocode inside new ImageResponse(...), and the pre-generated route calls 'await db.get()' inside a non-async callback, which would not run as written. Not 3, since the code is real and executable in the main paths rather than pseudocode-dominant.

4 / 5

Workflow Clarity

The body flows logically from specs to the title-overlay fix, meta tags, generation, and serving strategy, and the Checklist ends with an explicit validation checkpoint ('Test: https://cards-dev.twitter.com/validator'). Not 5 because steps are not explicitly ordered and there is no error-recovery loop (e.g., what to do when the validator shows a blank preview); not 3 because a concrete verification step is present rather than missing or implicit.

4 / 5

Progressive Disclosure

The single file is well-organized into clear sections with nothing buried, and no bundle files exist to reference. It exceeds the under-50-lines simple-skill exception for a reference-free 5, and advanced variants (Express serving, dynamic-route strategies) are inlined that could live in reference files — matching anchor 4's 'good structure; minor organization gaps' rather than anchor 5's well-signaled one-level-deep references.

4 / 5

Total

16

/

20

Passed

Description

78%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 an explicit 'Use when...' clause carrying natural quoted trigger phrases, which anchors its completeness at the top level. Its main weakness is the thin 'what' clause — a single generic action — which leaves specificity at the midpoint and slightly weakens distinctiveness against general OG-image skills.

Suggestions

Expand the 'what' clause to list 2-3 concrete capabilities, e.g. 'Set up card meta tags, generate 2x-retina images with @vercel/og, and hide X's title overlay' to raise specificity and distinctiveness.

Add trigger variants users naturally say, such as 'open graph image', 'link preview', or 'share preview', to broaden keyword coverage toward comprehensive.

DimensionReasoningScore

Specificity

Names the domain ('X/Twitter cards') and one concrete action ('Create') with a style constraint ('look like images, not marketing banners'), but does not enumerate multiple capabilities such as meta tag setup, dynamic image generation, or hiding X's title overlay. Fits the anchor for 1-2 concrete actions that are not comprehensive — not 4, which requires several specific actions listed.

3 / 5

Completeness

Explicitly answers both 'what' ('Create X/Twitter cards that look like images, not marketing banners') and 'when' ('Use when asked to...') with concrete quoted trigger phrases. Matches the anchor-5 example pattern of a clear what paired with an explicit, maximally specific when clause — the when here is not one that 'could be more explicit', ruling out 4.

5 / 5

Trigger Term Quality

Includes four natural, quoted phrases users would actually say ('create OG images', 'set up X cards', 'make social cards', 'twitter card without text'). Falls short of anchor 5 because common variants like 'open graph image', 'OG tags', 'link preview', or 'share preview' are missing, but coverage is well beyond anchor 3's 'some relevant keywords'.

4 / 5

Distinctiveness Conflict Risk

The X-card appearance niche is distinct, but the trigger 'create OG images' (and to a lesser degree 'make social cards') would plausibly fire a generic Open Graph image-generation skill, creating minor overlap risk with a closely related skill. Not 5 ('minimal conflict risk') because of that overlap; not 3 because the skill's framing is clearly its own niche rather than broadly overlapping.

4 / 5

Total

16

/

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

NeverSight/learn-skills.dev

Path

data/skills-md/0juano/x-image-cards/x-image-cards/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.