New: 97,000+ skills indexed from GitHub repos with 100+ stars · every skill safety-checkedBrowse top skillsTop skills
Esc to closeBrowse all skills
Submit a skillBrowse skills
Submit a skillBrowse skills

Agent skill

Qmd

by alsk1992 in alsk1992/CloddsBot

Local hybrid search for markdown notes and docs. An agent skill from alsk1992/CloddsBot.

MITAuto-check passedKnowledge Management

Install Qmd

skills CLI
$ npx skills add alsk1992/CloddsBot --skill qmd -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install alsk1992/CloddsBot qmd --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/alsk1992/CloddsBot.git skills-src && mkdir -p .claude/skills && cp -r skills-src/src/skills/bundled/qmd .claude/skills/qmd && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
qmd
GitHub stars
2.9k
Used in
3 other repos
Token cost
~1.2k tokens
SKILL.md length
458 words
Files
2
Skills in repo
118
Repo updated
First seen
Licence
MIT

At a glance

Local hybrid search for markdown notes and docs. An agent skill from alsk1992/CloddsBot.

  • Searching notes
  • SKILL.md covers When to use (trigger phrases), Default behavior (important), Prerequisites and Install, plus 11 more sections
  • Runs TypeScript scripts from its folder; calls brew and bun; reaches github.com
  • Finding related content

What it does

Qmd is an agent skill from alsk1992/CloddsBot. Local hybrid search for markdown notes and docs. Use when searching notes, finding related content, or retrieving documents from indexed collections.

Its SKILL.md is about 1.2k tokens, which your agent loads only when the skill is triggered. The skill folder holds 1 other file (for example `index.ts`).

It sits in Knowledge Management, covering Retrieval-augmented generation and Note-taking. The repository describes itself as: Open Source AI trading agent that operates autonomously across 1000+ markets - Polymarket, Kalshi, Binance, Hyperliquid, Solana DEXs, 5 EVM chains. Scans for edge, executes… The licence is MIT.

When your agent uses it

  • Searching notes
  • Finding related content
  • Retrieving documents from indexed collections

Example prompts

  • “/qmd”

Requirements

  • Node.js

What it can do on your machine

Read from SKILL.md and the folder at commit c930628. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships script files (TypeScript), which the agent can run.

    Shell commands in SKILL.md call:

    • brew
    • bun

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • github.com

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Qmd loads about 1.2k tokens when it runs. Until then it costs about 38 tokens; SKILL.md has 458 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~38
When it runs · the whole SKILL.md, loaded when a task matches
~1.2k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from alsk1992/CloddsBot at commit c930628, republished under its MIT licence (© alsk1992). 458 words, ~1,228 tokens.

Download SKILL.mdSave it as .claude/skills/qmd/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
qmd
description
Local hybrid search for markdown notes and docs. Use when searching notes, finding related content, or retrieving documents from indexed collections.
homepage
https://github.com/tobi/qmd

Local search engine for Markdown notes, docs, and knowledge bases. Index once, search fast.

When to use (trigger phrases)

  • "search my notes / docs / knowledge base"
  • "find related notes"
  • "retrieve a markdown document from my collection"
  • "search local markdown files"

Default behavior (important)

  • Prefer qmd search (BM25). It's typically instant and should be the default.
  • Use qmd vsearch only when keyword search fails and you need semantic similarity (can be very slow on a cold start).
  • Avoid qmd query unless the user explicitly wants the highest quality hybrid results and can tolerate long runtimes/timeouts.

Prerequisites

  • Bun >= 1.0.0
  • macOS: brew install sqlite (SQLite extensions)
  • Ensure PATH includes: $HOME/.bun/bin

Install Bun (macOS): brew install oven-sh/bun/bun

Install

bun install -g https://github.com/tobi/qmd

Setup

bash
qmd collection add /path/to/notes --name notes --mask "**/*.md"
qmd context add qmd://notes "Description of this collection"  # optional
qmd embed  # one-time to enable vector + hybrid search

