Content
82%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 highly actionable with complete CLI commands and a well-sequenced connection workflow that includes state-check feedback loops. Its main weakness is mild over-explanation in the intro and best-practices prose that could be trimmed.
Suggestions
Trim the introductory paragraph ('Think of it as a central repository for FAQs, tutorials, and guides') since Claude can infer NeetoKB's purpose from the domain.
Tighten the Best practices bullets by dropping justification clauses (e.g. 'This will burn less tokens and make communication more secure').
Reconcile the step numbering — label the connection step as 'Step 1' so the 'skip to Step 2' reference is unambiguous, and merge the redundant 'Popular actions' section into 'Searching for actions'.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly executable commands, flags, and a compact options table with little padding. The one-paragraph intro ('NeetoKB is a knowledge base software... Think of it as a central repository...') and a few best-practice asides ('burn less tokens', 'make communication more secure') are minor over-explanation that could be trimmed, fitting the 'efficient; minor instances of over-explanation' anchor rather than the fully lean level 5. | 4 / 5 |
Actionability | Provides copy-paste-ready, complete bash commands for every step (install, login, connection ensure/get, action list/run, request) with real flags and a worked JSON-input example. Specific examples cover the common cases, matching the 'fully executable; copy-paste ready' anchor. | 5 / 5 |
Workflow Clarity | The connect-to-NeetoKB flow is clearly sequenced with explicit state checkpoints (READY/BUILDING/CLIENT_ACTION_REQUIRED/CONFIGURATION_ERROR) and a polling feedback loop until state changes. Minor gaps — an unlabeled 'Step 1' referenced via 'skip to Step 2' and a slightly redundant 'Popular actions' section — keep it just below the level-5 anchor with full feedback loops and checklists. | 4 / 5 |
Progressive Disclosure | No bundle files exist and the single SKILL.md is organized into clear, navigable sections (Overview, Working with NeetoKB, Searching, Running actions, Proxy, Best practices) with no nested references. At ~158 lines it exceeds the simple-skill 50-line threshold, so it lands at 'good structure; well-placed content' rather than the level-5 simple-skill exception. | 4 / 5 |
Total | 17 / 20 Passed |