القائمة
Health check for the PARA Knowledge Base. Detects orphan documents, broken links, index drift, tag issues, and stale content. Run periodically or as part of weekly review.
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
| name | kb-lint |
| description | Health check for the PARA Knowledge Base. Detects orphan documents, broken links, index drift, tag issues, and stale content. Run periodically or as part of weekly review. |
| argument-hint | [--fix] [--category <name>] |
Audit the vault for structural issues, inconsistencies, and maintenance opportunities.
/kb-lint # Full report (read-only)
/kb-lint --fix # Auto-fix safe issues
/kb-lint --category Projects # Lint only one category
Compare _index.md contents against actual files on disk.
| Issue | Meaning |
|---|---|
| MISSING | Listed in index but file not found |
| UNLISTED | File exists but not in index |
| STALE_COUNT | Count in top-level index doesn't match |
| STALE_INDEX | updated date > 7 days old |
Auto-fix: Add unlisted files, remove missing entries, update counts and dates.
Files in PARA directories that have:
[[wikilinks]] from other files_index.mdExclude from check: 0. Common/daily/*, 0. Common/weekly/*, _index.md, AGENTS.md, Dashboard.md.
Report: List orphans with suggested action (link, tag, or archive).
| Issue | Rule |
|---|---|
| MISSING_PROJECT_TAG | File in 1. Projects/x/ lacks #proj/x |
| MISSING_TYPE_TAG | Paper file lacks #type/paper |
| BAD_TAG_FORMAT | Spaces or unexpected casing in tag |
| CROSS_REF_TAG | #proj/x tag on file outside Projects — note as intentional cross-reference |
Auto-fix: Add missing #proj/ and #type/ tags to frontmatter.
For each [[wikilink]] found in vault documents:
BROKEN_LINK if not foundWith obsidian CLI: obsidian links broken
Without CLI: Grep for \[\[.*?\]\], resolve each target.
Check documents in PARA directories for required fields:
| Field | Required? |
|---|---|
title | Yes |
created | Yes |
tags | Recommended |
type | Recommended |
Report: Count of documents missing each field, list worst offenders.
| Issue | Condition |
|---|---|
| POSSIBLY_STALE | Project file not modified >30 days |
| SHOULD_ARCHIVE | Completed project still in 1. Projects/ |
| MISPLACED | Active project found in 4. Archive/ |
# KB Lint Report — {date}
## Summary
- Passed: N checks
- Warnings: N items
- Errors: N items
## Details
### Index Drift
...
### Orphan Documents
...
### Tag Issues
...
### Broken Links
...
### Frontmatter Quality
...
### Stale Content
...
## Recommended Actions
1. {highest priority}
2. ...
| Level | Examples | Auto-fixable |
|---|---|---|
| Error | Broken links, missing files | Some |
| Warning | Missing tags, orphans, stale content | Most |
| Info | Optimization suggestions | No |
Append to 0. Common/log.md:
[date] lint | passed N | warnings N | errors N | fixed N
| Argument | Effect |
|---|---|
--fix | Auto-fix safe issues (index drift, tag addition) |
--category <name> | Limit to one category: Projects, Areas, Resources, Archive |
Ingest documents into the PARA Knowledge Base. Classifies, moves, links, and indexes new documents from Inbox or a specified path. Use when new documents need processing into the vault.
Initialize PARA Knowledge Base in your Obsidian vault. Creates index files, log, and adds KB rules to AGENTS.md. Run this first before using other kb- skills.
Query the PARA Knowledge Base to find information, synthesize answers from multiple documents, and optionally save insights. Use when asking questions about vault content or needing cross-document analysis.
Update Knowledge Base indexes. Smart mode detects changes and updates only what's needed. Full rebuild available with --full flag. Use after adding/moving documents or when indexes feel stale.