knowledge-os

Guide for creating effective skills. This skill should be used when users want to create a new skill (or update an existing skill) that extends the AI agent's capabilities with specialized knowledge, workflows, or tool integrations.

Thinking partner and creativity facilitator for one-on-one brainstorming, idea generation, problem-solving, and decision-making. Uses Socratic questioning as default mode with a toolkit of proven creativity frameworks (SCAMPER, First Principles, Six Hats, HMW, Reverse Brainstorm, JTBD, Analogical Thinking, Pre-mortem, Five Whys, Second-order Thinking, Rapid Ideation, Regret Minimization). Use when the user says "brainstorm", "think through", "help me decide", "explore ideas for", "I'm stuck", "tôi cần ý tưởng", or any brainstorming or ideation request.

Turn an external source — a URL, a pasted article, a paper, a video, a book — into a structured reference note in the knowledge base. Use this skill when the user shares a link and wants to save it, pastes text from an article they just read, says "save this", "add this to my KB", "make a note of this", "I want to remember this", "capture this reference", or drops a URL with no other instruction (which usually means "save this for me"). Also trigger when the user wants to annotate or add their own thoughts to an external source.

Extracts Mermaid diagrams from markdown files and generates high-quality PNG images using bundled scripts. Activates when working with Mermaid diagrams, converting diagrams to PNG, extracting diagrams from markdown, or processing markdown files with embedded Mermaid code.

Help a new user set up their personal Knowledge OS data folder (data/) by interviewing them about their work context, roles, and goals, then using AI to generate a personalized folder structure and profile. Use this skill when the user says "set up my KB", "onboard me", "create my knowledge base", "setup my data folder", "setup knowledge OS", "tôi muốn thiết lập KB", "khởi tạo knowledge base", or any first-time setup request.

Create, edit, archive/delete, and query project notes in the knowledge base. Use this skill when the user wants to: create a new project, update project info, delete or archive a project, add a note inside a project (decisions, roadmap, architecture, retrospective, etc.), search within a project, or get a summary/ overview of a project's state. Triggers: "create project", "new project", "delete project", "archive project", "add note to project", "search in project", "project summary", "project overview", "update project", "tạo project", "tạo dự án", "xóa project".

Search, retrieve, and synthesize information from the personal knowledge base (KB). Use this skill whenever the user asks what they know about a topic, wants to find notes, wants a summary of their knowledge on something, asks to "look in the KB", or phrases a question as if they expect the answer to come from their own notes (e.g. "what have I written about X", "do I have anything on Y", "pull up my notes on Z", "what do I know about W"). Also trigger when the user asks a technical question that could plausibly be answered from their own knowledge base before searching the web. **How to run search (shared script):** ```bash brain/scripts/kb-search/.venv/bin/python brain/scripts/kb-search/search.py "QUERY" --top-k 5 --json ``` **How to rebuild index (shared script):** ```bash brain/scripts/kb-search/.venv/bin/python brain/scripts/kb-search/index.py full ```

Converts documents to markdown with multi-tool orchestration for best quality. Supports Quick Mode (fast, single tool) and Heavy Mode (best quality, multi-tool merge). Use when converting PDF/DOCX/PPTX files to markdown, extracting images from documents, validating conversion quality, or needing LLM-optimized document output.