CtrlK
BlogDocsLog inGet started
Tessl Logo

ray-skill

Use when user says "send to Ray," "show in Ray," "debug in Ray," "log to Ray," "display in Ray," or wants to visualize data, debug output, or show diagrams in the Ray desktop application.

73

Quality

68%

Does it follow best practices?

Impact

Pending

No eval scenarios have been run

SecuritybySnyk

Passed

No known issues

Optimize this skill with Tessl

npx tessl skill review --optimize ./config/claude/skills/ray-skill/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Discovery

72%

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 excels at trigger terms and distinctiveness by heavily featuring the 'Ray' product name and natural user phrases. However, it's essentially all 'when' and very little 'what' - it doesn't explain what capabilities the skill provides or what actions it can perform beyond vague mentions of visualization and debugging.

Suggestions

Add a clear 'what' statement at the beginning describing concrete actions (e.g., 'Sends data, logs, images, and diagrams to the Ray desktop application for visualization and debugging.')

Specify the types of content that can be sent to Ray (e.g., 'dataframes, plots, debug logs, error traces, diagrams')

DimensionReasoningScore

Specificity

Names the domain (Ray desktop application) and mentions some actions like 'visualize data, debug output, show diagrams', but doesn't list comprehensive concrete actions or explain what specific capabilities the skill provides.

2 / 3

Completeness

Strong on 'when' with explicit 'Use when' clause and multiple trigger scenarios, but weak on 'what' - doesn't clearly explain what the skill actually does beyond vague references to visualization and debugging.

2 / 3

Trigger Term Quality

Excellent coverage of natural trigger phrases users would say: 'send to Ray,' 'show in Ray,' 'debug in Ray,' 'log to Ray,' 'display in Ray,' plus general terms like 'visualize data' and 'debug output.'

3 / 3

Distinctiveness Conflict Risk

Very distinct with specific product name 'Ray' as the primary trigger, making it unlikely to conflict with other skills. The explicit phrases like 'send to Ray' create a clear niche.

3 / 3

Total

10

/

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 solid reference skill with excellent actionability - every payload type has executable JSON examples and the curl command is copy-paste ready. However, it's verbose with redundant information (origin repeated in every example, duplicate reference table), and lacks workflow guidance for error handling when Ray isn't available. The structure could be improved by leading with a quick start example and moving detailed payload references to a separate file.

Suggestions

Add a Quick Start section at the top with a minimal working example before diving into all payload types

Show the origin object once with a note that it's required in all payloads, rather than repeating it in every example

Add error handling guidance: what happens when Ray isn't running, and how to handle the availability check response

Consider moving the detailed payload type examples to a separate PAYLOADS.md file, keeping only the reference table and a few common examples in the main skill

DimensionReasoningScore

Conciseness

The content is mostly efficient with good use of tables and code examples, but there's some redundancy - the payload type reference table at the end duplicates information already shown in detail above, and the origin object is repeated in every single example when it could be shown once with a note.

2 / 3

Actionability

Excellent actionability with fully executable JSON examples for every payload type, a complete curl command example, and specific connection details. Claude can immediately use this to send data to Ray without any guesswork.

3 / 3

Workflow Clarity

The skill explains individual payload types well but lacks a clear workflow for common debugging scenarios. The availability check is mentioned but not integrated into a recommended workflow (e.g., 'check availability first, then send'). No error handling guidance for when Ray isn't running.

2 / 3

Progressive Disclosure

Content is reasonably organized with clear sections, but it's a long monolithic document (~300 lines) that could benefit from splitting detailed payload references into a separate file. The quick reference table at the end is helpful but the document front-loads too much detail before showing a complete example.

2 / 3

Total

9

/

12

Passed

Validation

81%

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

Validation9 / 11 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_version

'metadata.version' is missing

Warning

metadata_field

'metadata' should map string keys to string values

Warning

Total

9

/

11

Passed

Repository
freekmurze/dotfiles
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.