CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

glycobiology

Glycosylation site prediction and glycobiology analysis. N-glycosylation motif finding, O-glycosylation hotspot prediction, glycan structure resources. Lightweight, pure Python. For protein function queries use uniprot-database; for structure analysis use alphafold-database.

57

Quality

72%

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 ./backend/cli/skills/biology/glycobiology/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

63%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 well-structured, domain-rich body with genuinely executable code and useful best-practice/troubleshooting content. Its two systemic weaknesses are duplication — the Quick Start vs. Core Capability 1 re-implementation, and the entire body duplicating an unmentioned bundled CLI script — and small correctness gaps (undeclared pandas dependency, a short-sequence return bug).

Suggestions

Reference the bundled script explicitly, e.g., a "## Quick start" section showing `python scripts/predict_glycosylation.py --sequence protein.fasta --output-dir ./results`, and trim the inline implementations that the script already provides.

Remove the duplicate simplified find_n_glycosylation_sites from Quick Start, or make Quick Start the only inline copy and have Core Capability 1 cover only the FASTA-scan and comparison extras.

Fix predict_o_glycosylation_hotspots to return ([], []) when the sequence is shorter than window_size so analyze_glycoprotein's tuple unpacking never fails, and either declare pandas in the install command or drop it from scan_fasta_for_n_glyc.

DimensionReasoningScore

Conciseness

The body is mostly efficient — domain-specific rules (sequon context, S/T-density heuristic, best practices, troubleshooting) earn their tokens — but it could be tightened: the Quick Start re-implements a simplified find_n_glycosylation_sites that Core Capability 1 then defines again in fuller form, and ~250 lines of inline code largely duplicate the bundled scripts/predict_glycosylation.py. This fits 'mostly efficient but includes some unnecessary content or could be tightened' rather than the noticeably-padded anchor 2 or the lean anchor 4/5.

3 / 5

Actionability

The guidance is largely fully executable: complete functions with docstrings, a real EPO example, two concrete workflows, and a runnable tool catalog. It falls short of 5 on minor gaps: scan_fasta_for_n_glyc imports pandas although installation only installs biopython and numpy, and predict_o_glycosylation_hotspots returns a bare [] for sequences shorter than window_size, which breaks the tuple unpacking in analyze_glycoprotein — so copy-paste code can fail on short inputs.

4 / 5

Workflow Clarity

The Typical Workflows section gives clear, correctly sequenced single-step examples, and Workflow 2 (comparing predictions against UniProt annotations) plus Best Practice 3 ("Validate with UniProt") provide an explicit validation checkpoint, matching 'clear sequence with most checkpoints present'. It does not reach 5 because there is no feedback loop (what to do when comparison fails or hotspots over-predict) beyond scattered troubleshooting entries.

4 / 5

Progressive Disclosure

Section structure is good (When to Use, Installation, Quick Start, Core Capabilities, Workflows, Best Practices, Troubleshooting, Resources), but the actual bundle is ignored: scripts/predict_glycosylation.py (422 lines, a full CLI tool) is never mentioned anywhere in the body, while equivalent logic is re-inlined as ~250 lines of code. This matches 'some structure but content that should be separate is inline and references are not signaled'; it is above 2 only because the section organization itself is solid and easy to navigate.

3 / 5

Total

14

/

20

Passed

Description

70%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, distinctive description with strong domain trigger terms, undermined by the complete absence of a 'when to use this skill' clause. The cross-references to sibling skills are good boundary guidance but do not tell the model when this skill itself should activate.

Suggestions

Add an explicit trigger clause, e.g., "Use when the user asks about glycosylation sites, glycoprotein analysis, or glycan structures in protein sequences."

Mention the bundled capability (running predictions from the CLI script or on FASTA input) so the description reflects the FASTA-scanning workflow, not only inline sequence analysis.

Include a synonym such as "glycoprotein analysis" or "sequon finding" to broaden natural trigger coverage.

DimensionReasoningScore

Specificity

The description lists several concrete actions — "N-glycosylation motif finding", "O-glycosylation hotspot prediction", "glycan structure resources" — which match the anchor for several specific actions with minor gaps. It falls short of a 5 because "glycan structure resources" is a resource pointer rather than a concrete action, and capabilities present in the body (combined glycoprotein analysis, comparison against UniProt annotations) are omitted; it is above a 3 because more than 1-2 concrete actions are named.

4 / 5

Completeness

The 'what' is clearly stated (three named capabilities plus "Lightweight, pure Python"), but there is no 'Use when...' clause or equivalent trigger guidance for this skill — the routing sentences ("For protein function queries use uniprot-database; for structure analysis use alphafold-database") point away to other skills rather than stating when to use this one. Per the judging guideline, a missing explicit trigger clause caps completeness at 3 even with a clear 'what'.

3 / 5

Trigger Term Quality

Terms like "glycosylation site prediction", "N-glycosylation", "O-glycosylation", and "glycobiology" are exactly the natural phrases a user would say, giving good keyword coverage. A 5 would require fuller synonym coverage (e.g., "glycoprotein", "glycan analysis", "sequon"), and common variations are missing, so it sits between the 'good coverage' and 'comprehensive' anchors, closer to 4.

4 / 5

Distinctiveness Conflict Risk

Glycobiology is a clear niche with distinct domain triggers (glycosylation, glycan), and the explicit routing to uniprot-database and alphafold-database actively reduces overlap risk with the most closely related skills. It clearly matches the 'clear niche with distinct triggers; minimal conflict risk' anchor; nothing pushes it toward 4 since the boundary disambiguation is already explicit.

5 / 5

Total

16

/

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/biology/glycobiology/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.