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.
The body is well-engineered: executable commands, a validated multi-step workflow with preflight and dry-run gates, and clean one-level-deep references to real bundle files. Its only mild weakness is a few paragraphs that restate the description's privacy/network points, adding modest token overhead.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and mostly efficient — architecture diagrams, inline config snippets, and numbered pipeline steps earn their tokens — but a few spots over-explain (e.g. the privacy/network blockquote and the 'Composition with other skills' section partly restate the description), keeping it just shy of lean. | 4 / 5 |
Actionability | Copy-paste-ready commands abound — `python scripts/autoskill.py doctor/run/promote` invocations, `pipenv install ...`, `lms load ...`, `export SCREENPIPE_TOKEN=$(screenpipe auth token)` — and the internal pipeline enumerates concrete functions with default thresholds; the common cases are fully covered. | 5 / 5 |
Workflow Clarity | A clear numbered pipeline (Fetch→Redact→Cluster→Match→Synthesize→Report) with a `doctor` preflight checkpoint, a `--dry-run`/`--plan` inspection gate, and a `promote` step that refuses to overwrite existing skills — explicit validation steps and a feedback loop for destructive/batch promotion. | 5 / 5 |
Progressive Disclosure | The SKILL.md is an overview that signals one-level-deep references to real bundle files (`references/screenpipe-config.yaml`, `references/https-proxy.md`) and the `scripts/` directory with a per-file architecture map; no nested/deep references and the config detail lives in `config.yaml` rather than inlined. | 5 / 5 |
Total | 19 / 20 Passed |