Complete mass spectrometry analysis platform. Use for proteomics workflows feature detection, peptide identification, protein quantification, and complex LC-MS/MS pipelines. Supports extensive file formats and algorithms. Best for proteomics, comprehensive MS data processing. For simple spectral comparison and metabolite ID use matchms.
63
75%
Does it follow best practices?
Impact
—
No eval scenarios have been run
Passed
No known issues
Optimize this skill with Tessl
npx tessl skill review --optimize ./scientific-skills/pyopenms/SKILL.mdQuality
Discovery
100%Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.
This is a strong skill description that clearly defines its domain (mass spectrometry / proteomics), lists specific capabilities, provides explicit usage triggers, and even includes disambiguation guidance against a related skill (matchms). The description is concise yet comprehensive, covering what, when, and when-not-to-use effectively.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Lists multiple specific concrete actions: feature detection, peptide identification, protein quantification, and LC-MS/MS pipelines. Also mentions file format support and algorithm coverage. | 3 / 3 |
Completeness | Clearly answers both what (mass spectrometry analysis with feature detection, peptide identification, protein quantification, LC-MS/MS pipelines) and when ('Use for proteomics workflows', 'Best for proteomics, comprehensive MS data processing'). Also includes negative guidance on when NOT to use it ('For simple spectral comparison and metabolite ID use matchms'). | 3 / 3 |
Trigger Term Quality | Includes strong natural keywords users would say: 'mass spectrometry', 'proteomics', 'peptide identification', 'protein quantification', 'LC-MS/MS', 'MS data processing', 'feature detection'. Also differentiates from a related skill (matchms) with terms like 'spectral comparison' and 'metabolite ID'. | 3 / 3 |
Distinctiveness Conflict Risk | Occupies a clear niche in proteomics and mass spectrometry analysis. Explicitly distinguishes itself from matchms by specifying the boundary ('For simple spectral comparison and metabolite ID use matchms'), which greatly reduces conflict risk. | 3 / 3 |
Total | 12 / 12 Passed |
Implementation
50%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This skill provides a reasonable overview of PyOpenMS with some executable examples and a clear reference file structure, but falls short in several areas. Key code examples are incomplete or non-functional (feature detection snippet), critical workflows lack validation checkpoints, and some sections explain things Claude already knows. The progressive disclosure strategy is sound in design but unverifiable without bundle files.
Suggestions
Fix the feature detection code example to be complete and executable—currently `features` and `params` are undefined, making it non-functional
Add validation checkpoints to workflows, e.g., checking spectrum count after loading, verifying FDR threshold results, validating output file existence
Remove or significantly trim the 'Integration with Other Tools' and 'Overview' sections—Claude already knows what PyOpenMS does and how Python libraries interoperate
Add a concrete code example to the metabolomics workflow section instead of just listing abstract steps
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Generally efficient but includes some unnecessary content like the 'Integration with Other Tools' section (Claude knows these libraries work together), the installation verification step, and the 'Overview' paragraph that restates what Claude would already know about PyOpenMS. The data structures section is borderline—it's a useful quick reference but could be more compact. | 2 / 3 |
Actionability | Provides executable code for file I/O, parameter management, and data exploration, but several key workflows are incomplete or skeletal. The feature detection example is a stub (missing variable definitions for `features` and `params`), the identification workflow only shows loading/FDR, and the metabolomics section has no code at all—just a numbered list of steps. Critical workflows defer entirely to reference files. | 2 / 3 |
Workflow Clarity | The metabolomics section lists a 5-step workflow but lacks validation checkpoints or error handling. The identification workflow shows loading and FDR filtering but no validation of results or feedback loops. For a complex multi-step domain like proteomics pipelines, the absence of explicit validation steps (e.g., checking feature counts, verifying FDR thresholds, validating output files) is a notable gap. | 2 / 3 |
Progressive Disclosure | The skill references six separate reference files with clear signaling, which is good structure. However, no bundle files are provided, so these references are unverifiable and potentially broken. The main file itself is somewhat long with inline content that could be trimmed given the reference file strategy. The references section at the bottom duplicates the inline references scattered throughout. | 2 / 3 |
Total | 8 / 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.