CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

protein-diagram

Publication-quality protein analysis diagrams. Domain architecture maps, secondary structure annotation, Ramachandran plots, contact maps, multiple sequence alignment visualization, and protein feature tracks.

67

Quality

84%

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

SKILL.md
Quality
Evals
Security

Quality

Content

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

A strong, lean, fully executable skill body: all six tools are documented with verified, copy-paste-ready commands and useful reference tables, and workflows are unambiguous single-command renders. The only notable gap is structural — detail is kept entirely inline with no explicit pointer to per-script reference material.

DimensionReasoningScore

Conciseness

The body is efficient: no concept explanations, real commands, and compact tables for inputs and style guidance. Minor trims are possible — the opening paragraph restates the frontmatter description, the Script Reference table repeats the six Core Workflow headings, and some sections carry a third command variant that adds little. This sits between anchors 4 and 5, closer to 4.

4 / 5

Actionability

Every one of the six workflows has copy-paste-ready, fully executable bash commands with concrete flags, and spot-checking the scripts confirms the documented flags (--domains, --uniprot, --chain, --highlight-glycine, --show-regions, --figsize, --dpi) match the actual argparse definitions. Input-format and style guidance makes the common cases complete.

5 / 5

Workflow Clarity

Each workflow is a single unambiguous command with its required inputs shown, and the operations are read-only renders (no destructive or batch steps that would demand validation checkpoints), so the simple-skill exception applies. The sections are consistently sequenced (purpose, command variants, options) with no gaps.

5 / 5

Progressive Disclosure

Structure is clear and well-organized with per-script sections, a Script Reference table, Input Formats table, and Style Guide; all six referenced script paths exist in the bundle. It falls short of anchor 5 because everything lives inline in SKILL.md with no signaling toward the per-script detail available in the scripts themselves (e.g. a `--help` pointer) or a split-out reference for style/format details — the body is well above the 50-line simple-skill threshold.

4 / 5

Total

18

/

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 specific, well-scoped description that concretely enumerates all six capabilities with strong distinctiveness. Its main weakness is the complete absence of "when to use" guidance, which caps completeness, and it omits natural trigger synonyms and file formats (PDB, FASTA, MSA).

Suggestions

Append a trigger clause such as: "Use when working with protein structures (PDB/mmCIF files), protein sequences (FASTA), or when the user asks for Ramachandran plots, contact maps, domain maps, or MSA visualization."

Include the file extensions and synonyms users naturally mention — PDB, .pdb, FASTA, MSA, DSSP — so the description matches real user phrasing.

State what the skill does with its inputs (renders/generates diagrams) in verb form, e.g. "Generates publication-quality protein analysis diagrams...", to sharpen the what-clause.

DimensionReasoningScore

Specificity

The description enumerates six concrete deliverables — "Domain architecture maps, secondary structure annotation, Ramachandran plots, contact maps, multiple sequence alignment visualization, and protein feature tracks" — matching all six workflows in the body with comprehensive coverage. The lead phrase "Publication-quality protein analysis diagrams" adds a mild claim rather than fluff, so this fits the top anchor better than 4.

5 / 5

Completeness

The "what" is clear and concrete, but there is no "Use when..." clause or equivalent explicit trigger guidance anywhere in the description — per the judging guidelines this caps completeness at 3. It is above 2 because the "what" is specific and multi-part, not vague.

3 / 5

Trigger Term Quality

Natural terms a bioinformatics user would say are present ("protein", "Ramachandran plots", "contact maps", "multiple sequence alignment", "domain architecture"), but common synonyms and file extensions users actually mention are missing: "PDB", ".pdb", "FASTA", "MSA", "DSSP". This is good-but-not-comprehensive keyword coverage, matching anchor 4 rather than 5.

4 / 5

Distinctiveness Conflict Risk

The niche is unambiguous — protein-specific diagrams with distinctive technical triggers ("Ramachandran", "contact maps", "domain architecture") that no generic visualization skill would claim. Overlap risk with molecule- or DNA-visualization skills is minimal since "protein" scopes every capability listed; the body further disambiguates boundaries.

5 / 5

Total

17

/

20

Passed

Validation

87%

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

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_version

'metadata.version' is missing

Warning

frontmatter_unknown_keys

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

Warning

Total

14

/

16

Passed

Repository

synthetic-sciences/openscience

Path

backend/cli/skills/visualization/protein-diagram/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.