Content
58%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 admirably lean and well-organized for its size, but it functions as a command cheat-sheet rather than an operational skill: none of the four advertised operations has executable steps, and the document-feeding workflow has no sequence or validation. Adding concrete API call examples for search and a feed-then-verify workflow would address the two weak dimensions.
Suggestions
Add an executable example for the core search operation, e.g. the actual HTTP request against http://127.0.0.1:8001 (endpoint path, method, and response format), so actionability reaches concrete, copy-paste-ready guidance.
Document the 投喂 (document feeding) workflow as a numbered sequence with a validation step (e.g., verify document count via 知识库统计 after feeding), since batch ingestion without validation caps workflow clarity at 3.
Specify what '切换到本地知识库' / '切换到 AnythingLLM' actually do operationally (persisted setting, per-session flag, or API call) so mode switching is unambiguous.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is ~20 lines with zero padding: a four-row command table and two concrete location facts ("E:/knowledge-base", "http://127.0.0.1:8001"), with no explanations of concepts Claude already knows. It matches the 'lean and efficient; every token earns its place' anchor, and there is nothing to trim that would push it toward 4. | 5 / 5 |
Actionability | The body maps user phrases to intents ("查一下 xxx" → 搜索知识库) and gives a root path and API base URL, but provides no executable guidance for any operation — no API endpoint or request format for searching, no command or script for switching modes or feeding documents. This matches 'minimal concrete guidance; high-level hints but missing the specific steps to execute'; it is above 1 because the paths, URL, and exact command phrases are concrete, and below 3 because even pseudocode-level steps for the core actions are absent. | 2 / 5 |
Workflow Clarity | No sequence exists for any operation: how a search is executed against the API, what document feeding (投喂) involves, or how mode switching takes effect is entirely unspecified, matching 'rough sequence present but many gaps; validation absent' (here the gaps swallow the sequence). It is not 1 because the command table does establish an unambiguous intent-to-action mapping for the simple lookup case, and the simple-skill exception to score 5 does not apply because the core actions are not unambiguous; the batch-like feeding operation also lacks any validation, which would cap this at 3 regardless. | 2 / 5 |
Progressive Disclosure | This is a skill under 50 lines with no bundle files (references/, scripts/, assets/ do not exist) and no need for external references, and the body is organized into two well-labeled sections (使用方法, 文件位置), which per the rubric's simple-skill guidance earns a 5. There are no buried or nested references to penalize, and no inlined content that belongs in a separate file. | 5 / 5 |
Total | 14 / 20 Passed |