moa-explainer
Generate 3D animation scripts and lay explanations for drug mechanisms.
43
30%
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 ./scientific-skills/Academic Writing/moa-explainer/SKILL.mdQuality
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 unique niche combining 3D animation with pharmaceutical education, which provides good distinctiveness. However, it lacks explicit trigger guidance ('Use when...') and could benefit from more specific capability details and natural keyword variations that users might employ when requesting this type of content.
Suggestions
Add a 'Use when...' clause with trigger terms like 'drug animation', 'mechanism of action', 'pharmaceutical visualization', 'medical animation script'
Expand capability specifics: what types of animations (molecular, cellular, systemic), what script formats (storyboard, narration, technical directions), what audience levels for explanations
Include common keyword variations: 'MOA', 'pharma', 'medication', 'how drugs work', 'therapeutic mechanism'
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Names the domain (3D animation, drug mechanisms) and two actions (generate scripts, lay explanations), but lacks comprehensive detail about what types of scripts, what format, or what aspects of drug mechanisms are covered. | 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, missing explicit trigger guidance caps completeness at 2, and this has no 'when' component at all. | 1 / 3 |
Trigger Term Quality | Includes some relevant terms like '3D animation', 'drug mechanisms', and 'scripts', but misses common variations users might say such as 'pharmaceutical', 'MOA', 'mechanism of action', 'medical animation', or 'drug visualization'. | 2 / 3 |
Distinctiveness Conflict Risk | The combination of '3D animation scripts' specifically for 'drug mechanisms' is a clear, narrow niche that is unlikely to conflict with general animation, medical, or scripting skills. | 3 / 3 |
Total | 8 / 12 Passed |
Implementation
20%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This skill is a generic template with MoA-specific labels pasted in, rather than a genuine guide for creating drug mechanism visualizations. It lacks any concrete examples of animation storyboards, voiceover scripts, or lay explanations. The excessive boilerplate (security checklists, lifecycle status, evaluation criteria) consumes tokens without teaching Claude how to actually explain drug mechanisms or create visualization scripts.
Suggestions
Add a complete worked example showing: input (drug name, target, disease, audience) → output (actual animation storyboard with scene descriptions, voiceover script text, and simplified explanation)
Remove generic template sections (Risk Assessment, Security Checklist, Lifecycle Status, Evaluation Criteria) that don't add MoA-specific value
Include concrete guidance on how to structure animation scenes for different molecular mechanisms (receptor binding, enzyme inhibition, etc.)
Add validation checkpoints for scientific accuracy and audience-appropriate language in the workflow
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Extremely verbose with excessive boilerplate sections (Risk Assessment, Security Checklist, Lifecycle Status, Evaluation Criteria) that add no value for this specific skill. Contains redundant cross-references ('See ## Prerequisites above') and generic template content that doesn't teach Claude anything about MoA visualization. | 1 / 3 |
Actionability | Despite being about generating 3D animation scripts, there are no concrete examples of animation storyboards, voiceover scripts, or visual concepts. The 'Example' section just says 'PD-1 inhibitor mechanism for patient education' with no actual output. The scripts/main.py is referenced but no actual animation generation code or templates are shown. | 1 / 3 |
Workflow Clarity | The Workflow section provides a generic 5-step process but lacks domain-specific guidance for MoA visualization. No validation checkpoints for scientific accuracy of drug mechanisms, no review steps for animation storyboard quality, and no feedback loops for ensuring lay explanations are actually understandable. | 2 / 3 |
Progressive Disclosure | References to 'references/' directory and 'references/audit-reference.md' exist, but the main file is bloated with template sections that should be elsewhere or removed. The core MoA-specific content (Parameters, Returns, Use Cases) is buried among generic boilerplate. | 2 / 3 |
Total | 6 / 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 | |
- Repository
- aipoch/medical-research-skills
- Commit
4a48721
- 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.