skills/common/pkm/knowledge-gardener/SKILL.md at af96c9e33167081ca0b95aa726d2c4387d5794a7

Public Access

Files

T

gitadmin af96c9e331 docs: reorganize skills into pkm category and add crit skill

- Create new `pkm` directory for Personal Knowledge Management skills
- Move conversation-summary, knowledge-gardener, and research-vault from `personal` to `pkm`
- Add new crit skill for brainstorming with the CRIT framework
- Update skill descriptions for clarity and consistency
- Add audio-product-dsp, grilling, and research-engineering to model-invoked listings
- Update skill paths across README files to reflect new directory structure

2026-06-22 22:20:08 -04:00

3.0 KiB

Raw Blame History

name, description, metadata, disable-model-invocation

name

description

metadata

disable-model-invocation

knowledge-gardener

Run vault-aware semantic search, synthesis, note creation, linking, and Zettelkasten workflows for this Obsidian vault.

vault_style	default_write_folder	daily_folder	templates_folder
para-plus-zettelkasten	Inbox	Dailies	Templates

true

Purpose

This skill turns your agent into a vault-aware Obsidian knowledge gardener. It prioritizes semantic retrieval, clear note structure, safe incremental edits, and useful internal links.

Vault Conventions

Preserve folder casing and names used in this vault: Inbox/, Dailies/, projects/, resources/, archive/, Templates/.
Use Obsidian wikilinks: [[Note Title]].
Keep existing frontmatter schema compatible with existing notes:

---
id: <slug-or-date-id>
aliases: []
tags: []
area: ""
project: ""
---

Default location for new AI-generated notes is Inbox/ unless explicitly asked otherwise.

Core Workflows

Semantic Search
- Use python tools/obsidian_semantic_query.py --vault-root . --query "..." --k 12.
- Return ranked notes with short relevance rationale.
Summarization
- Retrieve nearest notes first, then synthesize.
- Include conflicts, unknowns, and suggested next notes.
New Note Creation
- Create with canonical frontmatter.
- Include ## Summary and optional scaffold sections.
- If a summary is provided, include it verbatim under ## Summary.
Automatic Linking
- Suggest links from semantically related notes.
- Prefer high-signal links (shared concepts, same project/area, repeated terms).
Refactor to Atomic Notes
- Split long mixed-topic notes into smaller notes.
- Keep parent note as a structure note and link to children.
Metadata Maintenance
- Keep id, aliases, tags, area, project valid.
- Suggest tags from note content; avoid noisy tag spam.
Research Capture
- Store source summary in vault.
- Extract key claims, evidence, and follow-up questions.
- Convert durable insights into permanent notes.
Zettelkasten Conversion
- Convert source note into atomic permanent notes.
- Add explicit links and one short structure note (MOC-lite) when useful.

Quality Guardrails

Never delete user content unless explicitly requested.
Prefer additive edits and clear section boundaries.
Keep writing concise and skimmable.
Keep tags focused and reusable.
Rebuild semantic index after major note creation/refactor sessions.

Operational Commands

Build index: python tools/obsidian_semantic_index.py --vault-root .
Query index: python tools/obsidian_semantic_query.py --vault-root . --query "your query" --k 12
Frontmatter lint: python tools/obsidian_semantic_maintain.py lint --vault-root .
Related notes: python tools/obsidian_semantic_maintain.py related --vault-root . --note "Inbox/your-note.md" --k 8

Trigger Hints

Load this skill when the user asks to search, summarize, connect, refactor, or organize Obsidian notes.

3.0 KiB Raw Blame History