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.
A well-structured, information-dense reference for Close CRM automation with concrete tool names, parameters, and pitfalls throughout. Its main weaknesses are the lack of validation/confirmation checkpoints around destructive and bulk operations (capping workflow clarity) and noticeable redundancy between per-workflow pitfalls, Known Pitfalls, and the Quick Reference table.
Suggestions
Add explicit verification before destructive operations: in the CLOSE_DELETE_CALL workflow, insert steps to fetch and confirm the call record (and confirm with the user) before deletion, e.g. '1. Retrieve the call to verify call_id matches the intended record 2. Confirm with the user 3. Delete'.
Deduplicate: remove the ID-format and custom-field pitfall repetition between per-workflow 'Pitfalls' and the 'Known Pitfalls' section, keeping one canonical location.
Make ID resolution executable: name the actual search tool (e.g. the CLOSE search/lead-find tool slug from Rube) in the 'ID Resolution' pattern instead of the vague 'Search for leads using the Close search API'.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is terse, bullet-driven, and free of background concept explanations (no 'what is a CRM' padding). Minor over-explanation and redundancy remain — pitfalls like ID formats and custom-field IDs appear both per-workflow and again in 'Known Pitfalls', and the Quick Reference table repeats the per-workflow parameter lists — so it is efficient-with-trimmable-bits (4) rather than lean (5). | 4 / 5 |
Actionability | Concrete guidance dominates: exact tool slugs (CLOSE_CREATE_LEAD, CLOSE_CREATE_SMS), named parameters, ID formats ('lead_XXXXXXXXXXXXX'), and ISO 8601 date formats. It stops short of 5 because key steps are described but not executable — 'Search for leads using the Close search API' names no tool, and no example call payloads are shown, leaving minor gaps the agent must fill via RUBE_SEARCH_TOOLS. | 4 / 5 |
Workflow Clarity | The setup section has a clear sequence with an explicit validation checkpoint ('Confirm connection status shows ACTIVE before running any workflows'), and each workflow lists its tool sequence. However the destructive workflow (CLOSE_DELETE_CALL) has no verification or confirmation step before permanent deletion, and the bulk-operation rate-limit guidance ('Bulk operations should validate IDs before executing') states a rule without any checkpoint — per the guidelines, missing validation on destructive/batch operations caps workflow clarity at 3. | 3 / 5 |
Progressive Disclosure | The file has good structure — Prerequisites, Setup, six consistently-formatted workflows, Common Patterns, Known Pitfalls, and a Quick Reference table — and the only external pointer (composio.dev/toolkits/close) is clearly signaled. It falls short of 5 because all ~210 lines of per-tool parameter and pitfall detail live inline in SKILL.md with no one-level-deep reference files for the per-workflow detail, which could be split out. | 4 / 5 |
Total | 15 / 20 Passed |