What it indexes

  • Intended for Markdown collections (commonly **/*.md).
  • In our testing, "messy" Markdown is fine: chunking is content-based (roughly a few hundred tokens per chunk), not strict heading/structure based.
  • Not a replacement for code search; use code search tools for repositories/source trees.

Search modes

  • qmd search (default): fast keyword match (BM25)
  • qmd vsearch (last resort): semantic similarity (vector). Often slow due to local LLM work before the vector lookup.
  • qmd query (generally skip): hybrid search + LLM reranking. Often slower than vsearch and may timeout.

Performance notes

  • qmd search is typically instant.
  • qmd vsearch can be ~1 minute on some machines because query expansion may load a local model (e.g., Qwen3-1.7B) into memory per run; the vector lookup itself is usually fast.
  • qmd query adds LLM reranking on top of vsearch, so it can be even slower and less reliable for interactive use.
  • If you need repeated semantic searches, consider keeping the process/model warm (e.g., a long-lived qmd/MCP server mode if available in your setup) rather than invoking a cold-start LLM each time.
Show full SKILL.md (163 more words)Show less

Common commands

bash
qmd search "query"             # default
qmd vsearch "query"
qmd query "query"
qmd search "query" -c notes     # Search specific collection
qmd search "query" -n 10        # More results
qmd search "query" --json       # JSON output
qmd search "query" --all --files --min-score 0.3

Useful options

  • -n <num>: number of results
  • -c, --collection <name>: restrict to a collection
  • --all --min-score <num>: return all matches above a threshold
  • --json / --files: agent-friendly output formats
  • --full: return full document content

Retrieve

bash
qmd get "path/to/file.md"       # Full document
qmd get "#docid"                # By ID from search results
qmd multi-get "journals/2025-05*.md"
qmd multi-get "doc1.md, doc2.md, #abc123" --json

Maintenance

bash
qmd status                      # Index health
qmd update                      # Re-index changed files
qmd embed                       # Update embeddings

Keeping the index fresh

Automate indexing so results stay current as you add/edit notes.

  • For keyword search (qmd search), qmd update is usually enough (fast).
  • If you rely on semantic/hybrid search (vsearch/query), you may also want qmd embed, but it can be slow.

Example schedules (cron):

bash
# Hourly incremental updates (keeps BM25 fresh):
0 * * * * export PATH="$HOME/.bun/bin:$PATH" && qmd update

# Optional: nightly embedding refresh (can be slow):
0 5 * * * export PATH="$HOME/.bun/bin:$PATH" && qmd embed

If your Clawdbot/agent environment supports a built-in scheduler, you can run the same commands there instead of system cron.

Models and cache

  • Uses local GGUF models; first run auto-downloads them.
  • Default cache: ~/.cache/qmd/models/ (override with XDG_CACHE_HOME).
  • qmd searches your local files (notes/docs) that you explicitly index into collections.
  • Clawdbot's memory_search searches agent memory (saved facts/context from prior interactions).
  • Use both: memory_search for "what did we decide/learn before?", qmd for "what's in my notes/docs on disk?".

© alsk1992, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 1 other file in src/skills/bundled/qmd of alsk1992/CloddsBot.

  • SKILL.md
  • index.ts

Open the folder on GitHubat commit c930628

Used in 3 other repositories

We found 5 copies of this SKILL.md (exact, near-identical or edited) in other folders, from 3 other GitHub owners. This page covers the copy in alsk1992/CloddsBot, which our catalogue first saw on October 7, 2026.

Compare with similar skills

Qmd next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Qmd compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Qmd this skillalsk1992/CloddsBot2.9k3 repos~1.2kAutomated safety check: PassMIT
Qmd 2sundial-org/awesome-openclaw-skills663—~1.2kAutomated safety check: PassNone
Knowledgebaseopen-edge-platform/edge-ai-suites140—~900Automated safety check: PassApache-2.0
Google Image Searchglebis/claude-skills388—~1.4kAutomated safety check: NotesMIT
Openloomimelandlabs/openloomi1k—~835Automated safety check: PassApache-2.0
Clarity Gatemajiayu000/claude-skill-registry6664 repos~6.2kAutomated safety check: PassCC-BY-4.0

Similar skills

  • Qmd 2

    sundial-org/awesome-openclaw-skills

    Local hybrid search for markdown notes and docs. An agent skill from sundial-org/awesome-openclaw-skills.

    663 GitHub stars~1.2k tokensUpdated 7 mo ago
    Knowledge ManagementAuto-check passed

  • Knowledgebase

    open-edge-platform/edge-ai-suites

    Generic RAG query skill - Retrieve any information from the local knowledge base and generate structured reports, summaries, or Q&A responses.

    140 GitHub stars~900 tokensUpdated today
    Knowledge ManagementAuto-check passed

  • Google Image Search

    glebis/claude-skills

    Search and download images via Google Custom Search API with LLM-powered selection.

    388 GitHub stars~1.4k tokensUpdated 11 days ago
    Knowledge ManagementAuto-check: notes

  • Openloomi

    melandlabs/openloomi

    OpenLoomi entrypoint for skill-only agent runtimes without a plugin mechanism.

    1k GitHub stars~835 tokensUpdated 13 days ago
    Knowledge ManagementAuto-check passed

  • Clarity Gate

    majiayu000/claude-skill-registry

    Pre-ingestion verification for epistemic quality in RAG systems.

    666 GitHub starsUsed in 4 repos~6.2k tokens
    Knowledge ManagementAuto-check passed

  • Neo4j Document Import Skill

    neo4j-contrib/neo4j-skills

    Ingests unstructured and semi-structured documents into Neo4j as a knowledge graph.

    114 GitHub stars~5.4k tokensUpdated today
    Knowledge ManagementAuto-check: notes

More from alsk1992/CloddsBot

All 118 skills in this repo

  • Drift SDK

    alsk1992/CloddsBot

    Drift Protocol perpetual futures trading on Solana (direct SDK)

    2.9k GitHub starsUsed in 1 repo~625 tokens
    Auto-check passed

  • Edge

    alsk1992/CloddsBot

    Find mispriced markets by comparing to external models and data sources

    2.9k GitHub starsUsed in 1 repo~472 tokens
    Auto-check passed

  • Embeddings

    alsk1992/CloddsBot

    Vector embeddings configuration and semantic search. An agent skill from alsk1992/CloddsBot.

    2.9k GitHub starsUsed in 1 repo~1.3k tokens
    Auto-check passed

  • News

    alsk1992/CloddsBot

    Monitor news and correlate with prediction market movements. An agent skill from alsk1992/CloddsBot.

    2.9k GitHub starsUsed in 1 repo~462 tokens
    Auto-check passed

  • Opportunity

    alsk1992/CloddsBot

    Find and execute cross-platform arbitrage opportunities across prediction markets

    2.9k GitHub starsUsed in 1 repo~2.2k tokens
    Auto-check passed

  • Portfolio

    alsk1992/CloddsBot

    Track your positions and P&L across prediction markets and futures exchanges

    2.9k GitHub starsUsed in 1 repo~911 tokens
    Auto-check passed

Categories

Questions about Qmd

What does Qmd do?

Local hybrid search for markdown notes and docs. An agent skill from alsk1992/CloddsBot. Qmd is an agent skill from alsk1992/CloddsBot. Local hybrid search for markdown notes and docs.

When should I use Qmd?

Qmd fits situations like: searching notes; finding related content; retrieving documents from indexed collections.

How do I install Qmd in Claude Code?

Run `npx skills add alsk1992/CloddsBot --skill qmd -a claude-code`. Or copy the skill folder (src/skills/bundled/qmd in alsk1992/CloddsBot) into .claude/skills/qmd in your project. Claude Code loads it when a task matches its description.

How do I install Qmd in Codex?

Run `npx skills add alsk1992/CloddsBot --skill qmd -a codex`. Or copy the skill folder (src/skills/bundled/qmd in alsk1992/CloddsBot) into .agents/skills/qmd in your project. Codex loads it when a task matches its description.

Can I use Qmd in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add alsk1992/CloddsBot --skill qmd -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/qmd, .gemini/skills/qmd, .github/skills/qmd and .opencode/skills/qmd in your project.

What does Qmd need to run?

Going by SKILL.md and its folder, Qmd needs TypeScript for the scripts in its folder and the command-line tools its instructions call (brew and bun). Our summary lists: Node.js.

Does Qmd access the network?

SKILL.md names 1 domain. In commands or code: github.com; the agent is likely to contact it when it follows the instructions. This is read from the text; nothing was executed.

Is Qmd safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Qmd use?

Qmd is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Qmd use?

About 1.2k tokens (SKILL.md is roughly 4.9k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Qmd?

Skills that share tags, products or a category with Qmd: Qmd 2 (sundial-org/awesome-openclaw-skills, 663 stars), Knowledgebase (open-edge-platform/edge-ai-suites, 140 stars), Google Image Search (glebis/claude-skills, 388 stars) and Openloomi (melandlabs/openloomi, 1k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Qmd?

alsk1992 (a GitHub user) maintains it in alsk1992/CloddsBot, which has 2,901 GitHub stars. The repository holds 118 skills in this directory. The repository was last updated on October 2, 2026.

Source: alsk1992/CloddsBot on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.