CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

lightweight-3d-effects

Lightweight 3D effects for decorative elements and micro-interactions using Zdog, Vanta.js, and Vanilla-Tilt.js. Use this skill when adding pseudo-3D illustrations, animated backgrounds, parallax tilt effects, decorative 3D elements, or subtle depth effects without heavy frameworks. Triggers on tasks involving Zdog pseudo-3D, Vanta.js backgrounds, Vanilla-Tilt parallax, card tilt effects, hero section animations, or lightweight landing page visuals. Ideal for performance-focused designs.

56

Quality

70%

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

Fix and improve this skill with Tessl

tessl review fix ./.agents/skills/lightweight-3d-effects/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

46%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 skill delivers strong, executable code for all three libraries and useful pitfall/performance guidance, but it functions as a monolithic reference rather than an overview. It duplicates its own bundle's reference files inline while never linking to them, and it offers no task-oriented workflow tying the libraries together.

Suggestions

Replace the inlined Zdog shape/animation API, Vanta effect catalog, and Vanilla-Tilt config listings with brief quick-start snippets plus clearly signaled links to references/zdog_api.md, references/vantajs_effects.md, and references/tilt_patterns.md, which already exist in the bundle.

Add a short decision workflow (e.g., decorative illustration → Zdog; full-page background → Vanta; card hover effect → Vanilla-Tilt) with a setup-integrate-optimize sequence so the sections read as an ordered process rather than a menu.

Mention and link scripts/generate_zdog.py, scripts/setup_vanta.py, and assets/starter_lightweight/ from the body so users can discover and use them, and move pinned CDN version numbers into the referenced docs to keep the main file version-agnostic.

DimensionReasoningScore

Conciseness

The ~1090-line body inlines hundreds of lines of API reference and full config-option listings (e.g., the complete VanillaTilt options block and six Vanta effect configs) that duplicate the bundle's references/ files, repeats the same requestAnimationFrame animate loop three times, and includes 'Core Concepts' sections explaining what each library is. Pinned version numbers (three@0.134.0, vanta@0.5.24, vanilla-tilt@1.8.1) are time-sensitive and not isolated in a deprecated section.

2 / 5

Actionability

Mostly executable, copy-paste-ready code: complete HTML setups for all three libraries, working React integrations with cleanup, and pitfall fixes like 'color: 0x23153c' vs string. Falls short of 5 because Pattern 2's icon grid calls createStarIcon and createCheckIcon which are never defined (only createHeartIcon is shown), leaving that example non-runnable as written.

4 / 5

Workflow Clarity

The body is organized as a reference menu (per-library setup, patterns, pitfalls) rather than a sequenced workflow — there is no guidance for choosing between libraries or ordering setup → integration → optimization for a given task. The pitfalls section provides implicit error-recovery (e.g., 'Zdog Not Rendering' causes/solutions), but no explicit checkpoints; not a destructive/batch skill so the cap-3 rule is not triggered, yet the sequence gaps keep it at 3.

3 / 5

Progressive Disclosure

The bundle provides references/zdog_api.md, vantajs_effects.md, tilt_patterns.md plus scripts/ and assets/, yet the body links to none of them — no reference, script, or asset file is mentioned anywhere. Meanwhile the equivalent API/config detail is inlined directly in SKILL.md, meaning the scripts (generate_zdog.py, setup_vanta.py) and starter assets are undiscoverable. This matches the anchor 'content that clearly belongs in separate files is inlined'; it avoids a 1 only because the body itself has clear section headers.

2 / 5

Total

11

/

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.

The description is a strong example: it names concrete libraries and actions, includes explicit dual trigger clauses ('Use this skill when...' and 'Triggers on...'), and stays in third person throughout. Its only weaknesses are slight generic phrasing in the capability list and a couple of broad trigger terms that could overlap with general animation skills.

DimensionReasoningScore

Specificity

The description names three concrete libraries and several specific actions ('adding pseudo-3D illustrations, animated backgrounds, parallax tilt effects'), but actions like 'decorative 3D elements, or subtle depth effects' are generic and partly repetitive of earlier phrases, leaving minor coverage gaps versus the comprehensive 5 anchor.

4 / 5

Completeness

Both questions are answered explicitly: the what ('Lightweight 3D effects ... using Zdog, Vanta.js, and Vanilla-Tilt.js') and the when with concrete trigger phrases in two forms ('Use this skill when adding...' and 'Triggers on tasks involving...'), matching the 5 anchor's pattern.

5 / 5

Trigger Term Quality

Good natural-term coverage: 'Zdog pseudo-3D, Vanta.js backgrounds, Vanilla-Tilt parallax, card tilt effects, hero section animations, or lightweight landing page visuals'. A few natural variations users might say are missing (e.g., '3D hover effect', 'tilt.js', 'animated hero'), so it falls just short of the comprehensive synonym coverage of the 5 anchor.

4 / 5

Distinctiveness Conflict Risk

Library-specific triggers (Zdog, Vanta.js, Vanilla-Tilt) give it a clear niche with minimal confusion risk, but 'hero section animations' and 'lightweight landing page visuals' are broad enough to overlap with general animation/CSS-skills, fitting 'mostly distinct; minor overlap risk with closely related skills' rather than the fully distinct 5 anchor.

4 / 5

Total

17

/

20

Passed

Validation

87%

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

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

skill_md_line_count

SKILL.md is long (1092 lines); consider splitting into references/ and linking

Warning

relative_links

Relative link issues: 1 missing

Warning

Total

14

/

16

Passed

Repository

jasonkneen/tiny-world-builder

Path

.agents/skills/lightweight-3d-effects/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.