pathway-introduction-expert

Generates comprehensive academic introductions for biological pathways, including signaling processes, markers, and inhibitors. Use when the user asks to introduce a pathway, molecule, or gene.

Quality

68%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./scientific-skills/Evidence Insight/pathway-introduction-expert/SKILL.md

Quality

Content

50%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 core domain instruction (content requirements, strict output format, example) is solid and actionable, but it is buried under generic boilerplate that hurts conciseness and dilutes workflow clarity. Trimming the templated sections and reconciling the two conflicting validation notes would substantially improve the body.

Suggestions

Remove the generic boilerplate sections (Implementation Details, Output Contract, Failure Handling, Completion Checklist, Quick/Deterministic Output Rules) that restate the description without adding domain knowledge, keeping only the Workflow, Content Requirements, Output Format, and Example.

Reconcile the contradictory validation guidance: 'Validation Shortcut' instructs `python scripts/validate_skill.py --help` while 'Quick Validation' says 'No local script validation step is required' — pick one and make the validate_skill.py path match it.

Add a concrete validation checkpoint to the workflow (e.g., confirm the General Introduction meets the 500-word minimum and that the output is in Chinese) so the deliverable can be checked before returning it.

Dimension	Reasoning	Score
Conciseness	The body is padded with generic boilerplate sections ("Implementation Details", "Output Contract", "Failure Handling", "Completion Checklist") that restate the description and add no domain knowledge, plus two contradictory validation notes.	2 / 5
Actionability	Provides a concrete, strict output-format template and a worked example covering the common cases, with only minor gaps (relies on Claude's own biology knowledge).	4 / 5
Workflow Clarity	Steps are sequenced (Analyze -> Generate, with molecule/gene vs pathway branching) but validation checkpoints are missing and the "See ## Workflow above" cross-reference points to content below, creating a gap.	3 / 5
Progressive Disclosure	No nested references and a single clearly-referenced script, but the body is a monolithic wall mixing the real workflow with boilerplate that could be better organized.	3 / 5
	Total	12 / 20 Passed

Description

87%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.

The description is strong: it states concrete capabilities and pairs them with clear, natural trigger phrases for both what and when. Minor room for improvement is in adding common synonyms and slightly broader action coverage.

Dimension	Reasoning	Score
Specificity	Names the domain and several concrete deliverables ("signaling processes, markers, and inhibitors"), with only minor coverage gaps versus the comprehensive 5 anchor.	4 / 5
Completeness	Explicitly answers both what ("Generates comprehensive academic introductions...") and when ("Use when the user asks to introduce a pathway, molecule, or gene") with concrete trigger phrases.	5 / 5
Trigger Term Quality	Includes natural trigger words users say ("pathway, molecule, or gene" and "introduce"), but misses common synonyms like describe/explain/signaling pathway that would reach 5.	4 / 5
Distinctiveness Conflict Risk	A clear niche (biological pathway academic introductions) with distinct, specific triggers and minimal risk of firing for unrelated skills.	5 / 5
	Total	18 / 20 Passed

Validation

93%

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 — 15 / 16 Passed

Validation for skill structure

Criteria	Description	Result
frontmatter_unknown_keys	Unknown frontmatter key(s) found; consider removing or moving to metadata	Warning

	Total	15 / 16 Passed

Repository: aipoch/medical-research-skills
Path: scientific-skills/Evidence Insight/pathway-introduction-expert/SKILL.md
Commit: f5ef65b

Reviewed: ~11 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.