CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

gene-structure-mapper

Use gene structure mapper for data analysis workflows that need structured execution, explicit assumptions, and clear output boundaries.

Quality

44%

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/Data Analysis/gene-structure-mapper/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

42%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 buries a small, usable core — a concrete CLI example, a complete parameters table, and a working script reference — under layers of generic template boilerplate and duplicated workflow sections. The critical functional gap is that no input data source for exon/intron structure is ever documented, so the documented workflow cannot actually produce the promised visualization. Structural cleanup plus documenting the data path would lift most dimensions.

Suggestions

Consolidate the three overlapping workflow sections (Example Usage, Implementation Details, Workflow) and the two Usage sections into one sequential workflow with an explicit output-verification step.

Remove the generic boilerplate sections (Risk Assessment, Security Checklist, Evaluation Criteria, Lifecycle Status, Output Requirements) that contain no gene-structure-specific content, and fix the broken "See ## ... above" cross-references.

Document the missing data path: state where exon/intron (and domain/mutation) annotations come from before running scripts/main.py, since the documented CLI accepts no input file.

DimensionReasoningScore

Conciseness

The ~190-line body is dominated by template boilerplate unrelated to gene structure mapping: "Scope-focused workflow aligned to: <description restated verbatim>", "Output discipline: keep results reproducible...", plus generic Risk Assessment, Security Checklist, Evaluation Criteria, and Lifecycle Status sections. This matches the anchor for noticeably verbose with several padded sections; score 3 would require the padding to be limited to isolated instances rather than pervasive.

2 / 5

Actionability

Concrete runnable commands exist ("python -m py_compile scripts/main.py", "python scripts/main.py --help", "python scripts/main.py --gene TP53 --format svg", plus a complete parameters table), but a key detail is missing: no section documents where exon/intron data comes from, and the documented CLI takes no input file, so the promised visualization has no data source. This fits the anchor for concrete guidance that is incomplete with missing key details, rather than anchor 4's "minor gaps".

3 / 5

Workflow Clarity

Steps are listed (the Workflow section's 5 steps and the Example run plan) but are duplicated across three overlapping sections (Example Usage, Implementation Details, Workflow) with generic phrasing like "confirm the user objective, required inputs", and the only checkpoint is a parse check (py_compile) with no output verification step. This matches the anchor for a present sequence with missing or implicit checkpoints rather than anchor 4's clear sequence with most checkpoints present.

3 / 5

Progressive Disclosure

Sections exist and the one bundle reference ("scripts/main.py") is a real, correctly used file, but organization is muddled: broken in-file cross-references ("See `## Prerequisites` above" at the top of the body points to a section that appears 100 lines below it) and duplicated Usage/Workflow sections. This fits the anchor for some structure that could be better organized rather than anchor 4's well-placed content with mostly clear references.

3 / 5

Total

11

/

20

Passed

Description

20%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 generic template text that fails to convey what the skill actually does (visualize gene exon-intron structure) or when to invoke it. It consists of circular self-reference plus process buzzwords that apply to nearly any data-analysis skill, creating high conflict risk. Every dimension needs improvement.

Suggestions

State the concrete capability in third person, e.g. "Visualizes gene exon-intron structure with optional domain and mutation annotations, outputting SVG, PNG, or PDF."

Add an explicit trigger clause with natural user terms, e.g. "Use when the user asks to draw or visualize a gene's structure, exons, introns, or exon-intron diagrams for genes like TP53 or BRCA1."

Remove the generic process buzzwords ("structured execution, explicit assumptions, clear output boundaries") that would equally describe any analysis skill and drive the conflict risk.

DimensionReasoningScore

Specificity

The description contains no concrete actions: "structured execution, explicit assumptions, and clear output boundaries" is pure abstract process-language, and "Use gene structure mapper" is circular self-reference rather than a domain description. It matches the anchor for entirely vague, pure abstract language; the anchor above requires at least naming a concrete domain or action, which is absent.

1 / 5

Completeness

The 'what' is vague and circular (use the mapper for data analysis workflows) and there is no 'Use when...' clause or equivalent trigger guidance — "for data analysis workflows that need structured execution" is a scope condition, not a trigger. This matches the anchor for a vague 'what' with no 'when'; score 3 would require a clear 'what', which the circular phrasing does not provide.

2 / 5

Trigger Term Quality

The only semi-natural keyword is the skill's own name ("gene structure mapper"); users needing this skill would say "exon", "intron", "gene diagram", or "visualize gene structure", none of which appear, and "data analysis workflows" is entirely generic. This fits the anchor for one or two generic keywords while missing the natural phrases users say, rather than the anchor below (no keywords at all) since the skill name is a plausible partial trigger.

2 / 5

Distinctiveness Conflict Risk

"data analysis workflows that need structured execution, explicit assumptions, and clear output boundaries" would match virtually any data-analysis skill, giving high overlap risk; only the embedded skill name provides any distinction. This fits the anchor for very broad scope with high overlap risk rather than the entirely generic anchor below, since "gene structure mapper" is a somewhat distinctive name.

2 / 5

Total

7

/

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/Data Analysis/gene-structure-mapper/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.