CtrlK
BlogDocsLog inGet started
Tessl Logo

adverse-event-narrative

Generates CIOMS I-compliant ICSR narratives from adverse event case data for FDA and EMA regulatory submission. Includes temporal analysis, MedDRA coding, causality assessment using WHO-UMC or Naranjo criteria, and multi-format output.

57

Quality

72%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./scientific-skills/Academic Writing/adverse-event-narrative/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

58%Weight 40%Scale 1-5

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

The body has an excellent workflow with genuine validation checkpoints and a fallback, and the domain content (CIOMS sections, WHO-UMC categories, pitfalls) is strong. However, the file listings are fabricated — every referenced reference file and 7 of 8 listed scripts do not exist in the bundle while the real ones go unmentioned — and the main code examples import a nonexistent module, undermining both progressive disclosure and actionability. Some duplicated command blocks also cost conciseness.

Suggestions

Replace the References and Scripts listings with the actual bundle files (references/CIOMS_I_Guidelines.md, ICSR_Template.md, MedDRA_Reference.md, Quick_Reference.md, sample_case_001.json, sample_case_minimal.json, scripts/main.py) so every listed path exists and the real detail files are discoverable.

Fix the code examples to match the real code: import `CIOMSNarrativeGenerator` from scripts.main, or prefer executable CLI invocations like `python scripts/main.py --input references/sample_case_001.json --validate-only` over the nonexistent NarrativeGenerator API.

Deduplicate the command blocks: drop the repeated `python scripts/main.py --help` line and the Quick Check section that restates the py_compile command, and fold the Overview "Key Capabilities" bullets into the Core Capabilities sections they restate.

DimensionReasoningScore

Conciseness

Mostly efficient — the workflow, pitfalls, and checklist sections earn their tokens — but there is measurable padding: the "Quick Check" section duplicates the same `python -m py_compile scripts/main.py` command repeated in "Audit-Ready Commands", `python scripts/main.py --help` appears twice in that same block, and the "Overview → Key Capabilities" bullet list restates the four "Core Capabilities" section headers verbatim. Not 4 because these duplications are unnecessary rather than minor; not 2 because the bulk of the body is dense, domain-specific operational content, not explanation of concepts Claude already knows.

3 / 5

Actionability

There is concrete, runnable CLI guidance (`python -m py_compile scripts/main.py`, `--validate-only`) that matches the real script, but the centerpiece code examples are not executable: `from scripts.narrative_generator import NarrativeGenerator` imports a module that does not exist in the bundle, and the real class in scripts/main.py is `CIOMSNarrativeGenerator` — so the `generator.generate(...)`, `analyze_timeline(...)`, and `assess_causality(...)` snippets cannot run as written. Not 4 because the primary API examples are non-functional against the actual bundle; not 2 because the CLI commands and the structural guidance (10 CIOMS sections, WHO-UMC categories) are concrete and usable.

3 / 5

Workflow Clarity

The 8-step workflow has an explicit validation step ("Validate completeness: Check that required CIOMS I fields are present... Flag missing fields"), two explicit checkpoints (steps 3 and 6), an error-recovery fallback (step 8 structured checklist + partial narrative), a dedicated pre/post Quality Checklist, and an Error Handling section covering script failure. This matches the anchor "Clear sequence with explicit validation steps; feedback loops for error recovery; checklists for complex processes". Not 4 because checkpoints, validation, and the checklist are all present, leaving only minor gaps.

5 / 5

Progressive Disclosure

Scored against the actual bundle: the References section lists 7 files (e.g., `cioms_i_guidelines.pdf`, `who_umc_causality.md`) of which zero exist, the Scripts section lists 8 files of which only `main.py` exists, and the 6 real bundle files (CIOMS_I_Guidelines.md, ICSR_Template.md, MedDRA_Reference.md, Quick_Reference.md, sample_case_001.json, sample_case_minimal.json) are never referenced anywhere in the body. Navigation is clearly signaled but points entirely at fabricated paths while the real detail files go unused. Not 3 because references that resolve to nothing are a deeper navigation failure than merely unclear signaling; not 1 because the document itself is well sectioned with references one level deep rather than a monolithic wall or nested chain.

2 / 5

Total

13

/

20

Passed

Description

75%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A strong, specific description that clearly communicates what the skill does with excellent domain distinctiveness. Its main gap is the missing explicit "Use when..." trigger clause, which caps completeness, and a few natural synonyms (e.g., "safety report") that would broaden trigger matching.

Suggestions

Add an explicit trigger clause, e.g. "Use when the user asks for an AE narrative, ICSR, CIOMS narrative, safety report, or MedWatch narrative for regulatory submission" — this lifts completeness from 3 to 5.

Include one or two natural user phrasings such as "safety report" or "side effect narrative" in the description to improve trigger-term coverage beyond the current jargon set.

DimensionReasoningScore

Specificity

Quotes multiple specific concrete actions: "Generates CIOMS I-compliant ICSR narratives", "temporal analysis, MedDRA coding, causality assessment using WHO-UMC or Naranjo criteria, and multi-format output" — comprehensive coverage of the skill's actions with no vague filler. Not 4 because coverage is comprehensive rather than having minor gaps; not below because there is no generic language at all.

5 / 5

Completeness

The "what" is clear and concrete, but there is no "Use when..." clause or equivalent explicit trigger guidance in the description, which caps completeness at 3 per the judging guidelines. Not 4/5 because the "when" is entirely absent rather than merely implicit; not 2 because the "what" half is specific and multi-faceted, not vague.

3 / 5

Trigger Term Quality

Good natural keyword coverage: "ICSR", "CIOMS", "adverse event", "MedDRA", "causality", "FDA", "EMA" — terms a pharmacovigilance user would naturally say. Not 5 because common variations like "safety report", "side effect report", or "pharmacovigilance" are absent (they appear only in the body, not the description); not 3 because the included terms go well beyond a single generic keyword with synonyms present (CIOMS I / ICSR / MedWatch-adjacent terms).

4 / 5

Distinctiveness Conflict Risk

Clear niche with distinct triggers: "CIOMS I-compliant ICSR narratives", "WHO-UMC or Naranjo criteria", "MedDRA coding" — regulatory ICSR terminology that virtually no other skill would claim. Not 4 because there is no realistic overlap with adjacent skills; the trigger vocabulary is uniquely pharmacovigilance-specific.

5 / 5

Total

17

/

20

Passed

Validation

93%

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

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

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

Warning

Total

15

/

16

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.