CtrlK
BlogDocsLog inGet started
Tessl Logo

iwsdk-physics

Guide for implementing physics in IWSDK projects. Use when adding physics simulation, configuring rigid bodies, collision shapes, applying forces, creating grabbable physics objects, or troubleshooting physics behavior.

91

1.02x
Quality

Does it follow best practices?

Impact

99%

1.02x

Average score across 3 eval scenarios

SecuritybySnyk

Passed

No known issues

SKILL.md
Quality
Evals
Security

Quality

Content

77%

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

The body is a thorough, actionable physics reference with executable code and clear workflows, but it is monolithic and somewhat verbose. Splitting reference material into bundle files and trimming the redundant complete example would improve both conciseness and progressive disclosure.

Suggestions

Move the Material Tuning Guide, Troubleshooting, Performance Tips, and Complete Example into separate reference files (e.g. TROUBLESHOOTING.md, MATERIALS.md) linked from SKILL.md to improve progressive disclosure and reduce the main file's length.

Trim or remove the "Complete Example: Physics Playground" section, since it largely duplicates the individual Common Workflows examples already shown above.

Add a brief "Quick start" summary at the top pointing to the detailed component reference and workflow sections, so the overview guides navigation rather than front-loading all detail.

DimensionReasoningScore

Conciseness

The body is mostly efficient API reference with no basic-concept padding, but at ~600 lines it includes redundant material — notably the "Complete Example: Physics Playground" duplicates the individual workflow examples — so it could be tightened.

2 / 3

Actionability

Provides fully executable, copy-paste-ready TypeScript snippets with concrete property tables and enum values, matching the level-3 anchor for executable code and specific examples.

3 / 3

Workflow Clarity

Workflows like "Creating a Dynamic Physics Object" are clearly numbered (1–4) and sequenced; physics setup is not a destructive/batch operation requiring validation checkpoints, and the Troubleshooting section supplies error-recovery guidance.

3 / 3

Progressive Disclosure

Sections are well-organized, but the skill is a monolithic ~600-line SKILL.md with no bundle files and no references split out — content such as the material tuning guide, troubleshooting, and complete example are inline when they could be separate files.

2 / 3

Total

10

/

12

Passed

Description

100%

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 concise, uses third-person voice, and clearly states both capability and trigger conditions with concrete, natural-language terms. It is a strong, well-scoped description with no over-claims or fluff.

DimensionReasoningScore

Specificity

Lists multiple concrete actions — "adding physics simulation, configuring rigid bodies, collision shapes, applying forces, creating grabbable physics objects, or troubleshooting physics behavior" — matching the level-3 anchor of multiple specific concrete actions.

3 / 3

Completeness

Explicitly states what ("Guide for implementing physics in IWSDK projects") and when ("Use when adding physics simulation...") with an explicit trigger clause, satisfying the level-3 anchor for both what and when.

3 / 3

Trigger Term Quality

Covers natural terms a user would say ("physics simulation", "rigid bodies", "collision shapes", "applying forces", "grabbable physics objects", "troubleshooting physics") with good variation, matching the level-3 anchor.

3 / 3

Distinctiveness Conflict Risk

Scoped specifically to IWSDK physics with distinct triggers, making it unlikely to fire for unrelated skills; matches the level-3 clear-niche anchor.

3 / 3

Total

12

/

12

Passed

Validation

93%

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

Validation15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

skill_md_line_count

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

Warning

Total

15

/

16

Passed

Repository
facebook/immersive-web-sdk
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.