Content
70%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 well-sequenced, highly actionable orchestration guide: every phase has concrete commands, consent gates, quality checks, an error-recovery protocol, and a resume path — workflow clarity is genuinely excellent. The weaknesses are token efficiency (the credential-safety message and ClawVisor marketing are repeated well past their first statement) and the total absence of progressive disclosure: all eight phases plus the gateway setup live inline in one long SKILL.md with no reference files.
Suggestions
State the 'agent never holds raw OAuth tokens' rule once in the Contract section and have the Phase 0 blockquote, the declined-ClawVisor section, and the Anti-Patterns entry reference it in one line each — this removes roughly a page of repetition.
Move the ClawVisor setup walkthrough (benefits list, dashboard steps, env-var exports, scoping rule) into a references/clawvisor-setup.md and keep a 5-line summary plus the harness check in SKILL.md; similarly split per-phase processing details (e.g., references/takeout-imports.md) so the main file is an overview.
Make the default Google Takeout path as concrete as the CLI path: provide the actual CSV/ICS/mbox parsing commands or a small script instead of 'Parse the CSV'/'file them into the brain structure below', since Takeout is the documented default on non-ClawVisor harnesses.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The bulk is operational (commands, tables, rules) with no explanation of concepts Claude already knows, but the same credential-safety point is repeated at least four times ("The agent never holds raw OAuth tokens or API keys", the Phase 0 safety-boundary blockquote, the 'If the user declines ClawVisor' section, and the Anti-Patterns entry), and the promotional 'What ClawVisor gives you' bullet list plus a twice-stated harness qualification add padding. Mostly efficient but could be tightened — anchor 3; not 2 because the majority of sections earn their tokens. | 3 / 5 |
Actionability | Mostly executable guidance: a runnable discovery script, concrete commands ("gbrain import /path/to/vault --no-embed --workers 4", "gbrain whois <email or name> --json"), a state-file schema, and an output-format template. Minor gaps: the ClawVisor snippets are explicitly labeled pseudo-code ("pseudo-code" is an acceptable, justified flexibility), and Phases 2 (Takeout) and 5-6 say 'Parse the CSV' / 'Process' without a command or script, leaving the Takeout path less concrete. | 4 / 5 |
Workflow Clarity | The eight phases are clearly sequenced with a priority-stack table, and validation is explicit throughout: a quality gate after 5 contacts ("pause and show the user a sample page"), verification commands ("gbrain doctor --json", "gbrain stats", test retrieval queries), a manifest review before archive ingestion, consent gates per phase, a resume protocol keyed off cold-start-state.json, and a 'When it fails' section with error-recovery feedback loops (follow the credential error's fix; check doctor before declaring an import failed). This matches anchor 5's 'explicit validation steps; feedback loops for error recovery; checklists' — the batch-operation cap does not apply since validation is present. | 5 / 5 |
Progressive Disclosure | The body is a single ~530-line monolith with good in-file headers but no bundle files at all — no references/, scripts/, or assets/ exist — and content that would serve better as separate files is inlined (the full ClawVisor setup guide, the per-phase processing rules). External references are clearly signaled ("skills/google-loops/SKILL.md", "docs/guides/company-brain-ingestion.md", "../conventions/agent-operator-protocol.md") but unverifiable here; anchor 3 ('some structure; content that should be separate is inline') fits — not 4 because nothing is actually split out, not 2 because section structure and navigation within the file are clear and references are not buried. | 3 / 5 |
Total | 15 / 20 Passed |