Wiki Lint Fold: 2 Skill Bảo Trì Vault Obsidian 2026

Bài này deep-dive cách 2 skill hoạt động, run cadence, output report đọc thế nào, và cách integrate vào weekly maintenance routine. Bài 11 skills overview cover skill ở mức intro, bài này focus mechanics chi tiết.

Vì Sao Vault Cần Bảo Trì Định Kỳ?

Vault Obsidian không bảo trì sẽ degrade theo 4 cách. Một, orphan page tăng dần (note tạo rồi không link đâu), giảm signal/noise ratio cho query. Hai, dead wikilink xuất hiện khi rename hoặc delete page, gây error khi /wiki-query traverse graph. Ba, log file wiki/log.md phình to qua tháng, /wiki-query cost theo token tăng tuyến tính. Bốn, frontmatter drift khi convention thay đổi nhưng note cũ chưa update.

Sau 6 tháng dùng vault không maintenance, mình đo: 23% pages là orphan, 40+ dead wikilinks, log.md size 80KB (tốn 20K tokens load), query standard mode chậm 2-3x. Sau 1 lần lint + fold full, recover về baseline.

Cluster Obsidian + Claude Code của ongboit có pillar overview, 3-layer architecture, /wiki bootstrap, capture trio, /wiki-query 3 modes cover các skill upstream. Maintenance là bước downstream giữ vault healthy long-term.

/wiki-lint Skill Hoạt Động Ra Sao?

/wiki-lint là skill scan toàn bộ vault, phát hiện 4 loại issue: orphan pages, dead links, frontmatter inconsistency, structure drift. Output report markdown với severity rating + recommended fix.

Workflow lint:

1. Scan recursive wiki/ folder, parse frontmatter của mỗi page.
2. Build graph từ wikilinks ([[Page Name]]) và direct links (text).
3. Detect orphan: page không có inbound link nào.
4. Detect dead: wikilink trỏ tới page không tồn tại hoặc rename.
5. Detect frontmatter drift: missing required fields (type, tags, created), inconsistent date format.
6. Detect structure drift: page ngoài expected folders (sources/entities/concepts).
7. Generate report wiki-lint-report.md với severity HIGH/MEDIUM/LOW.

Loại issue thường thấy. HIGH severity: dead wikilink (tactical fix needed), missing required frontmatter (broke automation). MEDIUM: orphan page (review and link or archive). LOW: inconsistent date format, soft warning frontmatter drift.

Output report sample:

# Wiki Lint Report - 2026-05-04

## HIGH (3 issues)
- [DEAD LINK] wiki/concepts/llm-wiki.md links to [[karpathy-method]] which doesn't exist
- [DEAD LINK] wiki/sources/article-mcp.md links to [[mcp-spec-2024]] (renamed to mcp-spec-2025?)
- [MISSING FM] wiki/entities/anthropic.md missing required field 'type'

## MEDIUM (8 issues)
- [ORPHAN] wiki/concepts/rag-pattern.md (0 inbound links)
- [ORPHAN] wiki/sources/blog-old.md (0 inbound links, last modified 2025-12)
...

## LOW (15 issues)
- [DATE FORMAT] wiki/sources/x.md uses '12/04/2026', expected '2026-04-12'
...

Run cadence khuyến nghị mỗi tuần (15s scan vault 200-500 notes). Mình personal run mỗi sáng thứ Hai, fix HIGH ngay, batch fix MEDIUM cuối tuần, ignore LOW trừ khi accumulate >50.

Auto-fix mode. /wiki-lint --fix áp dụng fix tự động cho LOW issues (date format, frontmatter add default). HIGH/MEDIUM cần human review vì có thể destructive (delete orphan có thể mất data quan trọng).

/wiki-fold Skill Hoạt Động Ra Sao?

/wiki-fold là skill rollup log file cũ thành meta-page, giảm vault size mà vẫn giữ historical context. Đặc biệt áp dụng cho wiki/log.md là file phình to nhanh nhất.

Vấn đề log.md tăng size. Mỗi /save và /wiki-ingest append entry vào log.md với metadata + summary. Sau 90 ngày dùng intensive, log.md đạt 80-150KB, 20-30K tokens. Standard query mode pull index + log nên token cost tăng theo log size.

Workflow fold:

1. Skill đọc wiki/log.md, parse thành events theo date.
2. Group events theo period: weekly cho >30 ngày, monthly cho >90 ngày, quarterly cho >180 ngày.
3. Generate meta-page summary cho mỗi period: wiki/folded/2026-Q1.md, wiki/folded/2026-04.md.
4. Meta-page giữ key events + cross-references, drop verbose details.
5. Truncate log.md giữ 30 ngày recent, link tới folded pages cho older.

Sample folded meta-page:

# 2026-Q1 Activity Summary

## Key Events
- 2026-01-15: Ingest Karpathy LLM Wiki post (X), 5 follow-up articles
- 2026-02-08: Setup MCP server obsidian-claude-code-mcp
- 2026-03-22: Migrate folder structure to PARA method
- 2026-03-30: Wiki bootstrap với /wiki, baseline 200 notes

## Topics Researched
- LLM Wiki pattern: 12 sources, 5 concepts created
- MCP integration: 8 sources, 3 concepts
- PARA method: 6 sources, 2 concepts

## Wikilinks Outbound
[[karpathy-llm-wiki]], [[mcp-protocol]], [[para-method]]

Effect performance. Vault 800 notes với log.md 100KB, sau /wiki-fold full: log.md 25KB (recent 30 ngày), thêm 4 folded pages tổng 30KB. Net savings 45KB ~12K tokens. Query standard mode tăng tốc 30-40%.

