phase4-7: rewrite PKM skills for OKF v0.1 alignment
Phase 4: Rewrite research-vault skill - Packet becomes OKF bundle with index.md (no frontmatter) and log.md - All packet pages get proper type frontmatter - Atomic note template uses merged OKF + vault schema - Links use markdown [...](...) not wikilinks - Updated research-packet-template.md reference Phase 5: Rewrite pkm-curation skill - Frontmatter normalization adds type field using classification heuristics - Links use markdown [...](...) not wikilinks - Bundle awareness added (update index.md, log.md) - Updated agent-integration.md for OKF conventions Phase 6: Rewrite conversation-summary skill - AI Conversation Summaries/ bundle awareness (update index.md, log.md) - Report and transcript notes get merged frontmatter with proper type - Links use markdown [...](...) not wikilinks Phase 7: Review crit skill - No vault I/O changes needed — pure brainstorming framework
This commit is contained in:
@@ -5,15 +5,16 @@ aliases:
|
||||
tags:
|
||||
- knowledge-management
|
||||
- reference
|
||||
- okf
|
||||
area: Personal Knowledge Management
|
||||
project:
|
||||
project: ''
|
||||
---
|
||||
|
||||
# Agent Integration
|
||||
|
||||
## Purpose
|
||||
|
||||
This skill should be usable from any agent, and it should also fit chat environments where the agent as tool access.
|
||||
This skill should be usable from any agent, and it should also fit chat environments where the agent has tool access.
|
||||
|
||||
## Recommended Role
|
||||
|
||||
@@ -21,6 +22,14 @@ This skill should be usable from any agent, and it should also fit chat environm
|
||||
- interactive note refinement, serendipity review, and exploratory linking sessions
|
||||
- editor-side entry point that delegates vault actions to agent where possible
|
||||
|
||||
## Bundle Awareness
|
||||
|
||||
The vault follows OKF v0.1 bundle conventions. When running curation tasks:
|
||||
|
||||
- Creating a note inside a bundle directory: add an entry to `index.md` and an event to `log.md`.
|
||||
- Modifying a note inside a bundle: update `index.md` description if the note's purpose changes; append to `log.md` for significant changes.
|
||||
- Moving notes between bundle directories: update both source and destination bundle files.
|
||||
|
||||
## Preferred Behaviors
|
||||
|
||||
- search the vault before proposing links
|
||||
@@ -29,14 +38,16 @@ This skill should be usable from any agent, and it should also fit chat environm
|
||||
- summarize edits in plain Markdown
|
||||
- ask before removing any content or links from a note
|
||||
- ask before moving, renaming, or creating many files
|
||||
- update bundle `index.md` and `log.md` when creating notes inside bundles
|
||||
|
||||
## Good Task Shapes
|
||||
|
||||
- curate a specific note
|
||||
- process a small `Inbox/` batch
|
||||
- curate a specific note (normalize frontmatter, classify type, add markdown links)
|
||||
- process a small `Inbox/` batch (classify and normalize)
|
||||
- review recent notes for missing links
|
||||
- extract atomic notes from one source note
|
||||
- run a serendipity review against a current topic
|
||||
- update or regenerate bundle `index.md` for a directory
|
||||
|
||||
## Avoid
|
||||
|
||||
@@ -44,8 +55,10 @@ This skill should be usable from any agent, and it should also fit chat environm
|
||||
- broad speculative linking passes
|
||||
- converting every long note into atomic notes
|
||||
- changing note titles without stating why
|
||||
- using `[[wikilinks]]` — always use standard markdown `[...](...)` links
|
||||
|
||||
## Portability Guidance
|
||||
|
||||
- keep the workflow in `SKILL.md` tool-agnostic where possible
|
||||
- prefer small deterministic file edits so the skill remains portable to other `SKILL.md`-based agents
|
||||
- always reference `vault-conventions.md` for the current frontmatter schema and type vocabulary
|
||||
|
||||
Reference in New Issue
Block a user