Specialist in designing and developing immersive cockpit-based control systems for XR environments
34
18%
Does it follow best practices?
Impact
Pending
No eval scenarios have been run
Passed
No known issues
Optimize this skill with Tessl
npx tessl skill review --optimize ./spatial-xr-cockpit/skills/SKILL.mdQuality
Discovery
22%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 description reads like a professional title or tagline rather than a functional skill description. It lacks concrete actions, explicit trigger conditions, and uses the framing 'Specialist in...' which doesn't clearly communicate what the skill does or when it should be selected. The XR cockpit domain is niche enough to partially avoid conflicts, but the description needs significant improvement in specificity and completeness.
Suggestions
Replace the 'Specialist in...' framing with concrete action verbs listing what the skill does, e.g., 'Designs cockpit layouts, implements 3D control panels, creates HUD elements for XR environments.'
Add an explicit 'Use when...' clause with natural trigger terms, e.g., 'Use when the user asks about VR/AR cockpit interfaces, XR dashboards, spatial control panels, or immersive vehicle/flight controls.'
Expand trigger term coverage to include common variations like 'VR', 'AR', 'mixed reality', 'virtual reality', 'HUD', 'spatial UI', and 'head-up display'.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | The description uses vague language like 'designing and developing' and 'immersive cockpit-based control systems' without listing any concrete actions. It reads more like a job title than a capability description. | 1 / 3 |
Completeness | The description weakly addresses 'what' (designing cockpit control systems for XR) but completely lacks any 'when' clause or explicit trigger guidance for when Claude should select this skill. | 1 / 3 |
Trigger Term Quality | It includes some relevant domain keywords like 'cockpit', 'XR', and 'control systems', but misses common variations users might say such as 'VR', 'AR', 'mixed reality', 'virtual reality', 'HUD', 'dashboard', or 'spatial UI'. | 2 / 3 |
Distinctiveness Conflict Risk | The niche of cockpit-based XR control systems is fairly specific and unlikely to conflict with many other skills, but the vague phrasing ('designing and developing') could overlap with general XR development or UI design skills. | 2 / 3 |
Total | 6 / 12 Passed |
Implementation
14%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This skill reads as a persona/role description rather than an actionable skill. It tells Claude what it 'is' and what it 'can do' but provides zero concrete guidance on how to actually implement cockpit interfaces—no code examples, no design patterns, no workflows, no tool-specific instructions. The content would need a fundamental restructuring to function as a useful skill.
Suggestions
Add concrete, executable code examples for at least one cockpit element (e.g., an A-Frame yoke control with hand tracking), replacing the abstract capability descriptions.
Define a clear workflow for cockpit design: e.g., 1) Define seated reference frame, 2) Place control surfaces within ergonomic reach zones, 3) Add input handlers, 4) Validate comfort metrics—with specific code or commands at each step.
Remove the personality/identity framing (memory, experience, role description) and replace with actionable constraints, specific parameter values (e.g., comfortable reach distances, motion sickness thresholds in degrees/second), and concrete design patterns.
Add references to detailed files for specific topics like 'See CONTROLS.md for lever/throttle implementation patterns' or 'See ERGONOMICS.md for seated comfort zone specifications'.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The content includes some unnecessary personality framing (memory, experience, identity) that Claude doesn't need spelled out. The emoji headers and verbose role descriptions add tokens without adding actionable value. However, it's not excessively padded with basic concept explanations. | 2 / 3 |
Actionability | The skill is entirely abstract and descriptive—no concrete code, commands, examples, or executable guidance. Statements like 'Prototype cockpit layouts in A-Frame or Three.js' and 'Design hand-interactive yokes' describe capabilities without showing how to do anything. No code snippets, no specific patterns, no copy-paste ready content. | 1 / 3 |
Workflow Clarity | There is no workflow, sequence, or process described. The content lists capabilities and design goals but never outlines steps for accomplishing any task. No validation checkpoints or feedback loops are present for what could be complex multi-step 3D development processes. | 1 / 3 |
Progressive Disclosure | The content is a single monolithic block with no references to external files, no structured navigation, and no separation of overview from detailed content. There are no links to examples, API references, or deeper guides for any of the mentioned technologies. | 1 / 3 |
Total | 5 / 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 |
|---|---|---|
frontmatter_unknown_keys | Unknown frontmatter key(s) found; consider removing or moving to metadata | Warning |
Total | 10 / 11 Passed | |
09aef5d
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.