Content
76%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.
A highly actionable, code-rich skill body with well-organized references to real bundle files. Main weaknesses are redundant boilerplate across use cases and missing validation checkpoints in the (batch-capable) workflows.
Suggestions
Add an explicit validation/checklist step before inference (e.g., verify genes-as-columns orientation and that tf_names match gene names) so batch and multi-condition workflows have a checkpoint.
Deduplicate the install command and collapse the three near-identical use-case code blocks into one parameterized example, relying on references for variations.
Move the multi-condition and multi-seed reproducibility examples into a reference file, keeping SKILL.md as a lean overview pointing to references/.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly efficient and code-driven, but the install command is duplicated (Quick Start and Installation sections), the `if __name__ == '__main__'` boilerplate recurs across three use-case blocks, and the seed concept is restated in Reproducibility after already being shown. | 4 / 5 |
Actionability | Fully executable, copy-paste-ready code throughout — quick start, algorithm comparison, distributed clients, and three use cases — plus a runnable CLI script invocation covering the common case. | 5 / 5 |
Workflow Clarity | Steps are present (load → infer → save) but lack validation checkpoints; the multi-condition loop is a batch operation with no verify step, and data-format/TF-name checks appear only in Troubleshooting rather than as inline checkpoints. | 3 / 5 |
Progressive Disclosure | Good structure with real one-level-deep references clearly signaled ("See references/basic_inference.md", "For detailed algorithm comparison…references/algorithms.md") and a ready script, but the body inlines three full use-case code blocks plus reproducibility/troubleshooting that keep it from a lean overview. | 4 / 5 |
Total | 16 / 20 Passed |