r3f-lighting

React Three Fiber lighting - light types, shadows, Environment component, IBL. Use when adding lights, configuring shadows, setting up environment lighting, or optimizing lighting performance.

Quality

74%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./.agents/skills/r3f-lighting/SKILL.md

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.

A comprehensive, actionable R3F lighting reference with strong code examples and good section organization. Its main weaknesses are the monolithic structure with no progressive disclosure to bundle files and the absence of explicit validation checkpoints in its setup sequences.

Suggestions

Move detailed reference material (e.g., full drei helper catalog, common lighting setups) into separate files under references/ and link to them from SKILL.md to improve progressive disclosure.

Add explicit verification steps to the Shadow Setup workflow (e.g., confirm shadow-camera frustum covers the scene via the CameraHelper, check shadow-bias for acne/peter-panning) to add validation checkpoints.

De-duplicate the useHelper/shadow-helper examples shown in multiple sections, or consolidate them into a single 'Helpers' reference, to tighten conciseness.

Dimension	Reasoning	Score
Conciseness	Mostly lean reference prose with one-line descriptions plus code, assuming React/Three.js knowledge; minor redundancy (useHelper and shadow-helper patterns repeated across sections) could be trimmed.	4 / 5
Actionability	Abundant concrete, copy-paste-ready TSX snippets covering common cases, but several snippets omit imports (e.g., useRef in DirectionalWithTarget) and a few use loose patterns, leaving minor gaps.	4 / 5
Workflow Clarity	Sequences exist in places (shadow setup: enable on Canvas, configure casters; common lighting setups), but there are no explicit validation checkpoints or feedback loops, and the skill is more reference catalog than guided workflow.	3 / 5
Progressive Disclosure	Well-organized with clear headers, a Quick Start, and an overview table, but it is a ~670-line monolithic file with no bundle files; detailed reference material (drei helpers, common setups) that could live in separate files is inlined.	3 / 5
	Total	14 / 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.

A strong, well-structured description that names the domain, lists concrete capabilities, and provides explicit 'Use when' trigger guidance. Minor improvements could add common synonyms (HDR/HDRI, R3F) and clarify the boundary with materials/textures skills.

Suggestions

Add common synonyms/extensions users might say, e.g., 'HDR/HDRI', 'R3F', or 'lighting setup', to broaden trigger-term coverage.

Clarify the boundary with r3f-textures/r3f-materials to reduce overlap risk around environment maps and light response.

Dimension	Reasoning	Score
Specificity	Lists several concrete capabilities ('light types, shadows, Environment component, IBL') and concrete trigger actions ('adding lights, configuring shadows, setting up environment lighting, or optimizing lighting performance'), with minor gaps (e.g., animated lighting, helpers not mentioned).	4 / 5
Completeness	Explicitly answers both 'what' (light types, shadows, Environment component, IBL) and 'when' via a concrete 'Use when ...' trigger clause, matching the anchor for clearly answering both.	5 / 5
Trigger Term Quality	Natural phrases users would say are present ('adding lights', 'configuring shadows', 'environment lighting', 'optimizing lighting performance'), but a few common synonyms/extensions are missing (e.g., 'HDR/HDRI', 'lighting setup', 'R3F').	4 / 5
Distinctiveness Conflict Risk	'React Three Fiber lighting' is a clear niche with distinct triggers, but environment/IBL coverage has minor overlap risk with sibling skills like r3f-textures (environment maps).	4 / 5
	Total	17 / 20 Passed

Validation

93%

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

Validation for skill structure

Criteria	Description	Result
skill_md_line_count	SKILL.md is long (674 lines); consider splitting into references/ and linking	Warning

	Total	15 / 16 Passed

Repository: AzizBelhassan/timeverse
Path: .agents/skills/r3f-lighting/SKILL.md
Commit: 9dc2cb4

Reviewed: ~15 hours 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.