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:
2026-07-06 21:34:55 -04:00
parent 41d1d48025
commit de4f6f137b
5 changed files with 354 additions and 105 deletions
@@ -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