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 dense, well-structured reference for MCP-driven Salesforce automation with concrete tool slugs and parameters. Its main weaknesses are the absence of validation/verification checkpoints in the data-mutating workflows (notably the batch mass-transfer operation) and some duplicated content between the workflow sections and the Quick Reference table.
Suggestions
Add a verification step before destructive or batch operations, e.g. confirm the record list with the user before SALESFORCE_MASS_TRANSFER_OWNERSHIP and re-query to confirm updates took effect.
Remove the duplicated ID-format guidance (stated in both the lead workflow pitfalls and the Known Pitfalls section) and consolidate it in one place.
Consider moving the Quick Reference table into a references/ file to keep SKILL.md a lean overview.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Largely lean — terse tool sequences with [Optional]/[Required] markers and pitfall bullets that assume Salesforce/SOQL knowledge — but the ID-format pitfall is stated twice and the Quick Reference table duplicates workflow tool slugs. | 4 / 5 |
Actionability | Concrete tool slugs, required parameter names, and copy-paste-ready SOQL snippets make the guidance mostly executable; minor gaps remain since full tool-call payloads and the pagination token flow are not shown. | 4 / 5 |
Workflow Clarity | Setup has explicit validation (auth link fallback, 'Confirm connection status shows ACTIVE'), but the CRUD workflows list unvalidated optional steps and mass transfer ownership is a batch operation with no verification checkpoint, capping this at 3. | 3 / 5 |
Progressive Disclosure | Well-organized single-file structure with clear section headers and no nested references; at ~190 lines, content like the Quick Reference table could arguably move to a separate reference file, keeping it just below the top anchor. | 4 / 5 |
Total | 15 / 20 Passed |