CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

ai-card-generator

Generate AI Cards — HTML visual pages (single-file or folder-based multi-file) for scheduled automated reports. Use when: user wants to create a recurring visual card, hotspot tracker, daily digest, analytics panel, inspiration page, or any HTML-based automated visualization that updates on schedule. Trigger signals: AI card, inspiration card, generated card, visual report, hotspot tracker, daily digest, dashboard card, scheduled visualization, and equivalent requests in any user language. Skip when: the task is about creating social media posts (use self-media-composer), or simple file generation without recurring schedule.

Quality

81%

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

65%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 body is highly actionable with concrete file formats, code, and sequenced workflows, but the scheduled batch workflow lacks validation checkpoints, and progressive disclosure is weak: a large reference file sits unlinked while its content is duplicated inline, and preset-template paths referenced in the body are absent from the bundle. Length could be cut meaningfully by delegating spec detail to the existing reference.

Suggestions

Link `references/card-spec.md` from the body (e.g., under Directory Structure and Template Specification) and remove the duplicated layout/template-rule content from SKILL.md, keeping only the essentials inline.

Add validation checkpoints to the Scheduled Execution Workflow: verify the history archive copied successfully before overwriting `latest/`, and confirm the generated `latest/index.html` renders (e.g., data sections populated) before updating `magic.project.js` and dispatching notifications.

Fix or remove the `templates/` preset-template references (hotspot-tracker/, daily-digest/, analytics-panel/) — the directory does not exist in the bundle — or ship the templates and reference them explicitly.

DimensionReasoningScore

Conciseness

The body is mostly domain-specific contract detail Claude cannot infer, but it is noticeably padded: the directory tree repeats optional `styles.css`/`scripts.js`/`data/` entries across `template/`, `latest/`, and two `history/` subfolders, and the layout/template rules duplicate material that already exists in `references/card-spec.md`. This sits between anchor 2's 'several unnecessary padded sections' and anchor 4's 'efficient with minor trimming'.

3 / 5

Actionability

Guidance is copy-paste ready across the board: a complete `magic.project.js` config literal, a full HTML template skeleton with data-section markers, a concrete source-record JSON shape, a sandboxed-iframe HTML pattern, and a nearly executable Python snippet for `scheduled_task_create`. Specific examples cover the common cases (creation, scheduled update, notification), matching anchor 5.

5 / 5

Workflow Clarity

The Creation Workflow (Steps 0-3) and Scheduled Execution Workflow (steps 1-9) are clearly sequenced, and archiving before overwriting `latest/` is an implicit safety checkpoint. However, this is a batch/destructive workflow (copy ALL files, overwrite `latest/`) with no validation step confirming the archive succeeded or the output renders before proceeding, and no validate-fix-retry loop — the rubric caps such workflows at 3.

3 / 5

Progressive Disclosure

Section headers are clear, but the bundle's `references/card-spec.md` (337 lines, substantially overlapping the body's directory-layout and template rules) is never linked or signaled from SKILL.md, so its content is inlined instead of referenced. Additionally, the body points to a `templates/` directory (`hotspot-tracker/`, `daily-digest/`, `analytics-panel/`) that does not exist in the bundle. This matches anchor 3 ('references present but not clearly signaled; content that should be separate is inline') rather than anchor 2, since the in-body structure itself is well organized.

3 / 5

Total

14

/

20

Passed

Description

87%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 explicit what/when guidance, natural trigger terms, and an explicit skip clause that routes adjacent use cases elsewhere. The only minor gap is trigger-term breadth (a few common synonyms like "scheduled report" or "recurring report" are absent).

DimensionReasoningScore

Specificity

The description names concrete capabilities — "Generate AI Cards — HTML visual pages (single-file or folder-based multi-file) for scheduled automated reports" — and enumerates concrete card types (hotspot tracker, daily digest, analytics panel). It falls just short of anchor 5 because it centers on one action (generate/update) rather than a comprehensive list of distinct operations, but exceeds anchor 3's '1-2 concrete actions' breadth.

4 / 5

Completeness

It explicitly answers both questions: what ("Generate AI Cards — HTML visual pages ... for scheduled automated reports") and when ("Use when: user wants to create a recurring visual card, hotspot tracker, daily digest ..."), plus concrete trigger phrases and a "Skip when" exclusion. This matches anchor 5 exactly; anchor 4 would require the 'when' to be less explicit, which it is not.

5 / 5

Trigger Term Quality

"Trigger signals: AI card, inspiration card, generated card, visual report, hotspot tracker, daily digest, dashboard card, scheduled visualization, and equivalent requests in any user language" provides good natural-term coverage with synonyms. It misses a few common variations (e.g., "scheduled report", "weekly digest", "recurring report"), placing it below anchor 5's comprehensive coverage but clearly above anchor 3.

4 / 5

Distinctiveness Conflict Risk

A clear niche (scheduled HTML visual cards) with distinct triggers, and an explicit disambiguation clause — "Skip when: the task is about creating social media posts (use self-media-composer), or simple file generation without recurring schedule" — minimizes conflict risk with adjacent skills. This matches anchor 5; no neighboring anchor fits better.

5 / 5

Total

18

/

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

dtyq/magic

Path

backend/super-magic/agents/skills/ai-card-generator/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.