Content
78%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 thorough, actionable skill body with executable REST and MCP examples and well-structured one-level-deep references. The main weakness is conciseness: the strict expression/tss_index contract is repeated across multiple sections and inline version stamps, which inflates tokens without adding proportional clarity.
Suggestions
Consolidate the expression/tss_index rules into a single section; the table row, prose block, and blockquote all restate the same 9,198 bp / tss_index constraints — keep one authoritative statement and cross-reference it.
Move the OpenAPI version stamps (2026.08.20.7, 2026.09.10.1) into a single 'Contract version' line or a references file so the body stays version-neutral and easier to maintain.
Promote the async and composite steps into a short numbered checklist with explicit validation gates (e.g. 'assert scored_window == [.., 9198] before trusting the result') so checkpoints are visible at a glance.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and high-signal but the expression/tss_index rules are restated across the task table, a dedicated prose section, a blockquote, and code comments, and inline version stamps (2026.08.20.7, 2026.09.10.1) add time-sensitive detail that could be tightened. | 3 / 5 |
Actionability | Fully executable, copy-paste-ready Python (a complete predict() helper with auth/headers, an async polling loop) and concrete MCP tool-call signatures cover the common promoter and expression cases end to end. | 5 / 5 |
Workflow Clarity | Acquire-then-predict and submit-then-poll sequences are clear with explicit validation (assert on meta.task_specific_counts.scored_window, genes_predicted + genes_skipped == genes_found) and error-recovery guidance (429 backoff, 413 retry as async), but checkpoints are woven through prose rather than presented as a crisp gated checklist. | 4 / 5 |
Progressive Disclosure | SKILL.md is a well-organized overview with clearly signaled, one-level-deep references to four real bundle files (tasks.md, api-and-auth.md, mcp.md, sequence-acquisition.md), each mapped to a topic; navigation is easy and no nesting goes deeper than one level. | 5 / 5 |
Total | 17 / 20 Passed |