CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

weknora-shared

Use when driving a WeKnora RAG server through the `weknora` CLI as an agent — authenticating, managing knowledge bases / documents / sessions / agents, running search or chat, or interpreting the CLI's JSON envelopes and exit codes. Read this before any other weknora-* skill.

Quality

91%

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.

This is a high-quality reference skill: it documents a machine-readable contract (typed exits, JSON envelopes, confirmation gates) with fully executable commands and explicit validation and recovery loops for every risky path. The main improvement levers are trimming the couple of cross-section repetitions and making the offloaded chat-vs-search decision table available within the bundle.

Suggestions

State the `auth token` raw-token default once (§3's output-contract exception is the natural home) instead of twice in §1 and §3.

Ship the chat-vs-session-ask-vs-search decision table (or a bundle reference file backing the `weknora-rag-search` pointer) so readers of this skill alone can resolve the CLI's most common confusion.

Condense the §7a tool-approval exit-10 note to a single cross-reference to §5 rather than restating the rule.

DimensionReasoningScore

Conciseness

The body is dense and almost entirely non-obvious CLI-specific contract (exit-code semantics, typed error codes, batch envelope shapes) with essentially no filler Claude would already know. It misses the 5 anchor because of small redundancies — the `auth token` raw-token exception is stated in §1 and repeated as an exception in §3, and the exit-10 approval rule is restated in §7a — but is well above the 3 anchor's 'some unnecessary explanation'.

4 / 5

Actionability

Every section is copy-paste ready: concrete command lines ("weknora profile add prod --host https://kb.example.com --use", "echo \"$WEKNORA_API_KEY\" | weknora auth login --with-token"), an exit-code table with per-code agent actions, a realistic JSON error envelope, and a working chaining example (KB=$(weknora kb create ... --jq '.data.id')). This matches the fully-executable anchor.

5 / 5

Workflow Clarity

Multi-step processes are explicitly sequenced with validation checkpoints: the auth section marks order as 'do this first — order matters', verifies with `auth status`, uses `kb status`/`kb check` for `retrieval_ready`, prescribes `--dry-run` before mutations, and defines exit-code-driven recovery (re-auth on exit 3, backoff on 6/7, user approval on exit 10) plus batch failure inspection. Destructive and batch operations all have feedback loops, satisfying the cap.

5 / 5

Progressive Disclosure

With no bundle files present, the single-file organization is strong: numbered, well-labeled sections (auth, KB selection, output contract, exit codes, destructive writes, chaining, command map, self-help) plus a 'Common mistakes' table make navigation easy, and the one deep-dive (chat vs session ask vs search) is deliberately offloaded to a sibling skill. It falls short of 5 because the pointer targets `weknora-rag-search` outside this bundle, so the decision table is not actually reachable from what ships here, and some detail (e.g., the full per-resource command map) is inline rather than split out.

4 / 5

Total

18

/

20

Passed

Description

92%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 strong, well-targeted description: it names the product and CLI, lists the full set of operations, gives an explicit 'Use when' trigger, and states its precedence over sibling skills. The only weakness is slightly thin synonym coverage of natural user phrasings (e.g., upload/retrieve/query wording).

DimensionReasoningScore

Specificity

The description enumerates multiple concrete capability areas — "authenticating, managing knowledge bases / documents / sessions / agents, running search or chat, or interpreting the CLI's JSON envelopes and exit codes" — each tied to specific actions on a named tool. It sits firmly at the comprehensive anchor rather than 4, since the action list covers the CLI's full surface with no significant gaps.

5 / 5

Completeness

It opens with an explicit trigger clause — "Use when driving a WeKnora RAG server through the `weknora` CLI as an agent" — and pairs it with a clear statement of what the skill covers, plus ordering guidance ("Read this before any other weknora-* skill"). Both what and when are explicit with concrete trigger phrases, matching the 5 anchor exactly.

5 / 5

Trigger Term Quality

Natural trigger phrases are present and varied: "WeKnora RAG server", "weknora CLI", "knowledge bases", "documents", "sessions", "search or chat", "authenticating". It falls short of the 5 anchor because common user phrasings like "upload", "retrieval", "query", or product-file synonyms are absent, though coverage is well beyond the 3 anchor's 'some relevant keywords'.

4 / 5

Distinctiveness Conflict Risk

The niche is unambiguous: it is scoped to the named WeKnora product and its `weknora` CLI, and explicitly positions itself as the base for the `weknora-*` family. Product- and tool-specific triggers make conflict with unrelated skills minimal, matching the clear-niche anchor.

5 / 5

Total

19

/

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-shared/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.