Content
92%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 dense, executable, well-gated skill body: copy-paste-ready code for every retriever type, explicit ONLINE-gate validation with polling, an error-to-fix feedback table, and a verification checklist. Deductions are minor — a duplicated security note, changelog-style version trivia, and cosmetic sequencing glitches (step numbering begins at 'Step 2', one misplaced paragraph).
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and code-first: no concept explanations, dense tables, and terse version notes ('Auto-injected variables: node (matched node) score (similarity float)'). Minor over-explanation and duplication could be trimmed — the Text2Cypher EXPLAIN guard is stated twice ('Security (v1.16.0+): Every LLM-generated Cypher is run through EXPLAIN first' and again as 'Destructive-query guard [v1.16+]'), and the dense component-import/pipeline-DSL version notes read like changelog entries — so this is efficient with minor instances of over-explanation rather than the every-token-earns-its-place anchor 5. | 4 / 5 |
Actionability | The core pattern is complete and copy-paste ready (full imports, driver, embedder, retrieval_query, GraphRAG wiring, search call), and every subsequent section adds executable code: install extras commands, index-creation Cypher, filters with the full operator list, query_params, custom RagTemplate, and a Common Errors table mapping each error to a concrete fix. Specific examples cover the common cases, matching anchor 5. | 5 / 5 |
Workflow Clarity | The workflow is explicitly sequenced (Install → Choose Retriever → Create Indexes → Core Pattern → Verification) with real validation checkpoints and feedback loops: 'Confirm ONLINE before ingesting… Do NOT start ingestion until ONLINE' with 5-second polling, an error-recovery table keyed by exact exception messages, and a final Verification Checklist. The only blemishes are cosmetic (numbering starts at 'Step 2', and a schema-trimming note sits oddly under ORDER BY), which does not rise to the 'minor validation gaps' of anchor 4. | 5 / 5 |
Progressive Disclosure | The body acts as an overview with well-signaled, one-level-deep references: all five linked files exist in references/ (retrievers.md, providers.md, pipeline-dsl.md, kg-builder.md, knowledge-graph-construction.md), each link states what it contains and is placed at the relevant section ('Full API → [references/pipeline-dsl.md]'), and the reference files link only back to SKILL.md — no nesting. Content is appropriately split between inline essentials and on-demand detail, matching anchor 5. | 5 / 5 |
Total | 19 / 20 Passed |