Content
82%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 well-structured, highly actionable CLI skill reference: executable commands, complete argument and output tables, error feedback loops, and excellent situation-based navigation to real bundle files. Weaknesses are minor: a redundant exclusion sentence, no explicit in-flow output verification, and dangling references to DESCRIPTION and tests/ that do not exist in the bundle.
Suggestions
Remove the duplicated count-model exclusion sentence in 'Input Format' (CPM/TPM/TMM/DESeq2 already listed under 'When Not to Use') to tighten conciseness.
Ship or remove the referenced 'DESCRIPTION' and 'tests/' paths — the body and cli-guide.md point to them but neither exists in the bundle, breaking navigation.
Add an explicit post-run verification step (e.g., check output_manifest.txt or run the audit test) to the main workflow, and make the overwrite warning independent of --verbose.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is table-driven and operational with no concept explanations, but the count-model exclusions (CPM/TPM/TMM/DESeq2) appear twice — once under 'When Not to Use' and again in 'Input Format' ("It does not infer count-model normalization such as CPM, TPM, TMM, or DESeq2 size factors") — a minor instance of trimming-worthy redundancy that keeps it below the 5 anchor's 'every token earns its place'. | 4 / 5 |
Actionability | Fully executable, copy-paste-ready commands ("Rscript scripts/main.R --input_file tests/data/expression_matrix.csv --output_dir ./output --method log2 --pseudo_count 1 --seed 42"), a complete argument table with defaults, a concrete CSV input example, an output-file manifest, error codes with causes and fixes, and runnable test commands — matching the 5 anchor's 'copy-paste ready code or commands' covering common cases. | 5 / 5 |
Workflow Clarity | The single-action workflow is unambiguous (validate input format, run the CLI, consume the documented outputs), with an error-code-to-cause-to-solution table as a feedback loop and a Testing section for verification. Below 5 because the main flow has no explicit post-run output-validation step (verification is deferred to separate test scripts) and the overwrite warning fires only when --verbose=true; above 3 because checkpoints are present via the error table and bundled tests. | 4 / 5 |
Progressive Disclosure | The 'When to Read External Files' situation table is exemplary one-level-deep navigation, and scripts/main.R, references/algorithm.md, references/troubleshooting.md, and references/cli-guide.md all exist in the bundle. Below 5 because the body (and cli-guide.md) reference 'DESCRIPTION' and 'tests/' files that are not present in the bundle, leaving dangling references; above 3 because structure and signaling are otherwise clear and appropriately split. | 4 / 5 |
Total | 17 / 20 Passed |