CtrlK
BlogDocsLog inGet started
Tessl Logo

kb-research

Structured approach to finding and synthesizing information from the user's knowledge base

56

Quality

65%

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

Fix and improve this skill with Tessl

tessl review fix ./surfsense_backend/app/agents/chat/multi_agent_chat/main_agent/skills/builtin/kb-research/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

86%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 tight, well-structured instruction skill: lean prose, concrete numbers and tool names, a clear plan, and an anti-fabrication output guard. The only meaningful gap is that the central action — the KB search itself — is never tied to a specific tool or command, and there is no verification step for citations.

DimensionReasoningScore

Conciseness

The body is lean and instruction-dense with zero padding: every line tells Claude something it could not infer ('run **one** targeted KB search', 'focused on terms the user would have written, not synonyms', 'never write a chunk id, URL, or title yourself'). It matches 'Lean and efficient; assumes Claude's competence; every token earns its place'.

5 / 5

Actionability

Guidance is largely concrete and executable — '2-4 specific, citation-worthy sub-questions', 'Open the most relevant 2-3 documents fully via `read_file`', 'Use `grep` to find supporting passages', and a precise citation rule. It falls short of anchor 5 because step 2 says 'run one targeted KB search' without naming the actual search tool or command, leaving the core operation underspecified.

4 / 5

Workflow Clarity

The four steps are clearly sequenced (decompose → search/read → grep → cite) and the 'Not found in your knowledge base' callout guards against fabrication. It is not level 5 because there is no explicit validation checkpoint (e.g., verifying each cited passage actually supports its claim before finalizing the answer); it sits at 'Clear sequence with most checkpoints present; minor validation gaps'.

4 / 5

Progressive Disclosure

The skill is under 50 lines with no need for external references, and it is organized into three well-labeled sections ('When to use this skill', 'Plan', 'What good output looks like'). Per the rubric's simple-skill guideline, this earns the top anchor without bundle files.

5 / 5

Total

18

/

20

Passed

Description

45%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 correctly identifies the domain but undersells it: the actions are generic ('finding and synthesizing'), there is no 'Use when' trigger guidance, and no natural user phrasings beyond 'knowledge base'. It reads more like a category label than a triggerable description.

Suggestions

Add a 'Use when...' clause with concrete triggers, e.g., 'Use when the user asks to find, look up, or research something in their knowledge base, or references notes, documents, or connector data that should already exist.'

Replace generic verbs with concrete actions: 'Searches the user's notes, documents, and connector data; synthesizes findings across multiple documents with inline [n] citations; explicitly flags claims not found in the knowledge base.'

Include natural synonyms users would say ("knowledge base", "my notes", "our docs", "KB") to sharpen trigger matching and distinguish this skill from general web research.

DimensionReasoningScore

Specificity

The description names the domain ("the user's knowledge base") but the actions are generic — "finding and synthesizing information" could describe almost any search task, and "Structured approach" is filler. It matches the anchor 'Names the domain but actions are minimal or generic' rather than level 3, which requires 1-2 concrete actions (e.g., 'searches notes and documents and cites supporting passages').

2 / 5

Completeness

The 'what' is clear (finding and synthesizing information from the user's knowledge base), but there is no 'Use when...' clause or equivalent explicit trigger guidance, which caps this dimension at 3 per the judging guidelines. Not level 2, because the 'what' is specific rather than vague.

3 / 5

Trigger Term Quality

"knowledge base" is a term users would naturally say, but common variations and synonyms ("search my notes", "look up in my docs", "KB", "what did we discuss") are absent. This is 'Some relevant keywords but missing common variations or synonyms' — not level 4, which expects good coverage across several natural phrases.

3 / 5

Distinctiveness Conflict Risk

Scoping to "the user's knowledge base" gives it a niche, but 'finding and synthesizing information' overlaps heavily with general research, search, and summarization skills. Anchor 3 ('Somewhat specific but could still overlap with similar skills') fits; level 4 would require more distinct trigger phrasing that separates it from generic research skills.

3 / 5

Total

11

/

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

allowed_tools_field

'allowed-tools' contains unusual tool name(s)

Warning

Total

15

/

16

Passed

Repository
MODSetter/SurfSense
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.