CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

weknora-rag-search

Use when retrieving from or asking questions against a WeKnora knowledge base via the `weknora` CLI — and especially when unsure whether to use `chat`, `session ask`, or `search chunks` for a given goal.

Quality

86%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

88%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A lean, highly actionable routing skill: a decision table, three prioritized decisions, real error codes with remediation, and executable examples covering the common cases. The only structural gap is the un-linked references/chat.md, which orphans half the bundle.

DimensionReasoningScore

Conciseness

A tight decision table plus targeted gotchas; it assumes competence and never explains what RAG or a knowledge base is. Minor trim opportunities: the cell 'adds citations; `--verbose` adds execution detail' is repeated verbatim in two table rows, and the streaming/stop guidance partially duplicates references/chat.md.

4 / 5

Actionability

Every example is copy-paste-ready with real flags ('--kb engineering --limit 12', '--format text', '--session sess_abc', '--agent ag_123'), and the table gives the exact command shape for all six goals with their return types.

5 / 5

Workflow Clarity

The decision workflow is clearly sequenced — goal table, then the three decisions in priority order, then KB resolution and session continuation — with explicit error feedback: exit-1 codes ('local.kb_id_required', 'local.kb_not_found') paired with remediation ('weknora kb list' / 'search kb'), and stall recovery via server-side 'session stop'. Not anchor 4 because the checkpoints and recovery loops are present, not implicit.

5 / 5

Progressive Disclosure

Detail is appropriately split one level deep and 'references/search-chunks.md' is clearly signaled ('Details: references/search-chunks.md'). However the bundle's references/chat.md — which holds the event-stream vocabulary and session stop/resume mechanics the body alludes to — is never linked from the body, leaving it undiscoverable from the main file.

4 / 5

Total

18

/

20

Passed

Description

78%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A distinctive, well-triggered description that names the domain, CLI, and the three key commands. Its main weakness is that the 'what' is implicit — it describes when to use the skill and which commands to disambiguate, but not what those commands do.

Suggestions

Add a brief 'what' clause stating the skill's capabilities, e.g. 'Grounded Q&A over KB documents, raw chunk retrieval, and keyword/document/KB/session lookup'.

Include common synonyms users would naturally say — 'RAG', 'query the knowledge base', 'semantic search' — alongside the command names.

State in one phrase what each of `chat`, `session ask`, and `search chunks` returns (answer vs. ranked chunks) so the description is self-contained without reading the body.

DimensionReasoningScore

Specificity

Names the domain (WeKnora knowledge base), the interface (`weknora` CLI), and the concrete commands (`chat`, `session ask`, `search chunks`), so several specific actions are listed. It falls short of 5 because it routes among commands without stating what each command actually does or returns.

4 / 5

Completeness

The 'when' is explicit and trigger-anchored ('Use when retrieving from or asking questions against a WeKnora knowledge base via the `weknora` CLI'), but the 'what' is only implied — the skill's actual capabilities (command selection, KB resolution, session continuation) are never stated, only the command names for disambiguation. Clearer than anchor 3 because 'when' is explicit; not anchor 5 because 'what' lacks concrete capability statements.

4 / 5

Trigger Term Quality

Includes natural phrases users would say — 'retrieving from', 'asking questions against', 'knowledge base', 'chat', 'search chunks'. Missing common synonyms like 'RAG', 'query', 'semantic search', or 'ask the knowledge base', so a few natural terms are absent.

4 / 5

Distinctiveness Conflict Risk

The product-specific names ('WeKnora', '`weknora` CLI', 'knowledge base', exact subcommands) create a clear niche with distinct triggers; minimal risk of firing for the wrong skill.

5 / 5

Total

17

/

20

Passed

Validation

93%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_version

'metadata.version' is missing

Warning

Total

15

/

16

Passed

Repository

Tencent/WeKnora

Path

cli/skills/weknora-rag-search/SKILL.md

Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.