CtrlK
BlogDocsLog inGet started
Tessl Logo

encyclopedia

Knowledge retrieval from multiple sources. Search docs, web, and code with intelligent routing, RRF fusion, circuit breakers, and semantic caching.

62

Quality

73%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

Failed to scan

The risk profile of this skill

Fix and improve this skill with Tessl

tessl review fix ./encyclopedia/SKILL.md
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.

The content is highly actionable and clearly sequenced with explicit feedback loops, and it is largely concise without over-explaining known concepts. Its main weaknesses are minor verbosity in example outputs and broken/missing referenced files (constitution.md, SPEC.md, shared/feature_flags.py) that undermine progressive disclosure.

Suggestions

Add the missing referenced files (constitution.md, SPEC.md, shared/feature_flags.py) or remove the references so navigation does not dead-end.

Trim the verbose and dry-run JSON example blocks to the essential fields, or move full schemas to SPEC.md.

Move deeper per-phase architecture detail to SPEC.md and keep SKILL.md as a tighter overview, reducing inline weight.

DimensionReasoningScore

Conciseness

The body is largely lean, assuming Claude's competence (no explanation of what search engines or RRF are) and using tight bullets per phase, but the verbose/dry-run JSON example outputs, the overview restating phase content, and inline time-sensitive specifics (e.g., version '0.115.0') add tokens that could be trimmed. Not a 5 due to those trimmable sections; not a 3 because it is mostly efficient and does not pad with concepts Claude already knows.

4 / 5

Actionability

Provides copy-paste-ready CLI commands ('python3 scripts/encyclopedia.py search "..."') with real flags, concrete JSON output examples, exact env var and CLI-path names, and a Files manifest — fully executable guidance covering the common cases (search, lookup, code). Fits the 5 anchor; no significant gaps.

5 / 5

Workflow Clarity

The six-phase pipeline is explicitly sequenced (1-6) with concrete thresholds, an explicit degradation fallback ladder, and feedback loops (circuit open -> probe -> restore). This is a retrieval (non-destructive) skill so the validation cap does not apply, and the explicit recovery loops match the 5 anchor.

5 / 5

Progressive Disclosure

SKILL.md is an overview with clearly signaled one-level references (constitution.md, SPEC.md, shared/feature_flags.py) and a Files section listing scripts/*.py modules, but several referenced files (constitution.md, SPEC.md, shared/feature_flags.py) do not exist in the bundle, and the fully-expanded phase detail is heavy for an overview. Good structure with minor organization gaps — fits 4; not a 5 due to broken references and overview weight, not a 3 because navigation and signaling are genuinely good.

4 / 5

Total

18

/

20

Passed

Description

58%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 clearly states what the skill does and lists several concrete mechanisms, but it omits any 'Use when...' trigger guidance and skews technical rather than toward natural user phrasing. Adding explicit trigger conditions and common synonyms would raise both completeness and trigger-term quality.

Suggestions

Append a 'Use when...' clause with concrete trigger phrases (e.g., 'Use when retrieving documentation, searching the web for current info, or analyzing a repository').

Replace or complement technical terms (RRF fusion, circuit breakers) with natural user phrases like 'look up library docs', 'search the web', 'find API references'.

Add common synonyms and file/extension hints users actually say (e.g., 'docs', 'lookup', '.md', API reference) to improve trigger-term coverage.

DimensionReasoningScore

Specificity

Names the domain ('Knowledge retrieval from multiple sources') and several concrete mechanisms — 'Search docs, web, and code', 'intelligent routing, RRF fusion, circuit breakers, and semantic caching' — placing it at 'several specific actions; minor gaps'. It is not a 5 because the actions lean toward architecture-feature names rather than a comprehensive user-facing capability list, and not a 3 because it clearly exceeds 1-2 actions.

4 / 5

Completeness

It has a clear 'what' (multi-source knowledge retrieval with named mechanisms) but no 'when' — there is no 'Use when...' clause or equivalent trigger guidance, which per the guidelines caps completeness at 3. Not a 2 because the 'what' is clear rather than vague.

3 / 5

Trigger Term Quality

Natural phrases like 'Search docs, web, and code' and 'Knowledge retrieval' are present, but the bulk is technical jargon ('RRF fusion, circuit breakers, semantic caching') users rarely say, and common synonyms like 'look up', 'find documentation', or file extensions are missing. Not a 4 due to thin natural-phrase coverage; not a 2 because the leading phrases are genuinely natural.

3 / 5

Distinctiveness Conflict Risk

The multi-source fusion framing ('RRF fusion, circuit breakers, semantic caching') carves a niche distinct from generic search skills, but 'Search docs, web, and code' is broad and risks overlap with other retrieval/research skills. Mostly distinct with minor overlap risk — fits the 4 anchor; not a 5 due to that breadth.

4 / 5

Total

14

/

20

Passed

Validation

100%

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

Validation16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
Raudbjorn/cognitive-construct
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.