CtrlK
BlogDocsLog inGet started
Tessl Logo

moa-explainer

Generate 3D animation scripts and lay explanations for drug mechanisms.

28

Quality

20%

Does it follow best practices?

Impact

No eval scenarios have been run

SecuritybySnyk

Passed

No known issues

Optimize this skill with Tessl

npx tessl skill review --optimize ./scientific-skills/Academic Writing/moa-explainer/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

0%

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

This skill is almost entirely generic boilerplate with no domain-specific content about drug mechanism of action visualization, 3D animation scripting, or lay explanation generation. It reads like a template that was never filled in with actual skill content. The referenced scripts and reference files don't exist in the bundle, and the few domain-specific elements (Parameters, Returns, Use Cases) are superficial lists without any actionable guidance.

Suggestions

Replace the generic workflow with a concrete, domain-specific process: e.g., Step 1: Identify the drug's molecular target and binding mechanism; Step 2: Generate a scene-by-scene animation storyboard with specific visual descriptions; Step 3: Write voiceover script at appropriate audience level; Step 4: Validate medical accuracy against known pharmacology.

Add at least one complete input/output example showing a drug name input and the resulting animation storyboard, voiceover script, and simplified explanation—this is critical for actionability.

Remove all boilerplate sections that don't contribute to the task (Risk Assessment, Security Checklist, Lifecycle Status, Evaluation Criteria, Response Template) to dramatically improve conciseness.

Either provide the referenced bundle files (scripts/main.py, references/audit-reference.md) with real implementation, or remove the references and make the skill self-contained with inline guidance for generating MoA content.

DimensionReasoningScore

Conciseness

Extremely verbose and padded with boilerplate sections (Risk Assessment, Security Checklist, Lifecycle Status, Evaluation Criteria, Response Template) that add no actionable value. Many sections are generic templates not tailored to the specific task of generating 3D animation scripts. Self-referential links like 'See ## Prerequisites above' and 'See ## Workflow above' add confusion. The skill explains obvious concepts Claude already knows.

1 / 3

Actionability

Despite the length, there is no concrete guidance on how to actually generate 3D animation scripts or lay explanations for drug mechanisms. The 'Example' section is just 'PD-1 inhibitor mechanism for patient education' with no actual input/output demonstration. The workflow steps are entirely generic ('Confirm the user objective', 'Validate that the request matches') with no domain-specific instructions. The scripts/main.py is referenced but no actual code or animation scripting logic is shown.

1 / 3

Workflow Clarity

The workflow section contains only generic meta-steps ('Confirm the user objective', 'Validate that the request matches the documented scope') with no specific sequence for creating animation storyboards, voiceover scripts, or visual concepts. There are no validation checkpoints specific to the domain (e.g., verifying medical accuracy, checking animation feasibility). The 'Example run plan' is also generic boilerplate.

1 / 3

Progressive Disclosure

References to 'references/audit-reference.md' and 'scripts/main.py' exist but no bundle files are provided, making these dead references. The document is a monolithic wall of boilerplate sections with poor organization—security checklists, lifecycle status, and evaluation criteria are inline when they're irrelevant to the core skill. Content that matters (how to actually create MoA visualizations) is absent entirely.

1 / 3

Total

4

/

12

Passed

Description

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 and distinctive niche—3D animation scripts for drug mechanisms—which helps it stand out from other skills. However, it lacks explicit trigger guidance ('Use when...') and misses important keyword variations that users might naturally use. The specificity of actions could also be improved with more concrete details about outputs and formats.

Suggestions

Add a 'Use when...' clause with trigger terms like 'mechanism of action', 'MOA', 'pharmacology animation', 'drug visualization', or 'medical animation script'.

Include more specific actions such as 'generate Blender/Maya animation scripts', 'create patient-friendly explanations of pharmacological pathways', or 'produce storyboards for drug mechanism videos'.

Add common keyword variations users might say, such as 'pharma', 'pharmacodynamics', 'how a drug works', or 'medical explainer'.

DimensionReasoningScore

Specificity

Names the domain (drug mechanisms, 3D animation) and two actions (generate scripts, lay explanations), but lacks detail on what kinds of scripts, what format, or what specific outputs are produced.

2 / 3

Completeness

Describes what the skill does but completely lacks a 'Use when...' clause or any explicit trigger guidance for when Claude should select this skill. Per rubric guidelines, a missing 'Use when' clause caps completeness at 2, and since the 'what' is also only moderately detailed, this scores a 1.

1 / 3

Trigger Term Quality

Includes some relevant keywords like '3D animation', 'drug mechanisms', and 'scripts', but misses common user variations such as 'pharmacology', 'MOA', 'mechanism of action', 'medical animation', or 'drug visualization'.

2 / 3

Distinctiveness Conflict Risk

The combination of 3D animation scripts and drug mechanism explanations is a very specific niche that is unlikely to conflict with other skills. This is a clearly distinct domain.

3 / 3

Total

8

/

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.

Validation10 / 11 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

10

/

11

Passed

Repository
aipoch/medical-research-skills
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.