Add scale bars to microscopy images
53
Quality
31%
Does it follow best practices?
Impact
92%
1.95xAverage score across 3 eval scenarios
Passed
No known issues
Optimize this skill with Tessl
npx tessl skill review --optimize ./scientific-skills/Data analysis/microscopy-scale-bar-adder/SKILL.mdQuality
Discovery
40%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 identifies a clear, specific niche (microscopy scale bars) that is highly distinctive, but it is too terse. It lacks explicit trigger guidance ('Use when...') and could benefit from listing additional capabilities and natural keyword variations that users might employ when needing this skill.
Suggestions
Add a 'Use when...' clause with trigger terms like 'add scale bar', 'microscopy calibration', 'micrograph annotation', 'SEM image', 'TEM image'
Expand capabilities to include related actions such as 'calibrate pixel-to-micron ratio', 'annotate micrographs', or 'add measurement overlays'
Include common file format triggers like '.tif', 'TIFF microscopy files', or mention specific microscopy software formats
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Names a specific domain (microscopy images) and one concrete action (add scale bars), but only describes a single capability rather than listing multiple specific actions. | 2 / 3 |
Completeness | Only answers 'what' (add scale bars to microscopy images) but completely lacks any 'Use when...' clause or explicit trigger guidance for when Claude should select this skill. | 1 / 3 |
Trigger Term Quality | Includes relevant terms 'scale bars' and 'microscopy images' that users might say, but missing common variations like 'micrograph', 'SEM', 'TEM', 'magnification', 'calibration bar', or file formats. | 2 / 3 |
Distinctiveness Conflict Risk | Very clear niche - microscopy scale bars is a highly specific domain unlikely to conflict with other skills. The combination of 'scale bars' and 'microscopy' creates a distinct trigger. | 3 / 3 |
Total | 8 / 12 Passed |
Implementation
22%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This skill is mostly template boilerplate with minimal actionable content. It provides a single CLI command without explaining parameters, showing expected outputs, or describing the actual process of adding scale bars. The extensive risk assessment and evaluation criteria sections consume tokens without helping Claude perform the task.
Suggestions
Add concrete examples showing input images and expected output with scale bars, including parameter explanations (what does --scale 50 mean? pixels per unit? bar length?)
Include executable Python code showing how to programmatically add scale bars, not just CLI usage
Remove or drastically reduce the boilerplate sections (risk assessment, security checklist, evaluation criteria, lifecycle status) which don't help Claude execute the task
Add validation steps: how to verify the scale bar is correctly sized and positioned, common errors and how to fix them
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill contains significant boilerplate (risk assessment tables, security checklists, evaluation criteria, lifecycle status) that adds little value for Claude executing this task. The core functionality could be conveyed in far fewer tokens. | 2 / 3 |
Actionability | The skill provides only a CLI invocation example with no explanation of what the parameters mean, no code showing how scale bars are calculated or added, and no concrete examples of input/output. The 'Features' section describes capabilities without showing how to use them. | 1 / 3 |
Workflow Clarity | There is no workflow described - just a single command with no context about what happens before or after, no validation steps, and no guidance on handling errors or verifying the scale bar was added correctly. | 1 / 3 |
Progressive Disclosure | The content is organized into sections, but the sections are poorly chosen - heavy on administrative boilerplate (risk assessment, security checklist, lifecycle) while lacking substantive technical content that could be referenced or expanded upon. | 2 / 3 |
Total | 6 / 12 Passed |
Validation
90%Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.
Validation — 10 / 11 Passed
Validation for skill structure
| Criteria | Description | Result |
|---|---|---|
frontmatter_unknown_keys | Unknown frontmatter key(s) found; consider removing or moving to metadata | Warning |
Total | 10 / 11 Passed | |
ca9aaa4
Table of Contents
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.