Content
87%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 concise and actionable with concrete tool-call signatures and a well-organized section structure. The main weakness is workflow_clarity: validation and error-recovery checkpoints are implicit rather than explicit.
Suggestions
Add an explicit validation/branching checkpoint in the workflow for when get_site returns no match or list_site_drives yields ambiguous candidates (e.g., 'if no site matches the hostname, ask the user to confirm the hostname before proceeding').
Specify the recovery loop for keyword search that returns too many results (e.g., 'if search(query="...") returns more than N hits, narrow by adding hostname/site_path and re-run') so the feedback path is explicit rather than implied.
Clarify the validation step when a browse result has zero children (e.g., confirm the folder_path is empty vs. mis-specified) to give the discovery loop a concrete retry condition.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Lean procedural guidance with no concept-explanation padding (no "what is SharePoint" filler); every line earns its place and assumes Claude's competence. | 3 / 3 |
Actionability | Gives concrete tool-call signatures with arguments—search(query="..."), search(query=None, hostname=..., site_path=..., folder_path=...), get_site(...), list_site_drives(...)—so Claude knows exactly which tool and parameters to invoke. | 3 / 3 |
Workflow Clarity | A clear six-step sequenced workflow is present, but validation/retry checkpoints are only implicit (e.g., what to do when get_site finds no match or a drive listing is ambiguous), which matches the "steps listed but checkpoints missing or implicit" anchor. | 2 / 3 |
Progressive Disclosure | No bundle files are needed; the body is under 50 lines and well-organized into Start Here, Workflow, Output Conventions, and Example Requests sections, satisfying the simple-skill exception for a top score. | 3 / 3 |
Total | 11 / 12 Passed |