blogminhquy/javis-os/.claude/skills/ingest-source/SKILL.md
Ingest Source
Tiêu hoá một source thô vào Second Brain, chưng cất thành tri thức wiki tích luỹ.
- Source repository stars
- 129
- Declared platforms
- 0
- Static risk flags
- 0
- Last source update
- 2026-07-28
- Source checked
- 2026-07-28
Decision brief
What it does—and where it fits
Tiêu hoá một source thô vào Second Brain, chưng cất thành tri thức wiki tích luỹ.
Not for
- Tasks that require unconfirmed production actions or broad system permissions.
- Environments where the pinned source and install steps cannot be inspected.
Compatibility matrix
Platform support, with evidence labels
| Platform | Status | Evidence | What to check |
|---|---|---|---|
| Codex | Not declared | No explicit evidence | Portability before use |
| Claude Code | Not declared | No explicit evidence | Portability before use |
| Cursor | Not declared | No explicit evidence | Portability before use |
| Gemini CLI | Not declared | No explicit evidence | Portability before use |
Installation
Inspect first. Install second.
The source command is displayed only when detected. A safe inspection prompt is always available so your agent can explain every action before execution.
npx skills add https://github.com/blogminhquy/javis-os --skill ".claude/skills/ingest-source"Inspect the Agent Skill "Ingest Source" from https://github.com/blogminhquy/javis-os/blob/920e0d4a33be46f522850da546944af4a89788e3/.claude/skills/ingest-source/SKILL.md at commit 920e0d4a33be46f522850da546944af4a89788e3. List every install step, command, network request, credential, file read/write, external action, and rollback step. Explain whether it fits my task. Do not install or execute anything until I approve.
Workflow
What the source asks the agent to do
- 01
Khi nào dùng
Kích hoạt khi người dùng nói những câu như: "tiêu hoá source này", "xử lý bài này vào wiki", "đọc file này rồi ghi lại kiến thức", hoặc khi có file mới thả vào sources/.
Kích hoạt khi người dùng nói những câu như: "tiêu hoá source này", "xử lý bài này vào wiki", "đọc file này rồi ghi lại kiến thức", hoặc khi có file mới thả vào sources/.Skill làm theo đúng 3 kỷ luật của vault.Đọc schema vault (CLAUDE.md/AGENTS.md ở gốc brain) trước; đây là bản thao tác của phép INGEST. - 02
Trước khi làm
Kiểm frontmatter source: status: processed - DỪNG, báo đã xử lý, hỏi có re-ingest không. unprocessed/chưa có - làm.
Kiểm frontmatter source: status: processed - DỪNG, báo đã xử lý, hỏi có re-ingest không. unprocessed/chưa có - làm.Phân loại độ dài. Source dài (= 10.000 dòng / sách / transcript) - BẮT BUỘC 3-pass:Đọc lướt, lập mục lục theo số dòng (vd "1-1300: giới thiệu"). Báo người dùng xác nhận trọng tâm. - 03
Các bước
1. Đọc source (kèm ảnh nếu có). 2. Tóm tắt 3-5 ý chính; rút insight/framework; liên hệ khái niệm đã có. 3. Xác định trang wiki: mới cần tạo / cần cập nhật / cần merge (đọc wiki/index.md để dedup). 4. Viết/cập nhật wiki (1 trang = 1 ý, có [[...]] ngược lại trang liên quan) - TUÂN…
Đọc source (kèm ảnh nếu có).Tóm tắt 3-5 ý chính; rút insight/framework; liên hệ khái niệm đã có.Xác định trang wiki: mới cần tạo / cần cập nhật / cần merge (đọc wiki/index.md để dedup).
Permission review
Static risk signals and limitations
No configured static risk pattern was detected
This is not proof of safety. Runtime behavior, indirect dependencies, and hidden external systems are outside the static scan.
Evidence record
Why each signal appears
| Signal | Value | Evidence type | Meaning |
|---|---|---|---|
| Quality score | 54/100 | Computed | Documentation, specificity, maintenance, and trust rules |
| Repository stars | 129 | Source | Repository attention, not individual Skill quality |
| Compatibility | 0 platforms | Source | Declared in the catalog source record |
| Usage guide | automated source guide | Editorial | Generated or reviewed according to the visible evidence level |
Pinned source
Provenance and original SKILL.md
- Repository
- blogminhquy/javis-os
- Skill path
- .claude/skills/ingest-source/SKILL.md
- Commit
- 920e0d4a33be46f522850da546944af4a89788e3
- License
- Not declared
- Collected
- 2026-07-28
- Default branch
- main
View the original SKILL.md
INGEST - tiêu hoá 1 source thành wiki (compounding)
Khi nào dùng
Kích hoạt khi người dùng nói những câu như: "tiêu hoá source này", "xử lý bài này vào
wiki", "đọc file này rồi ghi lại kiến thức", hoặc khi có file mới thả vào sources/.
Skill làm theo đúng 3 kỷ luật của vault.
Đọc schema vault (CLAUDE.md/AGENTS.md ở gốc brain) trước; đây là bản thao tác của phép INGEST.
Trước khi làm
- Kiểm frontmatter source:
status: processed-> DỪNG, báo đã xử lý, hỏi có re-ingest không.unprocessed/chưa có -> làm. - Phân loại độ dài. Source dài (>= ~10.000 dòng / sách / transcript) -> BẮT BUỘC 3-pass:
- Đọc lướt, lập mục lục theo số dòng (vd "1-1300: giới thiệu"). Báo người dùng xác nhận trọng tâm.
- Đọc sâu từng đoạn ~1.000-1.500 dòng, viết wiki NGAY từng đoạn (đừng nén cả file 1 lần - mất 25-40% chi tiết).
- Tự hỏi 5 câu về các vùng khác nhau; wiki không trả lời được câu nào -> quét bổ sung vùng đó.
Các bước
- Đọc source (kèm ảnh nếu có).
- Tóm tắt 3-5 ý chính; rút insight/framework; liên hệ khái niệm đã có.
- Xác định trang wiki: mới cần tạo / cần cập nhật / cần merge (đọc
wiki/index.mdđể dedup). - Viết/cập nhật wiki (1 trang = 1 ý, có
[[...]]ngược lại trang liên quan) - TUÂN THỦ 3 KỶ LUẬT:- Citation cứng: mỗi câu cụ thể kết bằng
[[Nguồn]]. - Mục tiêu vs thực tế: gắn nhãn "(mục tiêu)" / "(thực tế tính đến ...)" / "(cần xác minh)".
- Mâu thuẫn với trang cũ: thêm
## Mâu thuẫn(giữ cả 2 quan điểm + nguồn) + appendwiki/_open-questions.md, KHÔNG ghi đè. Ngoài 3 kỷ luật, mỗi trang phải TỰ ĐỦ NGỮ CẢNH (contextual retrieval - trang tách khỏi source vẫn hiểu và tìm thấy được): - Mở đầu trang bằng 1-2 câu định vị: khái niệm này là gì, thuộc chủ đề/nguồn nào, dùng khi nào. Nhất là khi ingest source dài theo từng đoạn - đoạn giữa sách mà thiếu câu định vị là sau này đọc lẻ không hiểu.
- Frontmatter thêm
aliases: [tên gọi khác, viết tắt, thuật ngữ tiếng Anh]- để sau này hỏi bằng từ khác thì grep/search vẫn bắt trúng trang.
- Citation cứng: mỗi câu cụ thể kết bằng
- Cập nhật
wiki/index.md(thêm dòng link + mô tả 1 dòng). - Set source
status: processed,processed_at,wiki_links: [...]. Không đáng vào wiki ->status: skipped+note. - Append
wiki/log.md:## [YYYY-MM-DD] ingest | <tên source>+ nguồn/đã tạo/đã cập nhật/insight. - Đề xuất task nếu source mở ra hành động (chỉ đề xuất). Báo cáo ngắn: tóm tắt + trang đã chạm + insight + task.