Content
77%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
A highly actionable, well-sequenced routing skill with strong workflow gates, weakened mainly by motivational verbosity and by routing-table links that point to bundle files absent from this package. The lowest dimensions are conciseness and progressive_disclosure.
Suggestions
Trim the hortatory/rationale passages in Section 2 ("STOP", "This is not optional", "distilled from hundreds of real runs...") to short imperatives; Claude already understands why reading docs helps.
Either include the referenced files (finding-companies-and-contacts.md, enriching-and-researching.md, writing-outreach.md, prompts.json, recipes/*.md, provider-playbooks/*.md) or relink the routing table to the files that do exist under references/ and scripts/.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The bulk is lean operational guidance (commands, tables, checklists), but several passages over-explain rationale Claude already grasps — e.g. "distilled from hundreds of real runs... reading a doc for 5 seconds saves you from 10 failed tool calls" and repeated hortatory "STOP / This is not optional" blocks that could be trimmed. | 2 / 3 |
Actionability | Throughout it gives concrete, copy-paste-ready commands with flags — `deepline csv show --csv <path> --summary`, `deepline enrich --rows 0:1`, `deepline billing balance`, plus a full approval message template and working-directory setup. | 3 / 3 |
Workflow Clarity | Clear sequence with explicit checkpoints: one-row pilot, a strict four-section approval gate with AWAIT_APPROVAL/FULL_RUN states, a feedback loop (pilot fails -> fix and re-run), then full run, final file/playground check, and end-of-session consent. | 3 / 3 |
Progressive Disclosure | The documentation hierarchy and task->doc routing table are well signaled and mostly one level deep, but the referenced files (finding-companies-and-contacts.md, enriching-and-researching.md, writing-outreach.md, prompts.json, recipes/, provider-playbooks/) are not present in this bundle — only references/ and scripts/ exist and go unreferenced — so navigation points to a structure that isn't there. | 2 / 3 |
Total | 10 / 12 Passed |