feat: add qmd skill for markdown knowledge base search

[shunkakinoki]

Summary

• Add qmd skill from tobi/qmd for hybrid markdown search (BM25 + vector + LLM reranking)
• Includes SKILL.md with CLI and MCP tool usage docs
• Includes references/mcp-setup.md for manual MCP configuration

Test plan

• make ruler-prepare copies skill to .ruler/skills/
• make sync distributes to all agent skill directories
• Skill appears in Claude Code available skills list

🤖 Generated with Claude Code

---

Summary by cubic

Adds the qmd skill for local Markdown knowledge base search with hybrid ranking (BM25 + vector + LLM reranking). Enables agents to search notes, docs, and meeting transcripts via CLI or MCP tools.

• New Features
  • Adds SKILL.md with command examples, options, and score guidance.
  • Exposes MCP tools (qmd_search, qmd_vector_search, qmd_deep_search, qmd_get, qmd_multi_get, qmd_status); manual setup in references/mcp-setup.md.
  • Integrates with existing workflow: make ruler-prepare and make sync copy and distribute the skill; verified in Claude Code.
  • Requires qmd CLI or MCP server (install via: bun install -g https://github.com/tobi/qmd).

^{Written for commit bacb9d3. Summary will update on new commits.}

[coderabbitai]

Warning

Rate limit exceeded

@shunkakinoki has exceeded the limit for the number of commits that can be reviewed per hour. Please wait 28 minutes and 26 seconds before requesting another review.

⌛ How to resolve this issue?

After the wait time has elapsed, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

We recommend that you space out your commits to avoid hitting the rate limit.

🚦 How do rate limits work?

CodeRabbit enforces hourly rate limits for each developer per organization.

Our paid plans have higher rate limits than the trial, open-source and free plans. In all cases, we re-allow further reviews after a brief timeout.

Please see our FAQ for further information.

✨ Finishing touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Post copyable unit tests in a comment
• Commit unit tests in branch feat/add-qmd-skill

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[cubic-dev-ai]

No issues found across 2 files

[Copilot]

Pull request overview

This PR adds a new qmd skill for searching markdown knowledge bases using hybrid search techniques (BM25, vector search, and LLM reranking). The skill integrates the qmd CLI tool and MCP server to enable natural language search queries across notes, documentation, and meeting transcripts.

Changes:

• Added SKILL.md with comprehensive documentation on CLI commands, search modes, and MCP tool integration
• Added mcp-setup.md reference documentation for manual MCP server configuration
• Integrated qmd tool with both CLI and MCP interfaces for flexible usage

Reviewed changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated 1 comment.

File	Description
skills/qmd/SKILL.md	Main skill documentation covering search commands, options, workflows, and MCP integration
skills/qmd/references/mcp-setup.md	Manual MCP configuration guide for Claude Code and Claude Desktop with troubleshooting

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[Copilot]

The default value of 10KB for maxBytes may be too restrictive for many documentation files and meeting transcripts. Consider documenting whether this limit is adjustable and what reasonable values might be, or explain the rationale for this default.

Suggested change

	- `maxBytes` (optional): Skip files larger than this (default: 10KB)
	- `maxBytes` (optional): Maximum size per file in bytes; files larger than this are skipped (default: 10KB to keep responses small and fast for chat use). You can override this default by passing a larger value when calling `qmd_multi_get` (for example, 100KB–1MB for typical documentation files or meeting transcripts).