buffer-calculator

Calculate precise buffer recipes with accurate mass and volume measurements for molecular biology and biochemistry. Supports PBS, RIPA, and TAE with concentration scaling, stock solution preparation, pH adjustment guidance, and step-by-step protocols.

Quality

67%

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/Other/buffer-calculator/SKILL.md

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.

The body is well-organized and largely executable with concrete code, CLI usage, and verification values, but it carries some redundant general-knowledge padding and a broken/hedged reference. A documentation/script mismatch on supported buffers slightly weakens actionability.

Suggestions

Reconcile the buffer library table with scripts/main.py: either add HEPES, Tris-HCl, and MOPS to BUFFER_RECIPES or remove them from the table so documented examples actually run.

Trim the 'Common Pitfalls' section to non-obvious items only, dropping general chemistry reminders Claude already knows, to improve token efficiency.

Either create references/troubleshooting.md and link it without the '(if available)' hedge, or remove the dangling reference so navigation is unambiguous.

Dimension	Reasoning	Score
Conciseness	Mostly efficient with tables, formulas, and CLI examples that earn their place, but the 'Common Pitfalls' section explains general chemistry Claude already knows (add acid to water, mM vs M) and the MW reference table duplicates values already in the script.	3 / 5
Actionability	Provides copy-paste-ready Python, CLI commands, and the executable formula, but the buffer library table documents HEPES, Tris-HCl, and MOPS that are absent from the script's BUFFER_RECIPES, so those examples would return None.	4 / 5
Workflow Clarity	A clear 5-step sequence with an explicit validation checkpoint (step 2: stop if unsupported) and a fallback path (step 5), but it lacks a validate-fix-retry feedback loop for execution failures.	4 / 5
Progressive Disclosure	Section structure is clear and well-headed, but the only external reference (references/troubleshooting.md) is hedged '(if available)' and the directory does not exist, while bulk reference content (MW table, pitfalls) is inlined.	3 / 5
	Total	14 / 20 Passed

Description

71%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 specific and action-rich with concrete buffer-name triggers, but it omits any explicit 'when to use' guidance, which caps completeness. It is distinct and unlikely to misfire broadly.

Suggestions

Add an explicit 'Use when...' clause stating the trigger conditions, e.g. 'Use when preparing laboratory buffers like PBS, RIPA, or TAE from stock solutions.'

Include common natural synonyms users might say, such as 'buffer prep' or 'make PBS', to broaden trigger coverage.

Dimension	Reasoning	Score
Specificity	Lists multiple concrete actions — 'Calculate precise buffer recipes with accurate mass and volume measurements', 'concentration scaling', 'stock solution preparation', 'pH adjustment guidance', and 'step-by-step protocols' — giving comprehensive coverage of what the skill does.	5 / 5
Completeness	Has a clear 'what' but no 'Use when...' clause or equivalent explicit trigger guidance, so per the rubric cap completeness is held at 3.	3 / 5
Trigger Term Quality	Strong natural terms a lab user would say (PBS, RIPA, TAE, 'buffer recipes', 'stock solution', 'pH', 'concentration'), but missing common synonyms like 'buffer prep' or 'make PBS'.	4 / 5
Distinctiveness Conflict Risk	A clear niche (laboratory buffer recipes) with distinct buffer-name triggers, but minor overlap risk with general chemistry or recipe-calculation skills.	4 / 5
	Total	16 / 20 Passed

Validation

81%

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 — 13 / 16 Passed

Validation for skill structure

Criteria	Description	Result
frontmatter_unknown_keys	Unknown frontmatter key(s) found; consider removing or moving to metadata	Warning
relative_links	Relative link issues: 1 missing	Warning
referenced_paths_exist	Referenced path issues: 2 missing	Warning

	Total	13 / 16 Passed

Repository: aipoch/medical-research-skills
Path: scientific-skills/Other/buffer-calculator/SKILL.md
Commit: f5ef65b

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