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 highly actionable, well-sequenced operational guide with executable commands, explicit validation checkpoints, honest failure handling, and sharp dedup boundaries against sibling skills. The one real weakness is redundancy: the partial/forbidden/watermark semantics are restated in five different sections, inflating token cost without adding information.
Suggestions
State the 'partial → watermark does not advance → re-run' and 'forbidden → pivot to export-file lane' semantics once (e.g. in Troubleshooting) and reference them elsewhere instead of repeating them in First Sync, Contract, When it fails, and Anti-Patterns.
Consider moving the Contract section's guarantee list into a reference file (or merging it with When it fails / Anti-Patterns) to cut the body's token footprint while keeping the guarantees discoverable.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense with skill-specific detail rather than generic explanation, but the same guidance is repeated across sections — 'partial → watermark did not advance, re-run' appears in First Sync, Troubleshooting, Contract, When it fails, and Anti-Patterns, and the 'forbidden → export-file lane' pivot appears four times. | 3 / 5 |
Actionability | Copy-paste-ready commands cover every common case: 'gbrain connectors auth chatgpt --cookie -', 'gbrain connectors sync chatgpt --dry-run / --limit 5 / --full', 'gbrain conversation-parser scan conversations/chatgpt/<slug>', a host cron line, and an env-var escape hatch (GBRAIN_CONNECTOR_<PROVIDER>_COOKIE). | 5 / 5 |
Workflow Clarity | The batch-import workflow is clearly sequenced with explicit validation checkpoints and feedback loops: auth ends in a probe verdict, then dry-run → --limit 5 sample → 'conversation-parser scan' validation of one page → full backfill, with defined recovery for 'partial' (re-run, watermark holds), 'forbidden' (pivot lanes, never loop-retry), and health surfacing in 'gbrain doctor'. | 5 / 5 |
Progressive Disclosure | No bundle files exist, and all cross-references (conventions/, sibling SKILL.md files) are one level deep and clearly signaled with a conventions block up top; sections are well organized, though ~208 lines with the Contract and repeated troubleshooting content could be trimmed or split. | 4 / 5 |
Total | 17 / 20 Passed |