Content
75%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 well-structured, largely executable overview with a clearly sequenced multi-step pipeline and validation checkpoints, supported by real bundle files for the detail it delegates. Its main weaknesses are a missing config.yaml artifact (hurts actionability and navigation) and slightly over-explained install/citation passages.
Suggestions
Ship the referenced config.yaml inside the bundle (or point the examples at references/screenpipe-config.yaml) so the run/doctor commands are fully copy-paste-ready and no referenced path dangles.
Trim the screenpipe from-source build walkthrough and the citation block to the essentials, or move them into a references/ file to keep SKILL.md a lean overview.
Add an explicit fix-and-retry feedback loop after the doctor step (e.g., 'if any check is `error`, resolve the listed item and re-run doctor') to close the workflow-clarity gap.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly efficient with lean, copy-paste command blocks and an architecture diagram rather than padded prose, but a few sections (detailed screenpipe-from-source install steps, the citation block) are over-explanation relative to the core task; not 5 because of these trimmable passages, not 3 because the bulk is genuinely lean. | 4 / 5 |
Actionability | Provides concrete executable commands throughout (export token, cargo build, lms load, the autoskill.py run/doctor/promote invocations) and a step-by-step internal pipeline, but the repeatedly-referenced config.yaml is absent from the bundle, leaving a gap in fully copy-paste-ready execution; not 5 because of that missing artifact, not 3 because guidance is largely executable. | 4 / 5 |
Workflow Clarity | The fetch→redact→cluster→match→synthesize→report pipeline is clearly sequenced with a doctor preflight and a --dry-run/--plan gate before the LLM call, and promote refuses overwrite; not 5 because explicit error-recovery feedback loops (fix-and-retry on doctor failure) are implicit rather than spelled out. | 4 / 5 |
Progressive Disclosure | SKILL.md functions as an overview delegating detail to one-level-deep, clearly signaled bundle files (references/https-proxy.md, references/screenpipe-config.yaml, scripts/*.py) with well-organized sections; not 5 because config.yaml and tests/autoskill are referenced but not present in the bundle, leaving dangling navigation targets. | 4 / 5 |
Total | 16 / 20 Passed |