Content
57%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 technical core is excellent — executable code and concrete API guidance — but it is buried under substantial generic boilerplate duplication, and the reference links point to a nonexistent directory. Trimming the filler and fixing the paths would materially raise quality.
Suggestions
Remove the duplicated generic boilerplate sections (lines 11-50 and 203-255) that restate the description and add no plotly-specific guidance; keep only the concrete sections 1-5.
Fix the reference paths from 'reference/' to 'references/' (plural) so the signaled files actually resolve, and format them as markdown links for navigability.
Replace the generic Recommended Workflow with a plotly-specific sequence (e.g., pick px vs go -> build figure -> configure interactivity -> export HTML/image) with concrete checkpoints.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Noticeably verbose: roughly half the non-code body is generic boilerplate — five duplicated header sections (When to Use, Key Features, Dependencies, Example Usage, Implementation Details at lines 11-50) and seven generic trailing sections (lines 203-255) that restate the description and add no plotly-specific value. | 2 / 5 |
Actionability | The plotly-specific body provides a complete, copy-paste-ready runnable example (px.scatter, update_traces, make_subplots, go.Bar, write_html, write_image) plus concrete install command and specific API guidance (px vs go, hovertemplate, rangeslider_visible, include_plotlyjs). | 5 / 5 |
Workflow Clarity | A sequenced Recommended Workflow with validation at steps 1 and 4 is present, but it is generic boilerplate rather than plotly-specific, and the checkpoints are abstract rather than concrete. | 3 / 5 |
Progressive Disclosure | Five real one-level-deep reference files are signaled, but the body paths are broken — it says 'reference/' (singular) while the actual bundle directory is 'references/' (plural), so navigation does not resolve and references are not correctly signaled. | 3 / 5 |
Total | 13 / 20 Passed |