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.
84
77%
Does it follow best practices?
Impact
99%
1.02xAverage score across 3 eval scenarios
Passed
No known issues
Optimize this skill with Tessl
npx tessl skill review --optimize ./packages/starter-assets/claude-injections/skills/iwsdk-physics/SKILL.mdQuality
Discovery
89%Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.
This is a solid skill description that clearly identifies its niche (physics in IWSDK projects) and provides explicit 'Use when' guidance with relevant trigger terms. Its main weakness is that the 'what' portion is somewhat high-level ('Guide for implementing physics') rather than listing specific concrete actions the skill enables. Overall it performs well for skill selection purposes.
Suggestions
Replace 'Guide for implementing physics' with more specific concrete actions, e.g., 'Sets up physics bodies, configures collision detection, applies forces and impulses, and creates interactive grabbable objects in IWSDK projects.'
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | The description names the domain (physics in IWSDK projects) and lists several actions like 'configuring rigid bodies, collision shapes, applying forces, creating grabbable physics objects,' but these read more like a topic list than concrete actions the skill performs. It says 'Guide for implementing' rather than listing specific outputs or transformations. | 2 / 3 |
Completeness | Clearly answers both 'what' (guide for implementing physics in IWSDK projects) and 'when' with an explicit 'Use when...' clause listing specific trigger scenarios like adding physics simulation, configuring rigid bodies, collision shapes, applying forces, creating grabbable objects, or troubleshooting physics. | 3 / 3 |
Trigger Term Quality | Includes strong natural trigger terms users would say: 'physics simulation', 'rigid bodies', 'collision shapes', 'forces', 'grabbable physics objects', 'troubleshooting physics behavior', and 'IWSDK'. These cover a good range of terms a developer working with physics in this SDK would naturally use. | 3 / 3 |
Distinctiveness Conflict Risk | The combination of 'IWSDK' and 'physics' creates a very specific niche. Terms like 'rigid bodies', 'collision shapes', 'grabbable physics objects' are highly distinctive and unlikely to conflict with other skills. | 3 / 3 |
Total | 11 / 12 Passed |
Implementation
64%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is a thorough and highly actionable physics system guide with excellent executable code examples covering all major use cases. Its main weaknesses are its monolithic length (could benefit from splitting into overview + reference files) and the lack of explicit validation/verification steps in workflows. The content is well-structured but could be more concise by trimming redundant explanations and leveraging progressive disclosure.
Suggestions
Split the document into a concise SKILL.md overview (enabling physics, quick start, common patterns) with references to separate files like PHYSICS_REFERENCE.md (component tables, enums, GLXF config) and PHYSICS_EXAMPLES.md (complete playground, explosion pattern, buoyancy system).
Add validation checkpoints to workflows, e.g., 'After adding PhysicsBody and PhysicsShape, verify the object simulates by checking that _linearVelocity changes after a few frames' or 'Log entity.hasComponent(PhysicsBody) to confirm registration.'
Trim inline code comments that explain obvious things to Claude (e.g., '// Bouncy', '// Required if physics objects should be grabbable') and remove redundant property descriptions already captured in tables.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill is comprehensive and mostly efficient, but it's quite long (~400+ lines) with some redundancy. The material tuning table, auto-detection mapping table, and GLXF configuration section add useful reference value, but the extensive property tables repeat information that could be more compact. Some explanatory comments in code (e.g., '// Bouncy', '// Impulse force vector') are unnecessary for Claude. | 2 / 3 |
Actionability | Excellent actionability throughout. Every section provides fully executable TypeScript code with correct imports, concrete property values, and copy-paste ready examples. The complete playground example at the end ties everything together, and patterns like the explosion radial force and buoyancy system are immediately usable. | 3 / 3 |
Workflow Clarity | The 'Common Workflows' section provides clear step-by-step sequences for creating physics objects, and the system priority order is well-documented. However, there are no explicit validation checkpoints — no steps to verify physics is working correctly, no feedback loops for debugging (e.g., 'verify the object falls by checking _linearVelocity'), and the troubleshooting section is separate rather than integrated into workflows. | 2 / 3 |
Progressive Disclosure | The content is well-organized with clear section headers and logical progression from basics to advanced patterns. However, this is a monolithic document with no references to external files. Given its length (~400+ lines), the GLXF configuration, material tuning guide, complete example, and detailed component references could be split into separate files with clear navigation links from a leaner overview. | 2 / 3 |
Total | 9 / 12 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.
Validation — 10 / 11 Passed
Validation for skill structure
| Criteria | Description | Result |
|---|---|---|
skill_md_line_count | SKILL.md is long (602 lines); consider splitting into references/ and linking | Warning |
Total | 10 / 11 Passed | |
b3d1162
Table of Contents
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.