CtrlK
BlogDocsLog inGet started
Tessl Logo

spline-3d-integration

Use when adding interactive 3D scenes from Spline.design to web projects, including React embedding and runtime control API.

56

Quality

63%

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 ./plugins/AI-Agents-Safe-Coding-Skills/skills/spline-3d-integration/SKILL.md

The canonical home for this skill is spline-3d-integration in administrakt0r/AI-Agents-Safe-Coding-Skills

SKILL.md
Quality
Evals
Security

Quality

Content

53%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 serves as a reasonable routing document that directs Claude to the right guide based on the tech stack, with a useful pre-export checklist. However, it lacks any executable code in the main file, explains concepts Claude already knows (what Spline is), and the 'Strict Rules' section contains subjective style mandates rather than technical constraints. The absence of bundle files makes it impossible to verify that the deferred content actually exists, which significantly undermines the skill's practical value.

Suggestions

Remove the 'What Is Spline?' section — Claude already knows what Spline is; at most keep one sentence if context is needed for the URL format.

Add at least one minimal executable code example inline (e.g., the simplest vanilla HTML embed) so the skill is actionable without requiring external files.

Replace the subjective 'Strict Rules' mandate about 'wow-factor premium experiences' with concrete technical constraints or remove it entirely — it's not actionable guidance.

Add a validation step after integration (e.g., 'Verify: open browser console, confirm no CORS errors, check scene renders within 5 seconds') to provide a feedback loop.

DimensionReasoningScore

Conciseness

The 'What Is Spline?' section explains something Claude already knows. The 'Strict Rules' section contains subjective style mandates that are more opinion than instruction. The tables and steps are reasonably efficient, but there's noticeable padding that could be trimmed.

3 / 5

Actionability

The skill provides a clear decision framework (stack identification, URL acquisition steps with specific settings) but contains no executable code itself — all concrete implementation is deferred to guide files and examples that are not provided in the bundle. The Play Settings checklist is actionable but the core integration steps are abstract pointers.

3 / 5

Workflow Clarity

There's a clear 3-step sequence (identify stack → get URL → read guide), and the Play Settings checklist is a useful checkpoint. However, there are no validation steps (e.g., verify the scene loads, check console for errors), and the actual implementation workflow is entirely deferred to external guides that aren't provided. No feedback loops for error recovery.

3 / 5

Progressive Disclosure

The skill is well-structured as an overview with clear one-level-deep references to guides and examples via tables. The references are clearly signaled and organized. However, since no bundle files are provided, we cannot verify the referenced files exist, and the instruction to 'always read COMMON_PROBLEMS.md before finishing' could be more prominently placed rather than buried in Step 3.

4 / 5

Total

13

/

20

Passed

Description

73%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 effectively identifies a clear niche (Spline.design 3D integration) and includes an explicit 'Use when' clause, making it strong on completeness and distinctiveness. However, it could benefit from listing more specific capabilities beyond 'React embedding and runtime control API' and including additional trigger terms users might naturally use.

Suggestions

Expand the 'what' portion with more specific actions, e.g., 'loading Spline scenes, triggering animations, handling object events, controlling camera views'.

Add natural trigger term variations such as '@splinetool/react-spline', 'embed 3D model', 'Spline viewer', or '.splinecode' to improve keyword coverage.

DimensionReasoningScore

Specificity

Names the domain (Spline.design 3D scenes) and mentions two concrete actions (React embedding and runtime control API), but doesn't elaborate on what specific operations are supported (e.g., loading scenes, triggering animations, handling events).

3 / 5

Completeness

Has an explicit 'Use when' clause that specifies the trigger scenario (adding interactive 3D scenes from Spline.design to web projects), and the 'what' is partially covered (React embedding and runtime control API). The 'when' is clear but the 'what' could be more detailed about specific capabilities.

4 / 5

Trigger Term Quality

Includes good natural keywords like '3D scenes', 'Spline.design', 'React embedding', and 'runtime control API'. However, it's missing some natural variations users might say such as 'Spline viewer', '@splinetool/react-spline', 'embed 3D model', or 'interactive 3D'.

4 / 5

Distinctiveness Conflict Risk

Highly distinctive — Spline.design is a very specific tool, and the combination of '3D scenes', 'Spline.design', 'React embedding', and 'runtime control API' creates a clear niche with minimal risk of conflicting with other skills.

5 / 5

Total

16

/

20

Passed

Validation

90%

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

Validation10 / 11 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

10

/

11

Passed

Repository
administrakt0r/AI-Agents-Safe-Coding-Skills
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.