motif-logo-generator

Generate publication-quality sequence logos for DNA or protein motifs.

Quality

48%

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/Data Analysis/motif-logo-generator/SKILL.md

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 covers many sections and gives concrete-looking examples, but it is weighed down by generic boilerplate and a documented interface that diverges from the actual bundled script. Tightening the padding and reconciling the CLI/API docs with main.py would most improve it.

Suggestions

Reconcile the documented CLI and Python API with scripts/main.py: either implement --type/--colorscheme/--width/--height and generate_logo, or correct the docs to the actual --sequences/--format/--output/--demo interface.

Remove templated boilerplate (repeated description, "See ## X above" cross-references, generic Risk/Security/Evaluation/Lifecycle sections) and keep only motif-logo-specific guidance.

Add a task-specific validation checkpoint to the workflow (e.g. confirm the FASTA parsed into equal-length sequences before generating the logo) instead of only a generic py_compile check.

Dimension	Reasoning	Score
Conciseness	The body is noticeably padded with templated boilerplate (repeated description in "When to Use", generic Risk Assessment / Security Checklist / Evaluation Criteria sections, and "See ## X above for related details" cross-references) that adds little motif-specific value, matching the several-unnecessary-sections anchor.	2 / 5
Actionability	It gives concrete commands and CLI/Python-API examples, but the documented interface (--type, --colorscheme, --width/--height, generate_logo API) does not match the bundled scripts/main.py (which only supports --sequences, --format, --output, --demo), leaving key gaps that cap it at 3.	3 / 5
Workflow Clarity	A sequenced Workflow and run plan exist plus a py_compile Quick Check, but the steps are generic template language with no task-specific validation checkpoints (e.g. verifying the FASTA parsed or the logo rendered), matching the steps-present-but-checkpoints-implicit anchor.	3 / 5
Progressive Disclosure	Section headers provide some structure and scripts/main.py is a real referenced bundle file, but the content is a long monolithic wall of text with confusing forward/backward "See ## X above" references rather than cleanly split, well-signaled one-level-deep references.	3 / 5
	Total	11 / 20 Passed

Description

53%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 states a clear, specific purpose but omits any explicit "when to use" trigger guidance, which caps completeness. It is distinctive within a clear niche yet could add synonyms and a usage trigger to improve discoverability.

Suggestions

Add a "Use when ..." clause naming concrete triggers (e.g. visualizing conserved positions, position weight matrices, consensus sequences from a FASTA alignment).

Include natural synonyms and file extensions users might say, such as "motif visualization", "position weight matrix", or ".fasta" inputs.

Expand the action list beyond "generate" to cover styling/output formats (e.g. export PNG/PDF/SVG logos) for fuller capability coverage.

Dimension	Reasoning	Score
Specificity	Names the domain (DNA or protein motifs) and one concrete action ("Generate ... sequence logos"), but offers only a single action rather than comprehensive coverage, matching the 1-2 concrete actions anchor.	3 / 5
Completeness	It clearly states what the skill does but provides no "Use when ..." clause or equivalent trigger guidance, so completeness is capped at 3 per the rubric guideline.	3 / 5
Trigger Term Quality	Contains relevant natural terms ("sequence logos", "DNA", "protein", "motifs") but lacks common synonyms or file extensions (e.g. consensus sequence, position weight matrix, .fasta), fitting the some-keywords-missing anchor.	3 / 5
Distinctiveness Conflict Risk	The motif-logo niche is clearly distinct with low conflict risk, though the absence of an explicit trigger phrase leaves minor overlap risk with general sequence-analysis skills, placing it above 3 but below 5.	4 / 5
	Total	13 / 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/Data Analysis/motif-logo-generator/SKILL.md
Commit: f5ef65b

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