Content
77%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 ingest procedure with explicit validation gates and failure handling — the workflow and command guidance are exemplary. The two weaknesses are redundancy (provenance and privacy rules each stated twice over) and a broken disclosure layer: the cited `references/pi-data-format.md` is missing from the bundle while its supposed content is inlined.
Suggestions
Merge the duplicated provenance guidance (the 'Add provenance markers' bullets, the 'Mark provenance' block, and verification-gate item 4) into one section, and fold the 'Privacy and Compliance' section into Step 2's 'Critical privacy filter' — this removes roughly 20 lines of repetition.
Create `references/pi-data-format.md` (or remove the citation): the body points to it for field-level parsing notes, but no `references/` directory exists in the bundle, leaving a dangling reference.
Move the entry-type table and message-role field breakdown into `references/pi-data-format.md`, keeping only the ranked data-source list inline in SKILL.md, so the overview stays lean and the detail lives one level deep.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly efficient — dense tables, concrete commands, no padding with concepts Claude already knows — but full sections are duplicated: provenance rules appear three times ("Add provenance markers using the convention in `llm-wiki`", the separate "**Mark provenance** per the convention in `llm-wiki`" block, and source-verification-gate item 4), and privacy rules are repeated between Step 2's "Critical privacy filter" and the standalone "Privacy and Compliance" section. Not 4: these are whole redundant sections, not minor trims; not 2: signal density stays high throughout with no tutorial-style explanation. | 3 / 5 |
Actionability | Copy-paste-ready commands with concrete arguments: `find "$PI_HISTORY_PATH" -name "*.jsonl" -type f`, `obsidian-wiki memory sync PI_HISTORY_INGEST sessions=<sessions> ... --takeaways "..."`, `${QMD_CLI:-qmd} update`; plus an exact manifest JSON block, specific field names (`parentId`, `session_info.name`), and a precise parsing algorithm (build id map, find leaf, walk parentId chain, reverse). Not 4: the specific commands and record formats cover the common cases end-to-end for this instruction-style skill. | 5 / 5 |
Workflow Clarity | Steps 1–5 are clearly sequenced with validation checkpoints and feedback loops for this batch operation: a delta summary before deep parsing, a manifest-driven new/modified/unchanged gate, an explicit five-item source verification gate with a recovery path ("If a claim cannot be verified, either delete it or mark it `^[inferred]` / `^[ambiguous]`"), and QMD failure handling ("If QMD refresh fails, do not roll back the vault changes; report the QMD status separately"). Not 4: both validation and error-recovery branches are explicit at multiple stages, satisfying the feedback-loop requirement for batch operations. | 5 / 5 |
Progressive Disclosure | References are clearly signaled ("See `references/pi-data-format.md` for field-level parsing notes", pointers to `llm-wiki/SKILL.md` and `.skills/llm-wiki/references/MEMORY.md`), but the bundle contains no `references/` directory at all — `references/pi-data-format.md` does not exist, so the promised field-level detail is unreachable. Meanwhile ~50 lines of field-level detail (the entry-type table and message-role breakdown) that would belong in that file are inlined in SKILL.md. Not 4: the one file-level reference is dangling; not 2: section structure is good and references are prominently signaled rather than buried. | 3 / 5 |
Total | 16 / 20 Passed |