Content
78%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 tight, operational runbook: exact config-resolution rules, concrete MCP tool parameters, and a well-sequenced workflow with sensible guardrails for a lightweight capture. It is uniformly strong, with only minor headroom — a populated example call and a write-failure path would close the last gaps.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and assumes competence — it spends its tokens on non-obvious operational rules (config precedence edge cases like "do not trim it, expand ~, or treat an empty value as unset", title truncation to ≤ 80 chars, default folder "bm-remember") rather than explaining concepts. A couple of parentheticals ("e.g. you were invoked because the user said 'remember that…'") could be trimmed, keeping it just below anchor 5. | 4 / 5 |
Actionability | Concrete, executable guidance: named tool calls (bm_project(command="list"), bm_write) with exact parameter mapping (tags = ["manual-capture"], directory = resolved rememberFolder, project routing including external_id UUIDs) and explicit defaults. It falls short of anchor 5 only because no fully-populated example bm_write call is shown. | 4 / 5 |
Workflow Clarity | A clear four-step sequence (Resolve config → Derive note → Write → Confirm) with meaningful checkpoints: the ask-one-question fallback when $ARGUMENTS is empty, the guard "Don't overwrite an existing note unless the user explicitly asks", and a one-line confirmation with permalink. Minor gap: no error-recovery path if the write itself fails, so it does not reach anchor 5. | 4 / 5 |
Progressive Disclosure | A self-contained, single-task skill (~55 compact lines) with well-organized Steps/Notes sections, no bundle files to disclose, and appropriate one-level pointers to sibling skills (bm-writing, bm-decide, bm-checkpoint) instead of inlining their content. Navigation is easy and nothing that belongs elsewhere is inlined. | 5 / 5 |
Total | 17 / 20 Passed |