CtrlK
BlogDocsLog inGet started
Tessl Logo

vrm-springbone-physics

Debugging and fixing VRM SpringBone physics issues in three-vrm, including hair/clothing physics that flies upward, sticks out horizontally, or behaves unnaturally.

63

Quality

73%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./.agent/skills/vrm-physics/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

65%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

The content is highly actionable with executable code and a clear symptom-to-root-cause diagnostic structure, but it is verbose and monolithic. Repeated collider-reduction logic and inline reference material inflate the token budget without progressive disclosure.

Suggestions

De-duplicate the 50% collider-reduction logic: present it once and have other sections reference it instead of restating the code.

Move the API reference and joint-settings tables and the Unity fix steps into a references/ file (e.g. REFERENCE.md) and link to it from the body to enable progressive disclosure.

Add an explicit ordered diagnostic workflow (e.g. 1. check delta, 2. disable colliders to confirm, 3. apply reduction, 4. verify) with a validation checkpoint so workflow clarity reaches a sequenced validate→fix→retry loop.

Trim speculative prose about why the 50% factor works to a single concise caveat.

DimensionReasoningScore

Conciseness

The 50% collider-reduction logic is restated across Root Cause 2 (Option 1), Option 5, the Recommended Initialization Code, and Root Cause 2B, and speculative prose ("VRoid Studio may use consistent internal scaling...") pads uncertain reasoning; it is above score-1 because the bulk is useful actionable content, but not score-3 due to clear redundancy and speculative explanation that could be tightened.

2 / 3

Actionability

It provides copy-paste-ready JavaScript for delta clamping, collider reduction, scene scaling, and diagnosis, plus Unity fix steps and API/joint-settings reference tables, matching the score-3 anchor for fully executable code; minor scope inconsistencies (Option 3 references an undefined `colliders` variable) keep it from being flawless but it remains copy-paste ready overall.

3 / 3

Workflow Clarity

Symptoms branch into parallel root-cause tracks with a useful disable-to-confirm diagnosis step, but there is no single ordered procedure with explicit validate→fix→retry checkpoints, matching the score-2 anchor for steps present but checkpoints implicit; it is not score-3 because the feedback loop is informal and not a sequenced validation workflow.

2 / 3

Progressive Disclosure

No references/scripts/assets bundle files exist and the ~270-line body is monolithic, with API reference tables, Unity fix steps, and the empirical-fix rationale all inline; it is above score-1 because internal section headers organize the content, but not score-3 since content that should be split into one-level-deep reference files is kept inline.

2 / 3

Total

9

/

12

Passed

Description

82%

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 specific and distinct, naming a clear niche with natural trigger terms and concrete symptoms. Its main weakness is the absence of an explicit "Use when..." clause, which leaves the invocation timing implied rather than stated.

Suggestions

Add an explicit trigger clause, e.g. "Use when debugging VRM hair/clothing physics in @pixiv/three-vrm that flies upward, sticks out horizontally, or behaves unnaturally."

Lead with the concrete remediation actions (e.g. "Clamp delta time, reduce collider radii, fix runtime scene scaling") rather than only the diagnostic symptoms.

DimensionReasoningScore

Specificity

Names the domain ("VRM SpringBone physics issues in three-vrm") and lists multiple concrete symptom behaviors ("hair/clothing physics that flies upward, sticks out horizontally, or behaves unnaturally"), matching the score-3 anchor for multiple specific concrete actions; it is not score-2 because the symptoms are concrete and multi-valued rather than a single vague action.

3 / 3

Completeness

It clearly states what ("Debugging and fixing VRM SpringBone physics issues") but lacks an explicit "Use when..." trigger clause, so the "when" is only implied via the symptom list; per the judging guidelines a missing explicit trigger caps completeness at 2, and it is not score-3 because there is no clear explicit-when statement.

2 / 3

Trigger Term Quality

Natural user-facing terms like "VRM SpringBone physics", "hair/clothing physics", "flies upward", and "sticks out horizontally" are exactly what a user with this problem would say, giving good coverage per the score-3 anchor; it is above score-2 because the terms are varied and natural rather than a single jargon phrase.

3 / 3

Distinctiveness Conflict Risk

"VRM SpringBone physics" is a narrow, well-defined niche with distinctive triggers unlikely to overlap with unrelated skills, matching the score-3 anchor for a clear niche with distinct triggers; it is not score-2 because the domain is specific rather than broadly overlapping.

3 / 3

Total

11

/

12

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.

Validation16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
Project-N-E-K-O/N.E.K.O
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.