CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

microbial-dynamics

Microbial population dynamics modeling and analysis. Bacterial growth curve fitting (logistic, Gompertz, Baranyi), Lotka-Volterra community dynamics, Gillespie stochastic simulation, biofilm quantification, CFU enumeration, and genome annotation. For metabolic modeling use cobrapy; for sequence analysis use biopython.

60

Quality

76%

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/microbial-dynamics/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

71%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 highly actionable body with excellent executable code and lean domain prose, weakened by duplication between sections and a complete failure to reference the provided scripts/ bundle, which both wastes tokens and hides capabilities like image-based colony counting. Adding fit-quality validation checkpoints to the workflows would round it out.

Suggestions

Reference the scripts/ bundle explicitly (e.g. 'See scripts/growth_curve.py for a CLI version', 'scripts/colony_counter.py counts colonies from plate images') so the 1774 lines of provided tooling are discoverable instead of re-implemented inline.

Remove the duplication between Core Capability 2 and Workflow 2 (identical 3-species Lotka-Volterra setup) and consider moving full inline implementations to reference files, keeping only Quick Start examples in SKILL.md.

Add validation checkpoints to the workflows: check R² and convergence per condition in Workflow 1, and compare models via AIC/BIC as the Best Practices section itself recommends.

DimensionReasoningScore

Conciseness

The prose is lean and assumes domain competence (no explanation of what OD600 or scipy are), but the body is noticeably padded with duplication: Workflow 2 re-runs the identical 3-species Lotka-Volterra setup from Core Capability 2, and ~400 lines of inline implementations (growth models, Gillespie SSA, biofilm/CFU analysis) duplicate the 1774-line scripts/ bundle. This is more than the 'minor trimming' of the score-4 anchor.

3 / 5

Actionability

Fully executable, copy-paste-ready code throughout: a working Quick Start with real OD600 data and initial guesses, complete function definitions (fit_growth_curve with parameter bounds and R², gillespie_ssa, run_prokka with error checking, GFF parsing), install commands, and concrete example inputs with expected printouts covering the common cases.

5 / 5

Workflow Clarity

The 'Typical Workflows' section gives clear multi-step sequences (fit-then-compare conditions, simulate community, annotate-then-extract), and error handling exists (try/except RuntimeError on fitting, Prokka returncode check) plus a Troubleshooting section with problem/solution recovery. Not score 5 because the workflows themselves lack explicit validation checkpoints — e.g. Workflow 1's fitting loop never checks R² or handles failed convergence per condition.

4 / 5

Progressive Disclosure

The body has well-organized sections (Overview, When to Use, Core Capabilities, Workflows, Best Practices, Troubleshooting, Resources), but scored against the actual bundle: the 5 provided scripts/ files (1774 lines, including colony_counter.py's image-based colony counting — a capability mentioned nowhere in the body) are never referenced, while equivalent implementations are inlined in SKILL.md. References are absent rather than 'mostly clear', so this sits at the some-structure anchor rather than 4.

3 / 5

Total

15

/

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 strong, highly specific description with excellent distinctiveness thanks to explicit deferral boundaries. Its main weakness is the complete absence of a 'Use when...' trigger clause, which both caps completeness and leaves natural trigger phrasing underdeveloped.

Suggestions

Add an explicit trigger clause, e.g. 'Use when fitting bacterial growth curves from OD600 measurements, simulating microbial communities, or quantifying biofilm/CFU assays.'

Include common user-facing synonyms such as 'OD600', 'optical density', 'colony counting', and 'biogas production' so natural phrasings match the description.

Mention the anaerobic digestion modeling capability, which appears in the body but is absent from the description.

DimensionReasoningScore

Specificity

The description lists multiple specific concrete actions — 'Bacterial growth curve fitting (logistic, Gompertz, Baranyi)', 'Lotka-Volterra community dynamics', 'Gillespie stochastic simulation', 'biofilm quantification', 'CFU enumeration', and 'genome annotation' — giving comprehensive coverage of the skill's capabilities with named model variants, matching the top anchor exactly.

5 / 5

Completeness

The 'what' is clearly and comprehensively answered, but there is no 'Use when...' clause or equivalent explicit trigger guidance — the final sentences ('For metabolic modeling use cobrapy; for sequence analysis use biopython') deflect to other skills rather than stating when to use this one. Per the judging guideline, a missing 'when' clause caps completeness at 3.

3 / 5

Trigger Term Quality

Good natural keyword coverage ('growth curve', 'biofilm', 'CFU', 'genome annotation', 'population dynamics'), but common variations and synonyms users would say are missing, such as 'OD600', 'optical density', 'colony counting', and 'biogas'/'anaerobic digestion' (the latter is a body capability not surfaced in the description). Not score 5 because synonym/extension coverage is incomplete.

4 / 5

Distinctiveness Conflict Risk

It occupies a clear microbial-population-dynamics niche with distinct triggers, and the explicit boundary deferrals to cobrapy and biopython actively reduce wrong-skill triggering, matching the 'clear niche with minimal conflict risk' anchor.

5 / 5

Total

17

/

20

Passed

Validation

81%

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

Validation — 13 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

skill_md_line_count

SKILL.md is long (537 lines); consider splitting into references/ and linking

Warning

metadata_version

'metadata.version' is missing

Warning

frontmatter_unknown_keys

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

Warning

Total

13

/

16

Passed

Repository

synthetic-sciences/openscience

Path

backend/cli/skills/biology/microbial-dynamics/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.