Content
81%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.
A well-structured, actionable skill body: the five-phase workflow is explicitly sequenced and validated, commands and templates are concrete, and pitfalls/anti-patterns are specific rather than generic. Remaining gaps are modest — some duplicated error-handling guidance, slightly vague fetch instructions in Phase 1, and externally referenced files that are not part of this bundle.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Dense, high-signal body with tables, a phase structure, and no explanations of concepts Claude already knows. Minor trim opportunities: the retry policy and '[transcript unavailable]' handling are each stated twice (Error Handling vs. When it fails), and the anti-pattern note about sanctioned synthesis output is convoluted. | 4 / 5 |
Actionability | Concrete commands ('gbrain files upload-raw <file> --page <slug>', 'gbrain sync'), a complete page template, a numbered 4-step entity loop, and an exact output message. Falls short of fully copy-paste-ready because Phase 1 fetch actions remain high-level ('Fetch transcript (Whisper, transcription service, or captions)') with no concrete command per format. | 4 / 5 |
Workflow Clarity | Five clearly sequenced phases with explicit validation checkpoints: duplicate detection before page creation (search by source URL/hash), the OCR <80%-readable quality gate, retry-once on transient API failures, and the 'NOT fully ingested until entity propagation is complete' completion criterion. The destructive/batch cap does not apply since validation is present. | 5 / 5 |
Progressive Disclosure | Well-organized sections with clearly signaled, one-level-deep references ('Read skills/_brain-filing-rules.md before creating any new page', 'See skills/conventions/quality.md'). However, no bundle files exist to verify these targets, the path styles are inconsistent ('skills/...' vs '../conventions/...'), and the Error Handling / When it fails content overlaps. | 4 / 5 |
Total | 17 / 20 Passed |