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.

Quality

76%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Low

Low-risk findings worth noting

Fix and improve this skill with Tessl

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

Quality

Content

59%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 highly actionable, well-coded reference that is let down by verbosity/repetition and by a complete failure to use the provided bundle files: the SKILL.md inlines material that the references/ and scripts/ bundles were meant to offload, with no navigation pointers to them.

Suggestions

Replace the inlined Vanta effects catalog and Zdog shape/animation reference with concise summaries plus explicit links to references/vantajs_effects.md, references/zdog_api.md, and references/tilt_patterns.md so SKILL.md becomes an overview rather than a monolith.

Deduplicate repeated code blocks (e.g., the WAVES setup and the mobile-detection snippet each appear twice) and remove basic explanations Claude already knows (e.g., what a gyroscope is, elementary CSS).

Add a short 'Getting started' pointer to assets/starter_lightweight/ and a note on when to use scripts/generate_zdog.py and scripts/setup_vanta.py, and define the missing createStarIcon/createCheckIcon helpers in the Zdog icon-grid pattern.

Dimension	Reasoning	Score
Conciseness	Mostly efficient reference material, but the ~1085-line body repeats setups (e.g., the WAVES config appears in both Basic Setup and Available Effects, mobile-detection logic appears in both Performance Best Practices and Pitfalls) and explains basics Claude already knows, so it cannot score above 'mostly efficient with some unnecessary explanation'.	3 / 5
Actionability	Provides fully executable, copy-paste-ready code with real CDN URLs, complete HTML files, and working JS across all three libraries plus React integration; held below 5 by small gaps such as Pattern 2 referencing undefined createStarIcon/createCheckIcon helpers.	4.5 / 5
Workflow Clarity	Content is organized by topic with useful problem/cause/solution troubleshooting in Common Pitfalls, but there is no explicit sequenced multi-step workflow with validation checkpoints; the destructive/batch cap does not apply since no risky batch operations are present.	3 / 5
Progressive Disclosure	Bundle files exist (references/tilt_patterns.md, vantajs_effects.md, zdog_api.md, scripts/generate_zdog.py, setup_vanta.py, assets/examples, assets/starter_lightweight) but the body references NONE of them, inlining ~1085 lines of API reference and patterns that clearly belong in those separate files, matching the 'content that should be separate is inline and references are not signaled' anchor.	2.5 / 5
	Total	13 / 20 Passed

Description

93%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, specific description that clearly states what the skill does and when to use it, with concrete trigger terms anchored to three named libraries. Minor redundancy in capability phrasing keeps it just short of perfect on specificity and trigger coverage.

Dimension	Reasoning	Score
Specificity	Lists multiple concrete actions ('adding pseudo-3D illustrations, animated backgrounds, parallax tilt effects, decorative 3D elements, or subtle depth effects') tied to named libraries, giving comprehensive coverage; held just below 5 by mild redundancy between 'decorative 3D elements' and 'pseudo-3D illustrations'.	4.5 / 5
Completeness	Explicitly answers both 'what' ('Lightweight 3D effects ... using Zdog, Vanta.js, and Vanilla-Tilt.js') and 'when' ('Use this skill when adding ...', 'Triggers on tasks involving ...') with concrete trigger phrases.	5 / 5
Trigger Term Quality	Strong natural-term coverage including library names plus common UI phrases ('card tilt effects', 'hero section animations', 'parallax tilt effects', 'animated backgrounds'); a few synonyms or file-extension forms are absent, keeping it below a 5.	4.5 / 5
Distinctiveness Conflict Risk	Names three specific libraries and carves a clear niche (lightweight decorative 3D without heavy frameworks), giving distinct triggers with minimal overlap risk; third-person voice used throughout with no penalty.	5 / 5
	Total	19 / 20 Passed

Validation

87%

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 — 14 / 16 Passed

Validation for skill structure

Criteria	Description	Result
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
Commit: 6a9a551

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