microscopy-scale-bar-adder

Add accurate, publication-ready scale bars to microscopy images given pixel-to-unit calibration data.

Quality

53%

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/microscopy-scale-bar-adder/SKILL.md

Quality

Content

53%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 skill is well-structured with a clear bundled script and good progressive disclosure, but the documented CLI parameters diverge from the actual script arguments, making the examples non-executable, and several template sections add verbosity without new information. Reconciling the Usage/Parameters tables with main.py's real flags is the highest-leverage fix.

Suggestions

Align Usage examples and the Parameters table with the real script flags: --input/--output/--scale-length/--scale-unit/--pixels-per-unit/--position using 'bottom-right' (hyphenated) and --bar-thickness default 8.

Remove or merge the redundant 'Implementation Notes (for script developer)' section since the full implementation already lives in scripts/main.py.

Trim the 'Fallback Template' and 'Response Template' blocks to a brief pointer, or consolidate them into the Error Handling section to reduce token overhead.

Dimension	Reasoning	Score
Conciseness	The body is mostly task-focused, but the 'Implementation Notes (for script developer)', 'Workflow', 'Fallback Template', and 'Response Template' sections repeat guidance Claude can derive and restate intent already obvious from the script, adding padding that could be trimmed.	3 / 5
Actionability	The Usage section gives concrete commands, but they do not match the actual script (e.g. uses '--image'/'--scale'/'--unit' and 'bottomright' while main.py defines '--input'/'--scale-length'/'--scale-unit' and 'bottom-right'), so the examples are not copy-paste executable as written.	3 / 5
Workflow Clarity	A sequence and validation steps exist (path-traversal checks, error handling, fallback), but the CLI examples are inconsistent with the bundled script and there is no validate-then-proceed checkpoint tying the documented Quick Check into the main workflow, leaving validation implicit.	3 / 5
Progressive Disclosure	The body is a well-sectioned single-file overview that points to one bundle file (scripts/main.py) one level deep; structure is clear and navigation is easy, with only minor organization gaps around duplicated template sections.	4 / 5
	Total	13 / 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 clearly states what the skill does and targets a distinct microscopy niche, but it lacks an explicit 'Use when...' trigger clause and has only modest keyword coverage. Adding natural trigger phrases and a few synonyms would lift completeness and trigger quality.

Suggestions

Add an explicit 'Use when...' clause, e.g. 'Use when adding scale bars to micrographs or preparing microscopy figures for publication.'

Include natural user phrasings and file extensions: 'micrographs, fluorescence/brightfield images, .tif/.tiff, .png, .jpg'.

Broaden the action list slightly (e.g. 'place, color, and label calibrated scale bars') to strengthen specificity.

Dimension	Reasoning	Score
Specificity	Names the domain (microscopy images) and one concrete action (add scale bars), but offers only a single action rather than multiple specific operations, so it does not reach the 'several specific actions' bar of a 4.	3 / 5
Completeness	The 'what' is clearly stated (add publication-ready scale bars to microscopy images), but there is no 'Use when...' clause or explicit trigger guidance, which per the guidelines caps completeness at 3.	3 / 5
Trigger Term Quality	It includes 'microscopy images' and 'scale bars', but omits common natural variations users say (e.g. 'micrographs', 'scale bar', 'fluorescence/brightfield', file extensions like .tif), so coverage is partial.	3 / 5
Distinctiveness Conflict Risk	'Microscopy images' plus 'scale bars' plus 'pixel-to-unit calibration' carves a fairly specific niche unlikely to collide with other skills, with only minor overlap risk against general image-annotation tools.	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/Other/microscopy-scale-bar-adder/SKILL.md
Commit: f5ef65b

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