Content
71%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 high-quality reference skill: exceptionally concrete and copy-paste ready, with strong verify-before-citing discipline. Its weaknesses are redundancy (the NAMS warning and version-verification guidance repeated across sections, plus two overlapping checklists) and a fully monolithic structure with no progressive disclosure despite content that would split naturally into reference files.
Suggestions
Merge the 'Quick Authoritative-Facts Checklist' and the final 'Checklist' into a single pre-publish checklist, and state the NAMS early-access and verify-PyPI warnings once each — the repetition costs tokens without adding information.
Split stable, detail-heavy sections (Hosted Service/NAMS, Canonical Examples, Positioning Language, framework integration tables) into references/ files with one-level-deep links from SKILL.md, keeping the body as a navigable overview.
Consolidate the scattered verification guidance into one explicit draft → verify (PyPI / live NAMS + OpenAPI) → publish workflow so the checkpoints form a single sequence instead of repeated inline warnings.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and fact-only (no explanations of concepts Claude already knows), but it is noticeably tightable: the NAMS early-access warning appears four times (the intro callout, the NAMS section, correction #7, and both checklists), 'verify PyPI' is repeated five times, and the 'Quick Authoritative-Facts Checklist' and final 'Checklist' sections substantially duplicate each other. Inline time-sensitive values ('0.7.0 (2026-10-07)') sit outside any 'old patterns'/'deprecated' section, further taxing the token budget. This fits the 3 anchor (mostly efficient but could be tightened) better than 4, whose over-explanation would be only minor. | 3 / 5 |
Actionability | Guidance is fully executable and copy-paste ready: a complete async quickstart ('async with MemoryClient(settings) as memory:'), one-liner 'uvx "neo4j-agent-memory[mcp]" mcp serve --password <neo4j-password>', 'claude mcp add' registration commands, Claude Desktop JSON configs, exact import paths ('neo4j_agent_memory.integrations.<framework>'), the full extras list, exact hex color codes, and upstream example URLs. The single '...' placeholder in the OpenAI Agents table row is the only gap and the common cases are fully covered — the 5 anchor, not the 4 anchor's 'minor gaps'. | 5 / 5 |
Workflow Clarity | The reference task itself is unambiguous and carries real validation checkpoints — 'Verify authoritative state before writing' pointing to PyPI and the GitHub README, 're-check the live site and the OpenAPI spec' for NAMS, and pre-publish checklists. It lands at 4 rather than 5 because there is no sequenced workflow for the authoring tasks the skill supports (draft → verify → publish), the duplicated checklists blur which one governs, and the checkpoint guidance is repeated across sections instead of consolidated into one loop. | 4 / 5 |
Progressive Disclosure | There are no bundle files at all (no references/, scripts/, or assets/), so ~413 lines of content sit in a single monolithic SKILL.md. Section headers and tables make it navigable (above the 2 anchor), but content that clearly belongs in separate reference files — NAMS details, the canonical-examples catalog, positioning language, the framework integration table — is inlined, and there are no well-signaled one-level-deep references to reward. This matches the 3 anchor; the 4 anchor's 'references mostly clear' cannot apply when no references exist. | 3 / 5 |
Total | 15 / 20 Passed |