Content
71%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 body is a strong, highly executable reference for read-only Salesforce querying — real commands, seven working SOQL examples, and clear setup — but it under-delivers on its own architecture: the central referenced file is missing from the bundle, and placeholder customization content that should live there is inlined instead. Workflow guidance for the 'manage' half and query-failure handling is absent.
Suggestions
Include the referenced SALESFORCE_STRUCTURE.md (even as a starter template) in the bundle so the skill's primary reference is not broken.
Move the placeholder 'Key Concepts' sections and the Common Queries catalog into SALESFORCE_STRUCTURE.md / COMMON_QUERIES.md to slim SKILL.md to an actionable overview.
Add a short validation/feedback loop (e.g. what to do when a query errors or the org alias is unauthenticated) and either a concrete manage/DML workflow or drop the 'manage' claim from scope.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The commands and queries are tight, but placeholder template sections ('Product A — Description', 'Update with your company's product lines') and the seven-query catalog duplicate content the skill itself delegates to SALESFORCE_STRUCTURE.md/COMMON_QUERIES.md. Mostly efficient with noticeable content that could be trimmed or moved, which is the anchor-3 fit rather than the level-4 'minor instances'. | 3 / 5 |
Actionability | Fully executable, copy-paste-ready guidance: 'mcporter call salesforce.run_soql_query …', 'sf data query --query … --target-org my-prod', and seven complete SOQL queries (pipeline, renewals, ARR by account, account/contact lookups) that cover the common cases, plus a concrete MCP tool list. Matches the level-5 anchor. | 5 / 5 |
Workflow Clarity | Setup is clearly sequenced (install CLI → 'sf org login web --alias my-prod' → optional MCP server) and the primary task (run a SOQL query) is unambiguous, with sensible tips. Not 5: no error-handling/feedback loop for failed queries or auth problems, and the claimed 'manage' side has no workflow at all — though the shown operations are read-only, so the destructive-op cap does not apply. | 4 / 5 |
Progressive Disclosure | Section headers are good and references are only one level deep, but the primary referenced file './SALESFORCE_STRUCTURE.md' does not exist in the bundle (no references/ or sibling file), so the main reference is broken. Meanwhile org-specific catalog content that belongs in that file is inlined in the body — matching anchor 3 rather than 4's 'references mostly clear'. | 3 / 5 |
Total | 15 / 20 Passed |