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 well-engineered operational skill body: executable commands with validation checkpoints, a well-structured reference bundle, and almost no filler. The residual costs are verbosity in caveat prose and long inlined prerequisites that belong in references.
Suggestions
Move the screenpipe source-build and LM Studio provisioning detail out of Prerequisites into a reference file (e.g., references/setup.md), keeping a one-line summary plus link in the body.
Tighten the dense multi-clause caveat sentences (e.g., the network-access blockquote) into short bullet points to cut token cost without losing the warnings.
Shorten or relocate the 'Citing Scientific Agent Skills' boilerplate to the repo-level contributing doc; it is not workflow-relevant for each invocation.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and operational — commands, config blocks, and pipeline steps — with essentially no explanation of concepts Claude already knows (screenpipe/LM Studio specifics are legitimately unfamiliar territory). A few long caveat sentences and the boilerplate citation section pad it slightly beyond the 5 anchor's 'every token earns its place'. Not 3: the extra length is operational specificity, not over-explanation. | 4 / 5 |
Actionability | Commands are copy-paste ready throughout: pinned `uv pip install httpx==0.28.1 pyyaml==6.0.3 sentence-transformers==6.1.0`, `lms load`/`lms server start`, and full `doctor`/`run`/`promote` invocations with concrete example timestamps and flags; config.yaml blocks give default and opt-in shapes. Honest caveats about illustrative examples do not undermine executability. Matches the 5 anchor. | 5 / 5 |
Workflow Clarity | Clear sequenced workflow — doctor preflight → run (six numbered internal steps) → review/dry-run → validate (`uv run skills-ref validate`, `--dry-run` checkpoint) → promote — with explicit validation checkpoints, non-zero exits with `error` markers, and refusal to overwrite on promote. This batch/staging skill includes the feedback loops the rubric requires, matching the 5 anchor. | 5 / 5 |
Progressive Disclosure | All three referenced files (references/api-contracts.md, references/https-proxy.md, references/screenpipe-config.yaml) exist as real, substantive one-level-deep references, clearly signaled inline, and the scripts/ bundle matches the architecture diagram. It falls short of the 5 anchor because the Prerequisites section inlines long setup detail (screenpipe source build, LM Studio provisioning) that could live in a reference, and the citation boilerplate sits inline. Not 3: references are clearly signaled and content is mostly well-placed. | 4 / 5 |
Total | 18 / 20 Passed |