Content
85%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
The body is a lean, well-structured workflow with explicit verification and error-recovery steps, scoring well on conciseness, workflow clarity, and progressive disclosure; its only weak spot is actionability, where the generation step lacks a concrete example script.
Suggestions
Add a minimal example generation script body (e.g., a short python-pptx script) so the generation step is copy-paste ready rather than described.
Replace the placeholder "cp /path/to/nested/file.pptx ./" with a find-driven pipeline (e.g., cp $(find . -type f -name "*.pptx" | head -1) ./) to make retrieval directly executable.
Tighten the error-recovery hint into an explicit validate->retry loop (re-run find, fall back to stderr inspection, then re-copy).
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and does not pad with concepts Claude already knows (no "what is a PDF" exposition); each section (Objective, When to Use, Procedure, Best Practices) earns its place and assumes Claude's competence. | 3 / 3 |
Actionability | The locate/retrieve steps give executable, copy-paste-ready commands (find . -type f -name "*.pptx", find ... -mmin -10), but the core generation step only says to "write a script" with no example script body, and the cp example uses a placeholder path, leaving guidance incomplete. | 2 / 3 |
Workflow Clarity | A clear four-step sequence (Attempt Generation -> Locate -> Retrieve -> Verification) with explicit checkpoints ("verify the file exists and is non-zero size", "Confirm the file opens correctly") and an error-recovery path (check stderr if not found); validation is present so no destructive-operation cap applies. | 3 / 3 |
Progressive Disclosure | At ~50 lines with no bundle files and no need for external references, the well-organized sections satisfy the rubric's allowance for simple skills to score 3 on progressive disclosure. | 3 / 3 |
Total | 11 / 12 Passed |