Content
18%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 a boilerplate skeleton: every section either repeats the description or states circularly that the skill provides guidance, with no commands, examples, or workflow. It is well-sectioned but substantively empty, so the skill cannot actually be used from this file alone.
Suggestions
Replace the circular Instructions section with concrete, executable guidance: installation (e.g. `npm i -g vexor` or equivalent), indexing a directory, and 1-2 query examples with expected output.
Delete the verbatim Overview restatement and the "Use this skill when you need to work with..." sentence, which repeat the description without adding information.
If detailed usage exists, add a short workflow (index → query → review matches) and move extended material into a references/ file linked one level deep from the body.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is short but almost entirely padded: the Overview restates the frontmatter description verbatim, and "Use this skill when you need to work with vector-powered cli..." and "This skill provides guidance and patterns for..." are circular sentences that convey nothing new. This matches the anchor for noticeable verbosity with several unnecessary padded sections rather than lean, earning-its-place content. | 2 / 5 |
Actionability | There is no concrete guidance anywhere in the body — no CLI command, installation step, code example, or usage pattern; the only substance is a link to the source repository. This matches the anchor for entirely vague content that describes rather than instructs. | 1 / 5 |
Workflow Clarity | No steps or sequence of any kind are present, not even for the single task of running the CLI, so the simple-skill exception cannot apply — the one action is not unambiguous. This matches the anchor for steps missing and no validation, and nothing is present to justify level 2's rough sequence. | 1 / 5 |
Progressive Disclosure | The skill is under 50 lines with no bundle files (no references/, scripts/, or assets/ exist), and the body has clear sections (Overview, When to Use, Instructions) plus one clearly signaled external link, which per the guidelines can support a high score. It falls short of 5 because the Instructions section promises guidance that is not there, leaving a minor organization gap. | 4 / 5 |
Total | 8 / 20 Passed |