Content
56%Weight 40%Scale 1-5Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
The skill is highly actionable with real executable code matching its bundled script, but it is markedly verbose and monolithic: generic boilerplate and repeated descriptions inflate the body, and an existing reference file is orphaned rather than linked. Workflow clarity is good though the top-level workflow is generic.
Suggestions
Move the screen-type patterns, troubleshooting, and common-pitfalls sections into reference files under references/ and link to them from SKILL.md to reduce the body and fix progressive disclosure.
Delete the generic boilerplate sections (Output Requirements, Response Template, Input Validation, Output Contract, Inputs to Collect, Validation and Safety Rules) and the verbatim description repeats in 'When to Use' / 'Key Features' to tighten conciseness.
Link the existing references/runtime_checklist.md from the References section and correct the false 'No reference files currently available' statement.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The ~1188-line body is noticeably verbose: the description is repeated verbatim in 'When to Use' and 'Key Features', and generic boilerplate sections (Output Requirements, Response Template, Input Validation, Output Contract, Validation and Safety Rules, Inputs to Collect) pad the skill with non-CRISPR-specific content. | 2 / 5 |
Actionability | Provides mostly executable, copy-paste-ready code (qc_metrics, calculate_lfc, rra_analysis, identify_hits) that matches the actual main.py API, plus concrete CLI commands and threshold tables, with only minor gaps such as an undeclared matplotlib import and an assumed external library_annotation.csv. | 4 / 5 |
Workflow Clarity | Clear sequenced workflows with validation checkpoints (Gini <0.4 QC check, smoke checks) and feedback loops (fallback path on failure) plus a thorough Quality Checklist, but the top-level 'Workflow' section is generic boilerplate disconnected from the concrete CRISPR execution steps. | 4 / 5 |
Progressive Disclosure | Has section structure, but content that belongs in separate files (4 screen patterns, troubleshooting, common pitfalls) is inlined into SKILL.md, and the existing references/runtime_checklist.md is never linked — the References section even incorrectly states 'No reference files currently available'. | 3 / 5 |
Total | 13 / 20 Passed |