qmd

Search local markdown knowledge bases, notes, docs, and wikis with QMD. Use when users ask to find notes, retrieve documents, inspect a wiki, answer from indexed markdown, or set up QMD access.

Quality

88%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Passed

No findings from the security scan

Quality

Content

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

Highly actionable and well-structured content with executable examples, an explicit workflow, and a properly signaled one-level reference. Only minor conciseness tightening would raise it further.

Dimension	Reasoning	Score
Conciseness	The body is lean and assumes Claude's competence, but the Pitfalls section restates guidance already embedded inline (e.g. the sed/head/tail warning), introducing minor over-explanation.	4 / 5
Actionability	Copy-paste-ready `qmd search`, `qmd query`, `qmd get`, and `qmd multi-get` examples with real flags and expected output cover the common cases fully.	5 / 5
Workflow Clarity	The 1-2-3 search/retrieve/cite loop is explicitly sequenced, index mutation is gated behind explicit user intent, and the Pitfalls section provides error-recovery feedback (fall back to `qmd search`, run `qmd doctor`).	5 / 5
Progressive Disclosure	The body is organized into clear sections with one clearly signaled, one-level-deep reference (`references/mcp-setup.md`) that is a real file, keeping detail appropriately offloaded.	5 / 5
	Total	19 / 20 Passed

Description

83%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 description with concrete capability and an explicit, natural trigger clause. Minor gaps in synonym coverage keep specificity and trigger_term_quality at 4 rather than 5.

Dimension	Reasoning	Score
Specificity	"Search local markdown knowledge bases, notes, docs, and wikis with QMD" names the domain plus a concrete action, but covers only search rather than the full retrieve/cite workflow, so it sits at 4 rather than 5.	4 / 5
Completeness	It gives a clear "what" (search local markdown KBs with QMD) and an explicit "Use when users ask to find notes, retrieve documents, inspect a wiki, answer from indexed markdown, or set up QMD access" trigger clause.	5 / 5
Trigger Term Quality	"find notes, retrieve documents, inspect a wiki, answer from indexed markdown" are natural user phrases, though synonyms like "search my notes" or file extensions are absent, keeping it just below 5.	4 / 5
Distinctiveness Conflict Risk	The markdown/knowledge-base/wiki niche is well-scoped with minimal overlap risk, but "docs" and "set up QMD access" are slightly broad, so it does not fully reach 5.	4 / 5
	Total	17 / 20 Passed

Validation

93%

Warnings & errors only

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

Criteria	Description	Result
allowed_tools_field	'allowed-tools' contains unusual tool name(s)	Warning

	Total	15 / 16 Passed

Repository: tobi/qmd
Path: skills/qmd/SKILL.md
Commit: facd35e

Reviewed: 2 days ago

Table of Contents

Discovery Implementation Validation

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.