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.
The content is highly actionable and reasonably concise, with clean structure and one-level-deep delegation to the bundled script. Its main gap is the absence of explicit error-recovery feedback loops for the batch/remote API operations.
Suggestions
Add an explicit error-recovery workflow (e.g., on API 500/429 or empty results: retry with backoff, verify the Matrix ID, fall back to infer_from_sequence) so batch/remote operations have a validate→fix→retry loop.
Reference the bundled references/citation.bib from the body (e.g., a Citations section) so all bundle files are discoverable.
Trim the opening paragraph that redefines JASPAR/PFMs, since the description frontmatter already conveys this.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is efficient and mostly assumes Claude's competence, with only minor over-explanation (e.g., restating what JASPAR stores as PFMs) that could be trimmed. | 4 / 5 |
Actionability | Each operation has copy-paste-ready `uv run scripts/jaspar_api.py` commands with real arguments and flag examples covering the common cases. | 5 / 5 |
Workflow Clarity | Operations are well sequenced and Core Rules enforce some safeguards (wrapper rate limiting, Matrix ID resolution, window chunking), but for batch/remote API work there is no explicit validate→fix→retry feedback loop or error-recovery checklist, which caps workflow clarity per the rubric. | 3 / 5 |
Progressive Disclosure | SKILL.md stays an overview with API specifics delegated one level deep to the bundled `scripts/jaspar_api.py`; structure is clear, though `references/citation.bib` is not referenced from the body. | 4 / 5 |
Total | 16 / 20 Passed |