Run cadence. Mỗi tháng đầu tiên fold quarter trước. Vault nhỏ <200 notes, fold mỗi 3 tháng. Vault lớn >500 notes, fold mỗi tháng để keep query speed.

Restore option. /wiki-fold lưu original log.md trong wiki/.backup/log-YYYYMMDD.md. Cần restore detail cũ, copy back hoặc reference từ backup.

Maintenance Routine Cho Developer Thế Nào?

Mình áp dụng routine 3 lớp combine /wiki-lint + /wiki-fold + manual review:

Daily 5 phút sáng. Mở Claude Code, gõ /wiki-lint --quick. Skill scan HIGH severity only, response 5s. Fix dead links ngay nếu có (1-2 fix mỗi tuần typical).

Weekly 15 phút thứ Hai. Run /wiki-lint full scan. Review report HIGH + MEDIUM. Fix HIGH ngay. Schedule MEDIUM cho cuối tuần. Skip LOW trừ khi báo động.

Monthly 30 phút đầu tháng. Run /wiki-fold cho period last month. Review folded meta-pages, verify summary chuẩn. Update wiki/index.md với folded references mới. Run /wiki-lint lần cuối để verify post-fold không gãy link.

Quarterly 1 giờ. Audit toàn vault: review orphan pages, archive notes không còn relevant, refresh wiki/hot.md với current focus. Run /wiki-fold cho quarter trước.

KPI track. Vault size (target <50MB cho 1000 notes). Query standard mode time (target <10s). Orphan page % (target <10% total). Dead link count (target 0). Mình track 3 metrics này trong wiki/maintenance-log.md mỗi monthly run.

Workflow Tích Hợp Với Skill Khác Ra Sao?

Lint/fold integrate tự nhiên với 3 skill khác trong AgriciDaniel ecosystem.

Với /wiki-ingest. Sau /wiki-ingest batch (10+ articles), run /wiki-lint để check log.md grew thế nào. Nếu log.md >80KB, schedule /wiki-fold next week. Bài /save + /wiki-ingest + /defuddle cover capture flow upstream.

Với /wiki-query. Trước query deep mode complex, run /wiki-lint để verify không có dead link sẽ break traversal. Sau /wiki-fold, /wiki-query speed up 30-40% cho standard mode. Bài /wiki-query 3 modes cover query mechanics.

Với /wiki bootstrap. /wiki tạo skeleton, /wiki-lint maintain skeleton healthy, /wiki-fold giữ skeleton từ phình to. 3 skill cùng nhau form maintenance triplet. Bài /wiki bootstrap vault cover setup ban đầu.

Pattern lint trước fold. Run /wiki-lint trước /wiki-fold để fix dead link upfront. Fold sẽ rollup events bao gồm cả dead links, sau fold sửa khó hơn vì log đã consolidated. Order chuẩn: lint → fix → fold.

Anti-pattern. Skip lint chạy thẳng fold = rollup garbage data. Run fold quá thường (mỗi tuần) = mất detail recent useful. Run lint quá thường (mỗi giờ) = noise không productive.

Câu Hỏi Thường Gặp

/wiki-lint có safe để run trên vault production không?

Có, /wiki-lint là read-only mode default. Skill chỉ scan và generate report, không modify pages. Mode --fix có flag explicit chỉ fix LOW severity (frontmatter format), không touch HIGH/MEDIUM cần human review. An toàn run hàng ngày.

/wiki-fold có mất data không?

Không, fold compress data thành meta-page nhưng giữ original trong wiki/.backup/. Restore bằng cách copy back từ backup folder. Mặc dù vậy nên review folded pages sau fold first time, verify summary capture đủ context.

Cần run lint hay fold trước?

Lint trước. Lint phát hiện dead link và orphan, fix trước khi fold để tránh rollup garbage. Order: /wiki-lint → fix HIGH issues → /wiki-fold. Sau fold run /wiki-lint thêm 1 lần để verify không gãy link mới.

Vault nhỏ <100 notes có cần maintenance không?

Có nhưng cadence thấp hơn. Vault nhỏ /wiki-lint mỗi tháng, /wiki-fold mỗi quý. Vault lớn >500 notes lint weekly, fold monthly. Cadence scale theo write frequency, không theo size tuyệt đối.

Lint detect được issue nào mà manual review miss?

Cross-reference dead link là loại lint vượt trội manual. Vault 500 notes có 3000+ wikilinks, manual scan không khả thi. Lint detect 100% dead links trong 15s. Manual chỉ catch khi click qua link cụ thể đó.

Maintenance routine có thể automate full không?

Không 100%. /wiki-lint –fix automate được LOW issues (frontmatter, date format). HIGH/MEDIUM cần human judgment (delete orphan có thể mất context quan trọng, fix dead link có thể trỏ wrong target). Lint flag issue, human decide action.

Bạn Setup Maintenance Routine Như Thế Nào?

Bắt đầu với weekly /wiki-lint mỗi sáng thứ Hai. Đọc report, fix HIGH ngay, ghi note MEDIUM cho cuối tuần. Sau 4 tuần observe pattern issue thường gặp, adjust frontmatter convention nếu cần.

Tháng thứ hai add monthly /wiki-fold. Run đầu tháng cho quarter trước, verify folded pages, update index. Tháng thứ ba thiết lập KPI tracking với wiki/maintenance-log.md.

Tham khảo cluster Obsidian + Claude Code: pillar setup, Karpathy LLM Wiki story, 3-layer architecture, /wiki bootstrap, capture trio, /wiki-query 3 modes, 11 skills overview. Bài này (D-6) cover maintenance phase, complete cluster D core skills.

Tài liệu tham khảo bên ngoài

• AgriciDaniel/claude-obsidian, source /wiki-lint + /wiki-fold skills.