CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

qmd

Hybrid local search over notes, docs, and transcripts.

56

Quality

71%

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 ./optional-skills/research/qmd/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

71%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 highly actionable — every workflow is backed by executable commands, complete configs, and a troubleshooting section — with a clear setup sequence and validation step. Its weaknesses are length (inline daemon boilerplate and pipeline internals that could be trimmed or split out) and the complete absence of progressive disclosure: everything lives in one monolithic SKILL.md with no reference files.

Suggestions

Move the macOS launchd plist, Linux systemd unit, and MCP setup details into a references/ file (e.g. references/daemon-setup.md) and keep a one-line pointer plus the core command in SKILL.md.

Trim the 'How the Search Pipeline Works' section to the one-line guidance each mode needs (or move it to a reference), cutting RRF constants and blending percentages Claude does not need to use the tool.

Strengthen the setup verify step: state what healthy `qmd status` output looks like and what to check if `qmd embed` fails, closing the remaining validation gap.

DimensionReasoningScore

Conciseness

The body is mostly efficient (command tables, terse setup steps), but several sections could be tightened: the full launchd plist XML and systemd unit inline (~50 lines of boilerplate Claude can generate), the "How the Search Pipeline Works" internals (RRF k=60, position-aware blending weights add tokens beyond what is needed to pick a search mode), and the attribution line. This matches 'Mostly efficient but includes some unnecessary explanation or could be tightened', not the lean anchor 5 or the padded anchor 2.

3 / 5

Actionability

Every section gives copy-paste-ready commands: install commands with version checks, a Quick Reference command table, concrete search examples per mode, exact YAML MCP configs, structured multi-mode query examples, and troubleshooting commands with fixes. This matches 'Fully executable; copy-paste ready code or commands; specific examples cover the common cases'.

5 / 5

Workflow Clarity

Setup is a clearly numbered sequence (add collections → add context → embed → verify) with an explicit verify step (`qmd status`) plus a Verify Installation section, and the Troubleshooting section provides error-recovery feedback. It falls short of 5 because the verify step does not state what a healthy result looks like or what to do on failure within the workflow itself, and embed failures have no recovery loop — matching 'Clear sequence with most checkpoints present; minor validation gaps'.

4 / 5

Progressive Disclosure

The skill is a single ~430-line file with no bundle files at all; headers and a Quick Reference table give it reasonable structure, but content that belongs in separate reference files (launchd/systemd daemon configs, MCP integration details, search pipeline internals) is inlined. This matches 'Some structure but could be better organized; content that should be separate is inline' rather than anchor 4's appropriately split layout.

3 / 5

Total

15

/

20

Passed

Description

61%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 is concise and specific about what the skill does, with natural trigger nouns (notes, docs, transcripts), but it entirely lacks a 'when to use' clause and misses common trigger variations like "knowledge base" or "semantic search". Per the rubric, the missing explicit trigger guidance caps completeness at 3.

Suggestions

Append a trigger clause, e.g. "Use when the user asks to search notes, docs, knowledge bases, or meeting transcripts, or mentions qmd, semantic search, or finding things across many text files."

Add natural trigger variations such as "knowledge base", "search my notes", "find in my docs", and "meeting transcripts" to broaden keyword coverage.

Optionally name one or two more concrete actions (e.g., "indexes markdown files and runs hybrid keyword + semantic search") to lift specificity.

DimensionReasoningScore

Specificity

"Hybrid local search over notes, docs, and transcripts" names a specific domain and one concrete capability (hybrid search), matching the anchor 'Names domain and 1-2 concrete actions, but not comprehensive'. It does not list several specific actions (indexing, embedding, MCP integration, reranking), so it is not a 4.

3 / 5

Completeness

The 'what' is clear (local hybrid search over notes, docs, and transcripts), but there is no 'Use when...' clause or any explicit trigger guidance, capping completeness at 3 per the rubric guideline. It is not a 2 because the 'what' is specific rather than vague.

3 / 5

Trigger Term Quality

"notes, docs, transcripts" are natural terms users would say when needing this skill, giving good keyword coverage. It falls short of 5 because common variations like "knowledge base", "search my notes", "meeting notes", or "semantic search" are absent, but it is noticeably above the single-keyword coverage of anchor 3.

4 / 5

Distinctiveness Conflict Risk

The scope (local, personal notes/docs/transcripts search) carves out a mostly distinct niche with minor overlap risk against closely related note-search or RAG skills. It is not a 5 because the phrasing does not include distinct trigger phrases that would fully separate it from generic search or knowledge-base skills.

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

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

13

/

16

Passed

Repository

NousResearch/hermes-agent

Path

optional-skills/research/qmd/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.