Content
88%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 lean, highly actionable routing skill: a decision table, three prioritized decisions, real error codes with remediation, and executable examples covering the common cases. The only structural gap is the un-linked references/chat.md, which orphans half the bundle.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | A tight decision table plus targeted gotchas; it assumes competence and never explains what RAG or a knowledge base is. Minor trim opportunities: the cell 'adds citations; `--verbose` adds execution detail' is repeated verbatim in two table rows, and the streaming/stop guidance partially duplicates references/chat.md. | 4 / 5 |
Actionability | Every example is copy-paste-ready with real flags ('--kb engineering --limit 12', '--format text', '--session sess_abc', '--agent ag_123'), and the table gives the exact command shape for all six goals with their return types. | 5 / 5 |
Workflow Clarity | The decision workflow is clearly sequenced — goal table, then the three decisions in priority order, then KB resolution and session continuation — with explicit error feedback: exit-1 codes ('local.kb_id_required', 'local.kb_not_found') paired with remediation ('weknora kb list' / 'search kb'), and stall recovery via server-side 'session stop'. Not anchor 4 because the checkpoints and recovery loops are present, not implicit. | 5 / 5 |
Progressive Disclosure | Detail is appropriately split one level deep and 'references/search-chunks.md' is clearly signaled ('Details: references/search-chunks.md'). However the bundle's references/chat.md — which holds the event-stream vocabulary and session stop/resume mechanics the body alludes to — is never linked from the body, leaving it undiscoverable from the main file. | 4 / 5 |
Total | 18 / 20 Passed |