3d-molecule-ray-tracer

Generate photorealistic rendering scripts for PyMOL and UCSF ChimeraX.

Quality

33%

Does it follow best practices?

Impact

Pending

No eval scenarios have been run

Securityby

Passed

No known issues

Optimize this skill with Tessl

npx tessl skill review --optimize ./scientific-skills/Data Analysis/3d-molecule-ray-tracer/SKILL.md

Quality

Discovery

40%

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 identifies a clear, specialized niche (molecular visualization scripting) with distinctive tool names, but lacks completeness by omitting explicit trigger guidance. It would benefit from additional trigger terms covering common user language and a 'Use when...' clause to help Claude know when to select this skill.

Suggestions

Add a 'Use when...' clause with trigger terms like 'molecular visualization', 'protein rendering', 'structure visualization', or 'PyMOL/ChimeraX scripts'

Expand the capability list to include specific actions like 'create publication-quality images', 'set up lighting and materials', 'generate animation scripts'

Include common user terms like 'protein structure', 'molecular graphics', '3D molecule', or file formats like '.pdb', '.cif'

Dimension	Reasoning	Score
Specificity	Names the domain (molecular visualization) and a specific action (generate rendering scripts), but doesn't list multiple concrete actions or elaborate on what types of scripts or rendering capabilities are covered.	2 / 3
Completeness	Describes what it does (generate rendering scripts) but completely lacks a 'Use when...' clause or any explicit trigger guidance for when Claude should select this skill.	1 / 3
Trigger Term Quality	Includes specific tool names (PyMOL, ChimeraX) and 'photorealistic rendering' which users might say, but misses common variations like 'molecular visualization', 'protein structure', '3D rendering', 'molecular graphics', or file extensions.	2 / 3
Distinctiveness Conflict Risk	Very clear niche with distinct triggers - PyMOL and ChimeraX are specific molecular visualization tools, and 'photorealistic rendering scripts' is a narrow domain unlikely to conflict with other skills.	3 / 3
	Total	8 / 12 Passed

Implementation

27%

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

This skill is excessively verbose with significant structural problems including circular self-references and boilerplate sections that waste tokens. While it provides some actionable CLI examples and parameter documentation, the core value proposition (generating rendering scripts) lacks concrete examples of actual output scripts. The document would benefit from aggressive trimming and better organization.

Suggestions

Remove circular references ('See ## Features above') and consolidate duplicate content - the document references itself multiple times without adding value

Move security checklists, risk assessments, lifecycle status, and evaluation criteria to separate reference files - these don't help Claude execute the skill

Add a concrete example of what a generated PyMOL/ChimeraX script looks like, not just the CLI to generate it

Add explicit validation step: 'Run generated script in PyMOL/ChimeraX and verify it loads without errors before delivering to user'

Dimension	Reasoning	Score
Conciseness	Extremely verbose with significant redundancy - multiple sections reference each other circularly ('See ## Features above', 'See ## Usage above'), boilerplate sections like 'When to Use' contain generic filler, and extensive tables/checklists that Claude doesn't need (security checklist, risk assessment, lifecycle status).	1 / 3
Actionability	Provides concrete CLI examples and parameter tables which are useful, but the actual script implementation details are missing - it just references 'scripts/main.py' without showing what the generated PyMOL/ChimeraX scripts look like or how to customize them beyond CLI flags.	2 / 3
Workflow Clarity	Has a numbered workflow section and example run plan, but validation steps are weak - 'Review the generated output' is vague, and there's no explicit checkpoint for verifying the generated scripts work in PyMOL/ChimeraX before considering the task complete.	2 / 3
Progressive Disclosure	Monolithic wall of text with poor organization - circular references ('See ## Features above'), content that should be in separate files is inline (full parameter tables, presets, security checklists), and references to 'references/' folder without clear navigation structure.	1 / 3
	Total	6 / 12 Passed

Validation

90%

Warnings & errors only

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

Repository: aipoch/medical-research-skills
Commit: 4a48721

Reviewed: about 12 hours ago

Table of Contents

Discovery Implementation Validation

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.