Knowledge Base-Ready Extraction (KB-Ready Extraction) Skill
This skill implements the KB-Ready Knowledge Engineer persona and architectural framework. It is specifically designed to transform raw speech-to-text transcripts (ASR), lecture recordings, messy meeting notes, or unstructured web content into structured, high-density, Knowledge Base (KB) and RAG-ready Markdown documents.
Scope: Knowledge distillation, conversational denoising, information structuring, and RAG chunk optimization.
Target Systems: Open-Notebook, Obsidian, Logseq, NotebookLM, Notion, Local RAG Vector DBs (Chroma, Qdrant, SurrealDB).
Complementary to SMART POLE: While structures prompts & tasks (Task Specification), structures learning & factual content (Knowledge Representation).
How to Load This Skill
- Set system prompt: Load
references/system-prompt.md as the agent's system prompt (paste into Custom GPT Instructions, Gemini Gem, Claude Project, or automated extraction pipeline).
- Provide reference files (optional but recommended): Make
references/schema-specification.md, references/denoising-rules.md, and references/rag-optimization-guide.md available as context.
- Execute extraction: Feed raw transcript text along with metadata (Course name, Module, Lesson title). The agent outputs a single, clean, valid Markdown document with YAML Frontmatter.
Reference Files
| File |
Purpose |
references/system-prompt.md |
🔴 Required — Full Knowledge Engineer system prompt (v1.0). Load this as system instructions. |
references/schema-specification.md |
Detailed schema specs: YAML frontmatter fields, Markdown heading hierarchy, Callouts, and FAQ format. |
references/denoising-rules.md |
Strict cleaning heuristics: removing spoken fillers, mic checks, small talk, ASR repetition loops. |
references/rag-optimization-guide.md |
RAG architecture guide: semantic chunking, HyDE reverse QA retrieval, vector cosine distance optimization. |
references/examples.md |
Comprehensive Before/After demonstration: from messy raw ASR transcript to polished KB document. |
The 4-Stage Knowledge Engineering Pipeline
┌────────────────────────────────────────────────────────┐
│ 1. INGESTION & CONVERSATIONAL DENOISING │
│ - Strip filler words (à, ừm, thì, là, mà) │
│ - Strip mic checks, greetings, ASR repetition loops │
└────────────────────────┬───────────────────────────────┘
▼
┌────────────────────────────────────────────────────────┐
│ 2. SEMANTIC DISTILLATION │
│ - Extract definitions, frameworks, formulas, steps │
│ - Capture Case Studies & Anti-Patterns (Mistakes) │
└────────────────────────┬───────────────────────────────┘
▼
┌────────────────────────────────────────────────────────┐
│ 3. PEDAGOGICAL STRUCTURING │
│ - Inject YAML Frontmatter (Metadata & Summary) │
│ - Organize into H1, H2 (Key Takeaways), H3 sections │
└────────────────────────┬───────────────────────────────┘
▼
┌────────────────────────────────────────────────────────┐
│ 4. RAG & SEARCH OPTIMIZATION │
│ - Synthesize 3-5 Reverse QA Pairs (HyDE alignment) │
│ - Validate YAML delimiters & Heading boundaries │
└────────────────────────────────────────────────────────┘
The Golden Document Structure
Every document generated by this skill strictly follows this canonical layout:
---
title: "{Clear, descriptive lesson/article title}"
course: "{Course / Category / Book title}"
module: "{Module or Topic cluster, or empty}"
instructor: "{Instructor / Author name, or Unknown}"
difficulty: "{Cơ bản | Trung cấp | Nâng cao}"
target_audience: "{Who this knowledge is for}"
tags:
- "{tag 1}"
- "{tag 2}"
summary: "{Concise 2-3 sentence summary of the core knowledge}"
---
# {Lesson / Note Title}
## 💡 Tóm Tắt Cốt Lõi (Key Takeaways)
- {Key takeaway 1}
- {Key takeaway 2}
- {Key takeaway 3}
## 📖 Nội Dung Chi Tiết
### 1. {Main Section 1}
{In-depth academic/practical explanation with bullet points and bold technical terms.}
> **Ví dụ / Case Study:** {Real-world examples, numbers, or practical applications}
> ⚠️ **Lỗi Sai Thường Gặp (Anti-Pattern):** {Common mistakes, misconceptions, or what to avoid}
### 2. {Main Section 2}
...
## ❓ Câu Hỏi & Trả Lời Trọng Tâm (Q&A for Search)
- **Hỏi:** {High-intent natural question matching user search intent?}
- **Đáp:** {Direct, comprehensive, self-contained answer.}
- **Hỏi:** {Question 2}
- **Đáp:** {Answer 2}
- **Hỏi:** {Question 3}
- **Đáp:** {Answer 3}
Why This Structure Maximizes RAG & Knowledge Bases
- High Signal-to-Noise Ratio: Eliminates 100% conversational debris, maximizing embedding semantic density.
- Deterministic Chunk Boundaries: Splitters split cleanly on
## and ### without severing contextual sentences.
- HyDE Reverse Retrieval: The
## ❓ Q&A section matches user query vectors with high cosine similarity.
- Actionable Anti-Patterns: Capturing mistakes/pitfalls prevents downstream AI agents from suggesting bad advice.
- Metadata Filtering: Frontmatter fields enable hybrid search (metadata filtering + dense vector search) in Open-Notebook, Chroma, and Qdrant.
1---2name: kb-ready-extraction3description: Use to transform raw transcripts, lectures, articles, and unstructured text into high-signal, RAG-optimized, Knowledge Base-ready Markdown documents (for Open-Notebook, Obsidian, NotebookLM, Notion, Vector DBs).4---56# Knowledge Base-Ready Extraction (KB-Ready Extraction) Skill78This skill implements the **KB-Ready Knowledge Engineer** persona and architectural framework. It is specifically designed to transform raw speech-to-text transcripts (ASR), lecture recordings, messy meeting notes, or unstructured web content into structured, high-density, **Knowledge Base (KB) and RAG-ready Markdown documents**.910> **Scope**: Knowledge distillation, conversational denoising, information structuring, and RAG chunk optimization.11> **Target Systems**: Open-Notebook, Obsidian, Logseq, NotebookLM, Notion, Local RAG Vector DBs (Chroma, Qdrant, SurrealDB).12> **Complementary to SMART POLE**: While structures *prompts & tasks* (Task Specification), structures *learning & factual content* (Knowledge Representation).1314---1516## How to Load This Skill17181. **Set system prompt**: Load `references/system-prompt.md` as the agent's system prompt (paste into Custom GPT Instructions, Gemini Gem, Claude Project, or automated extraction pipeline).192. **Provide reference files** *(optional but recommended)*: Make `references/schema-specification.md`, `references/denoising-rules.md`, and `references/rag-optimization-guide.md` available as context.203. **Execute extraction**: Feed raw transcript text along with metadata (Course name, Module, Lesson title). The agent outputs a single, clean, valid Markdown document with YAML Frontmatter.2122---2324## Reference Files2526| File | Purpose |27|------|---------|28| `references/system-prompt.md` | 🔴 **Required** — Full Knowledge Engineer system prompt (v1.0). Load this as system instructions. |29| `references/schema-specification.md` | Detailed schema specs: YAML frontmatter fields, Markdown heading hierarchy, Callouts, and FAQ format. |30| `references/denoising-rules.md` | Strict cleaning heuristics: removing spoken fillers, mic checks, small talk, ASR repetition loops. |31| `references/rag-optimization-guide.md` | RAG architecture guide: semantic chunking, HyDE reverse QA retrieval, vector cosine distance optimization. |32| `references/examples.md` | Comprehensive Before/After demonstration: from messy raw ASR transcript to polished KB document. |3334---3536## The 4-Stage Knowledge Engineering Pipeline3738```text39┌────────────────────────────────────────────────────────┐40│ 1. INGESTION & CONVERSATIONAL DENOISING │41│ - Strip filler words (à, ừm, thì, là, mà) │42│ - Strip mic checks, greetings, ASR repetition loops │43└────────────────────────┬───────────────────────────────┘44 ▼45┌────────────────────────────────────────────────────────┐46│ 2. SEMANTIC DISTILLATION │47│ - Extract definitions, frameworks, formulas, steps │48│ - Capture Case Studies & Anti-Patterns (Mistakes) │49└────────────────────────┬───────────────────────────────┘50 ▼51┌────────────────────────────────────────────────────────┐52│ 3. PEDAGOGICAL STRUCTURING │53│ - Inject YAML Frontmatter (Metadata & Summary) │54│ - Organize into H1, H2 (Key Takeaways), H3 sections │55└────────────────────────┬───────────────────────────────┘56 ▼57┌────────────────────────────────────────────────────────┐58│ 4. RAG & SEARCH OPTIMIZATION │59│ - Synthesize 3-5 Reverse QA Pairs (HyDE alignment) │60│ - Validate YAML delimiters & Heading boundaries │61└────────────────────────────────────────────────────────┘62```6364---6566## The Golden Document Structure6768Every document generated by this skill strictly follows this canonical layout:6970```markdown71---72title: "{Clear, descriptive lesson/article title}"73course: "{Course / Category / Book title}"74module: "{Module or Topic cluster, or empty}"75instructor: "{Instructor / Author name, or Unknown}"76difficulty: "{Cơ bản | Trung cấp | Nâng cao}"77target_audience: "{Who this knowledge is for}"78tags:79 - "{tag 1}"80 - "{tag 2}"81summary: "{Concise 2-3 sentence summary of the core knowledge}"82---8384# {Lesson / Note Title}8586## 💡 Tóm Tắt Cốt Lõi (Key Takeaways)87- {Key takeaway 1}88- {Key takeaway 2}89- {Key takeaway 3}9091## 📖 Nội Dung Chi Tiết92### 1. {Main Section 1}93{In-depth academic/practical explanation with bullet points and bold technical terms.}9495> **Ví dụ / Case Study:** {Real-world examples, numbers, or practical applications}9697> ⚠️ **Lỗi Sai Thường Gặp (Anti-Pattern):** {Common mistakes, misconceptions, or what to avoid}9899### 2. {Main Section 2}100...101102## ❓ Câu Hỏi & Trả Lời Trọng Tâm (Q&A for Search)103- **Hỏi:** {High-intent natural question matching user search intent?}104 - **Đáp:** {Direct, comprehensive, self-contained answer.}105- **Hỏi:** {Question 2}106 - **Đáp:** {Answer 2}107- **Hỏi:** {Question 3}108 - **Đáp:** {Answer 3}109```110111---112113## Why This Structure Maximizes RAG & Knowledge Bases1141151. **High Signal-to-Noise Ratio**: Eliminates 100% conversational debris, maximizing embedding semantic density.1162. **Deterministic Chunk Boundaries**: Splitters split cleanly on `##` and `###` without severing contextual sentences.1173. **HyDE Reverse Retrieval**: The `## ❓ Q&A` section matches user query vectors with high cosine similarity.1184. **Actionable Anti-Patterns**: Capturing mistakes/pitfalls prevents downstream AI agents from suggesting bad advice.1195. **Metadata Filtering**: Frontmatter fields enable hybrid search (metadata filtering + dense vector search) in Open-Notebook, Chroma, and Qdrant.