CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

knowledge-wiki

Manage the personal knowledge wiki. Use when the user shares articles, documents, or asks to organize knowledge; when a conversation produces insights worth preserving as structured knowledge; or when the user asks about the knowledge base.

Quality

81%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

SKILL.md
Quality
Evals
Security

Quality

Content

93%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.

The body is an exemplary instruction-only skill: lean, concrete, and fully templated so every operation can be executed without guesswork. The only minor gap is the absence of an explicit post-change verification step in the ingest/synthesize workflows.

DimensionReasoningScore

Conciseness

The body is lean and assumes Claude's competence: no explanations of what a wiki or markdown is, every section (operations, page format, index format, log format, guidelines) carries actionable content. It matches 'Lean and efficient; every token earns its place'.

5 / 5

Actionability

Concrete file paths ('knowledge/<category>/<slug>.md'), copy-paste-ready markdown templates for pages, index, and log, and a numbered procedure per operation. For an instruction-only skill this is fully executable guidance covering the common cases, matching the anchor-5 example.

5 / 5

Workflow Clarity

All three operations (Ingest, Synthesize, Query) are clearly sequenced with numbered steps, and 'Only link to pages that already exist' acts as a guardrail. No explicit validation checkpoint after index/log updates keeps it at anchor 4 rather than 5; operations are non-destructive file creation, so the destructive/batch cap at 3 does not apply.

4 / 5

Progressive Disclosure

The ~88-line body is well-organized into sections with all templates appropriately inlined (each is short and belongs in SKILL.md), no nested references, and no bundle files that should be split out. Structure matches the well-organized, easy-navigation anchor.

5 / 5

Total

19

/

20

Passed

Description

65%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.

The description has strong, explicit 'Use when...' trigger coverage and names a distinct niche, but the capability statement itself is a single generic verb ('Manage') that undersells the skill's concrete operations. It reads as trigger-heavy and action-light.

Suggestions

Replace 'Manage the personal knowledge wiki' with the concrete operations: e.g. 'Ingest articles and documents into structured knowledge pages, synthesize conversation insights into the wiki, and query the knowledge base with cited page links.'

Add natural trigger synonyms users would actually say — 'wiki', 'notes', 'note-taking', 'save this', 'remember this' — to broaden keyword coverage.

Narrow the 'when the user shares articles, documents' trigger (e.g. 'shares articles or documents to file away') to reduce overlap with general document-processing skills.

DimensionReasoningScore

Specificity

The only stated action is the generic 'Manage the personal knowledge wiki', matching 'Names the domain but actions are minimal or generic'. Concrete operations (ingest articles, synthesize insights, query the base) are never named, so it does not reach anchor 3's '1-2 concrete actions'.

2 / 5

Completeness

Both parts are present: a 'what' ('Manage the personal knowledge wiki') and an explicit multi-clause 'Use when...' with concrete trigger phrases. It falls short of anchor 5 because the 'what' is generic rather than concrete, exactly matching anchor 4's 'when'/'what' could be more specific.

4 / 5

Trigger Term Quality

Natural phrases like 'shares articles, documents', 'organize knowledge', 'knowledge base', and 'structured knowledge' give good coverage, but common synonyms users would say ('wiki', 'notes', 'save this', 'remember this') are missing. Anchor 4 ('good keyword coverage; a few natural terms missing') is the closest fit.

4 / 5

Distinctiveness Conflict Risk

'Personal knowledge wiki' is a clear niche with distinct triggers, but the broad trigger 'when the user shares articles, documents' overlaps with general document-handling skills. This matches 'Mostly distinct; minor overlap risk with closely related skills' rather than anchor 5's minimal conflict risk.

4 / 5

Total

14

/

20

Passed

Validation

81%

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

Validation — 13 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_version

'metadata.version' is missing

Warning

metadata_field

'metadata' should map string keys to string values

Warning

relative_links

Relative link issues: 4 missing, 1 deeper-than-1-level, 3 suspicious

Warning

Total

13

/

16

Passed

Repository

zhayujie/CowAgent

Path

skills/knowledge-wiki/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.