Content
72%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.
Well-structured, actionable content with strong progressive disclosure that splits detailed API docs into verified reference files. Its main weakness is workflow clarity: batch and screening workflows submit and poll without validation checkpoints or status verification before data access.
Suggestions
Add a status-verification checkpoint to the core workflow pattern (check workflow.status == 'completed' before accessing workflow.data) and integrate it into the five core examples rather than isolating it in the Error Handling section.
Add a feedback loop to the batch/virtual-screening pattern: after batch_poll_status, handle failed workflows explicitly (retry or report) before consuming results.
Replace placeholders in the Common Patterns section ([x, y, z], compound_library, 'complex_molecule_smiles') with concrete sample values so the examples are copy-paste ready, or explicitly mark them as placeholders requiring user input.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly lean, code-driven content with little explanation of concepts Claude already knows, but the repeated submit/wait_for_result/fetch_latest boilerplate across five examples and the promotional 'Why Rowan' / 'Key Capabilities' bullets are minor instances that could be trimmed. | 4 / 5 |
Actionability | The five core workflow examples and the RDKit-native, batch, folder, and error-handling sections are concrete and copy-paste ready, but the 'Common Patterns' section uses undefined placeholders like 'center': [x, y, z], compound_library, and 'complex_molecule_smiles', leaving minor gaps. | 4 / 5 |
Workflow Clarity | A clear submit -> wait_for_result -> fetch_latest -> access-data sequence is shown throughout, but batch operations (Pattern 2 virtual screening, batch_submit_workflow) lack validation checkpoints, and the main examples access workflow.data without first verifying status — the missing-verification cap for batch operations applies. | 3 / 5 |
Progressive Disclosure | SKILL.md acts as an overview with core examples inline and a clearly signaled 'Reference Documentation' section listing all six one-level-deep reference files (api_reference, workflow_types, rdkit_native, molecule_handling, proteins_and_organization, results_interpretation), each verified to exist, with an inline pointer ('See references/rdkit_native.md'). | 5 / 5 |
Total | 16 / 20 Passed |