Content
68%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 well-structured, lean, and actionable with concrete tool slugs and executable SOQL examples. Its key weakness is workflow clarity: destructive and batch Salesforce operations lack validation feedback loops, which caps that dimension at 3.
Suggestions
Add validate→fix→retry feedback loops to destructive/batch workflows (e.g., after SALESFORCE_CREATE_LEAD, re-query to confirm the record exists; after SALESFORCE_MASS_TRANSFER_OWNERSHIP, verify ownership changed on a sample record).
Show one concrete sample MCP tool invocation (e.g., a RUBE_SEARCH_TOOLS call and a resulting SALESFORCE_CREATE_LEAD call) to make the actionability fully copy-paste ready.
Consider moving the Quick Reference table into a references/ file to reduce redundancy with the inline workflow tool sequences and tighten conciseness.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and assumes Claude's knowledge (no padding about what Salesforce/leads/SOQL are); the only trim opportunity is the Quick Reference table duplicating tool slugs already listed in the workflow sections and pitfalls repeated both inline and under Known Pitfalls. | 4 / 5 |
Actionability | Provides concrete tool slugs with key parameters and copy-paste-ready executable SOQL examples, plus the explicit "call RUBE_SEARCH_TOOLS first" instruction; the minor gap is that no sample MCP tool invocation is shown as executable code. | 4 / 5 |
Workflow Clarity | Each workflow has a clear "When to use" and numbered tool sequence, and setup includes an ACTIVE-status checkpoint, but the create/update/mass-transfer/complete-task workflows are destructive or batch database operations with no validate→fix→retry feedback loops, which caps workflow clarity at 3. | 3 / 5 |
Progressive Disclosure | No bundle files exist and all content is inline, but it is well-organized into clearly headed sections (Prerequisites, Setup, Core Workflows, Common Patterns, Known Pitfalls, Quick Reference); at ~187 lines it exceeds the simple-skill threshold, and the Quick Reference table could be split into a reference file. | 4 / 5 |
Total | 15 / 20 Passed |