Microscopy data management platform. Access images via Python, retrieve datasets, analyze pixels, manage ROIs/annotations, batch processing, for high-content screening and microscopy workflows.
65
51%
Does it follow best practices?
Impact
88%
1.49xAverage score across 3 eval scenarios
Advisory
Suggest reviewing before use
Optimize this skill with Tessl
npx tessl skill review --optimize ./scientific-skills/omero-integration/SKILL.mdQuality
Discovery
67%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 does a good job listing specific capabilities and occupying a clear niche in microscopy data management. Its main weakness is the lack of an explicit 'Use when...' clause, which would help Claude know exactly when to select this skill. The trigger terms could also be expanded to include more natural user language and common platform/format references.
Suggestions
Add an explicit 'Use when...' clause, e.g., 'Use when the user asks about microscopy image analysis, OMERO, high-content screening, or working with microscope image datasets.'
Include more natural trigger terms and common variations such as specific platform names (OMERO), file formats (.tif, .nd2, .czi), and related terms like 'fluorescence imaging', 'confocal', 'cell imaging'.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Lists multiple specific concrete actions: 'Access images via Python', 'retrieve datasets', 'analyze pixels', 'manage ROIs/annotations', 'batch processing'. These are concrete, actionable capabilities. | 3 / 3 |
Completeness | The 'what' is well covered with specific actions, but there is no explicit 'Use when...' clause or equivalent trigger guidance. The 'when' is only implied through domain terms like 'microscopy workflows' and 'high-content screening'. Per rubric guidelines, missing 'Use when...' caps completeness at 2. | 2 / 3 |
Trigger Term Quality | Includes some relevant domain keywords like 'microscopy', 'ROIs', 'annotations', 'high-content screening', 'pixels', but misses common user terms like specific platform names (e.g., OMERO), file formats (.tif, .nd2), or variations like 'microscope images', 'fluorescence', 'confocal'. | 2 / 3 |
Distinctiveness Conflict Risk | The combination of 'microscopy', 'ROIs/annotations', 'high-content screening', and 'pixels' creates a very clear niche that is unlikely to conflict with other skills. This is a highly specialized domain. | 3 / 3 |
Total | 10 / 12 Passed |
Implementation
35%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This skill serves as a comprehensive table of contents for OMERO integration but suffers from significant verbosity and redundancy. The same information (8 capability areas and their use cases) is repeated in at least three different sections. While the Quick Start code is executable and the reference file structure is well-organized, the main skill body would benefit greatly from consolidation and trimming to respect token budget.
Suggestions
Consolidate the 'Core Capabilities', 'Selecting the Right Capability', and 'Common Workflows' sections into a single concise reference table mapping tasks to reference files, eliminating the triple repetition of capability areas.
Remove the 'When to Use This Skill' section entirely — it restates the overview and Claude can infer when to apply the skill from the content itself.
Add validation checkpoints to workflows, e.g., verify connection before proceeding, confirm image/dataset exists before processing, validate results before storing to OMERO tables.
Trim the 'Notes' section to only non-obvious information — hierarchical organization and 'always close connections' are already covered in the Quick Start examples.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill is very verbose with significant redundancy. The 'When to Use This Skill' section restates the overview. The 'Core Capabilities' section lists 8 areas with 'Common scenarios' bullet points that are essentially table-of-contents entries repeated again in 'Selecting the Right Capability' and yet again in 'Common Workflows'. The 'Notes' section restates things already covered. Much of this is organizational knowledge Claude doesn't need spelled out repeatedly. | 1 / 3 |
Actionability | The Quick Start section provides executable connection code and the error handling section has a concrete pattern. However, the bulk of the skill is navigational (pointing to reference files) rather than providing actionable code. The actual domain-specific operations (pixel access, ROI creation, table storage) are deferred entirely to reference files that aren't provided, leaving the main skill with limited executable guidance. | 2 / 3 |
Workflow Clarity | Three workflows are listed with numbered steps, which is good. However, they lack validation checkpoints, error recovery steps, and concrete commands at each step. For operations involving batch processing and data manipulation, there are no explicit verification steps (e.g., confirming connection succeeded before proceeding, validating results before storing). The error handling section is separate and generic rather than integrated into workflows. | 2 / 3 |
Progressive Disclosure | The skill references 8 detailed files in a references/ directory with clear file paths and descriptions, and provides a 'Selecting the Right Capability' guide for navigation. However, no bundle files are provided, so the references cannot be verified. More importantly, the main SKILL.md itself contains too much redundant navigational content (capabilities listed, then re-listed in selection guide, then re-listed in workflows) rather than being a lean overview pointing to details. | 2 / 3 |
Total | 7 / 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 |
|---|---|---|
metadata_version | 'metadata.version' is missing | Warning |
Total | 10 / 11 Passed | |
cbcae7b
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.