qmd-knowledge

Manage and search project knowledge with a qmd MCP-backed knowledge base.

Updated Apr 28, 2026
One-click install
npx skills add https://github.com/suwandre/my-codex-config --skill qmd-knowledge-suwandre
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: qmd-knowledge
Source: https://github.com/suwandre/my-codex-config/tree/main/skills/qmd-knowledge
Command: npx skills add https://github.com/suwandre/my-codex-config --skill qmd-knowledge-suwandre

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires qmd, git, and includes scripts (resource) and references (resource) components.

What problem does it solve?

Project teams need a scalable, searchable repository of learnings, decisions, and issue notes tied to a specific codebase, accessible to AI assistants and humans alike.

Core Features & Use Cases

  • Create and maintain a project-specific knowledge base powered by the qmd MCP server.
  • Record learnings and issue notes with automatic indexing for fast search.
  • Contextualize knowledge with project-scoped collections and an auto-embedding workflow.

Quick Start

Create or connect a project knowledge base with qmd, then record your first learning or issue to seed the collection.

Frequently Asked Questions about qmd-knowledge

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create a searchable knowledge base for project learnings and issues?

To create a searchable knowledge base, use this Skill to record learnings and issue notes into a project-specific collection at ~/.ai-knowledges, which automatically embeds content for fast AI-powered searches.

Do I need a local qmd MCP server to manage project knowledge?

Yes, managing project knowledge requires running a local qmd MCP server, along with git, to index collections and execute the scripts that create, update, and embed your recorded notes.

How does automatic embedding work for searching project notes?

Automatic embedding works by processing recorded learnings and issue notes through qmd scripts, generating vector embeddings that enable fast, AI-powered contextual searches across your project's ongoing development context.

Can I scope my knowledge base to a specific codebase?

Yes, you can scope knowledge to a specific codebase by utilizing project-scoped collections that contextualize learnings and issue notes within their respective development environments.

What is the best way to search across learnings and issue notes in development?

The best way to search across learnings and issue notes is using the qmd-backed knowledge base, which leverages automatic embedding to provide fast, AI-powered search results for ongoing development contexts.

What limitations exist when recording issues with qmd?

A key limitation is the dependency on a local qmd MCP server and a dedicated knowledge directory at ~/.ai-knowledges, meaning the knowledge base workflow is tied to your local environment setup.