CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

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

74%

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/Evidence Insight/pathway-introduction-expert/SKILL.md
SKILL.md
Quality
Evals
Security

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 skill's core content — the pathway/molecule/gene branching workflow, the 500-word content requirements, the strict Chinese output format, and the structure example — is genuinely good and actionable. However, it is buried in a large amount of generic template boilerplate that consumes most of the token budget, and the surrounding meta-sections contradict each other on validation, undermining an otherwise clear workflow.

Suggestions

Cut the generic boilerplate sections ('When to Use', 'Dependencies', 'Implementation Details', 'When Not to Use', 'Required Inputs', 'Output Contract', 'Validation and Safety Rules', 'Failure Handling', 'Deterministic Output Rules', 'Completion Checklist') — roughly 100 lines that add no task-specific value — and lead with the '# Pathway Introduction Expert' workflow, content requirements, and output format.

Resolve the contradictory validation guidance: pick one path (either the script in `scripts/validate_skill.py`, which currently is a stub that only prints 'validation-helper: ok', or the 'no local script validation required' statement) and delete the other section; also fix the broken cross-reference "See `## Workflow` above" (the Workflow section is below, not above).

Replace the odd hardcoded example path `cd "20260316/scientific-skills/Evidence Insight/pathway-introduction-expert"` with a relative path from the skill directory, and state concrete trigger synonyms (e.g., 'signaling pathway', 'overview') in the description to round out trigger coverage.

DimensionReasoningScore

Conciseness

Roughly 130 of the ~180 body lines are generic template boilerplate ('When to Use', 'Implementation Details', 'Validation and Safety Rules', 'Completion Checklist', 'Deterministic Output Rules') that restates what Claude already does by default. This matches 'noticeably verbose; several unnecessary... padded sections'; it is not a 1 because no basic domain concepts are re-taught.

2 / 5

Actionability

The core instructions are concrete and executable: "No less than 500 words", "list 5 related pathways first, then choose the most relevant one", a strict output skeleton, and a structure example with the required Chinese translation. Below 5 because the example `cd` path is a hardcoded odd date-directory and the script guidance is inconsistent with the actual stub script.

4 / 5

Workflow Clarity

A clear two-step sequence with input-type branching exists, but validation checkpoints are contradictory rather than merely gappy: 'Validation Shortcut' instructs running `scripts/validate_skill.py --help` while 'Quick Validation' states "No local script validation step is required for this skill", and 'Implementation Details' says "See `## Workflow` above" when that section is actually below. Conflicting checkpoints fit anchor 3, not 4.

3 / 5

Progressive Disclosure

The bundle's only file (`scripts/validate_skill.py`) exists and is referenced by a real path, but the body duplicates validation guidance across two sections ('Validation Shortcut' and 'Quick Validation'), interleaves template filler with the core workflow, and buries the actual skill content ('# Pathway Introduction Expert') halfway down the file. Some structure, but organization could be significantly better.

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 a concrete capability, covers the content scope, and includes an explicit, natural 'Use when...' trigger clause with domain-specific keywords. Only minor gains are available from adding synonym triggers like 'signaling pathway' or 'overview'.

DimensionReasoningScore

Specificity

"Generates comprehensive academic introductions... including signaling processes, markers, and inhibitors" names the domain and several concrete content actions, matching 'lists several specific actions; minor gaps'. It stays below 5 because there is only one deliverable type (an introduction document), and above 3 because more than 1-2 concrete actions are specified.

4 / 5

Completeness

Explicitly answers both 'what' ("Generates comprehensive academic introductions for biological pathways, including signaling processes, markers, and inhibitors") and 'when' ("Use when the user asks to introduce a pathway, molecule, or gene") with concrete trigger phrases, matching the top anchor example structure exactly.

5 / 5

Trigger Term Quality

"Use when the user asks to introduce a pathway, molecule, or gene" provides natural trigger phrasing with good keyword coverage. Below 5 because common synonyms such as 'signaling pathway', 'overview', or 'write about' are missing.

4 / 5

Distinctiveness Conflict Risk

Clear niche (academic introductions for biological pathways) with distinct trigger terms (pathway, molecule, gene introduction); minimal conflict risk with other skills. Voice is third person ('Generates'), so no specificity penalty applies.

5 / 5

Total

18

/

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

Path

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

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.