Content
92%Weight 40%Scale 1-3Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
The body is a tight, highly actionable multi-phase workflow with strong validation checkpoints and executable code. Its only weakness is progressive disclosure: it is a monolithic file that could offload the GraphQL query and email templates into reference files.
Suggestions
Move the full partners GraphQL query into a references file (e.g. references/partners-query.graphql) and link to it from Phase 1a, keeping only the filter intent inline.
Extract the detailed email rules and per-email templates into a references file (e.g. references/email-templates.md), leaving a concise summary plus signposted link in Phase 2.
Add a short 'Inputs / Outputs' or quick-reference section near the top pointing to the credentials, criteria file, and output filenames so the overview navigates to the detail below.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and assumes Claude's competence: it gives domain-specific procedure, an executable GraphQL query, and a Python snippet without explaining concepts Claude already knows. Guidance such as 'A match built on a vague brief is noise' earns its place rather than padding. | 3 / 3 |
Actionability | Provides fully executable artifacts, a copy-paste Python Gmail-open script, exact filename patterns, URL format, and subject prefixes, hitting the copy-paste-ready anchor. | 3 / 3 |
Workflow Clarity | Phases 0, 1, and 2 are clearly sequenced with explicit checkpoints: a credentials stop in 0a, a critical brief-quality gate in 0b, and the 1d pause for explicit user confirmation before generating emails, giving feedback loops for this batch email operation. | 3 / 3 |
Progressive Disclosure | It is a well-sectioned single file with no nested references, but at roughly 200 lines it keeps the full GraphQL query, email-rule block, and Python script inline rather than splitting them into one-level-deep reference files, matching the 'content that should be separate is inline' anchor. | 2 / 3 |
Total | 11 / 12 Passed |