ZK-Note

Transform markdown into a fully integrated Zettelkasten literature note.

Input

$ARGUMENTS — <path-to-markdown-file> [domain]

Optional domain: cs/web/ai/principle/devops/math

Execution Order

This skill orchestrates two agents in sequence:

Source File
    │
    ▼
┌─────────────────────────┐
│  zettelkasten-agent      │  Opus — deep reasoning
│  (analyze & synthesize)  │
│                          │
│  → atomic concept        │
│  → domain classification │
│  → Feynman explanations  │
│  → relationship rationale│
└──────────┬──────────────┘
           │ analysis results
           ▼
┌─────────────────────────┐
│  obsidian-formatter-agent│  Sonnet — mechanical
│  (format & integrate)    │
│                          │
│  → Train-Case filename   │
│  → frontmatter + nav     │
│  → assemble note file    │
│  → update neighbors      │
│  → update MOCs           │
└──────────┬──────────────┘
           │
           ▼
      Cleanup & Report

Step 1: Read Source

Read the markdown file from the provided path. Extract the source URL if present in the file.

Step 2: Delegate to zettelkasten-agent (Analysis)

Use the Task tool to delegate to general-purpose subagent:

Prompt: "You are delegated to act as the zettelkasten-agent agent.

Read the agent instructions at: ~/.claude/agents/zettelkasten-agent.md

Then analyze this source content for Zettelkasten integration:
Source file: <path>
Vault root: <vault_root>
[Domain: <domain> — if provided by user]

Return a structured analysis:
- domain
- concept (atomic concept name)
- key_insights (bullet points)
- source_url
- abstract (formatted abstract section)
- content_sections (fully written sub-sections with Feynman explanations and code examples)
- related_notes (list of [[Note]] — rationale pairs)"

If the zettelkasten-agent asks about domain, relay the question to the user.

Step 3: Delegate to obsidian-formatter-agent (Integration)

Use the Task tool to delegate to general-purpose subagent:

Prompt: "You are delegated to act as the obsidian-formatter-agent agent.

Read the agent instructions at: ~/.claude/agents/obsidian-formatter-agent.md
Read the formatting rules at: ~/.claude/prompts/obsidian-note.prompt.md

Then format and integrate this literature note:

Domain: <domain from step 2>
Concept: <concept from step 2>
Abstract: <abstract from step 2>
Content sections: <content_sections from step 2>
Related notes: <related_notes from step 2>
Source URL: <source_url from step 2>
Source file: <source_file>
Today's date: <today's date>
Vault root: <vault_root>

Return:
- Note path and filename
- Neighbors updated
- MOCs updated"

Step 4: Cleanup & Report

Delete the source file from zz.original-source/.

Report completion:

✅ Zettelkasten note created
📄 Location: <domain>/<filename>.md
🔗 Links: <backlinks added>
📑 MOC updates: <MOCs modified>
🔄 Navigation: Before→<note>→Next

Output

• Note path: <domain>/<Domain-Concept-In-Train-Case>.md
• Backlinks: List of related notes linked
• MOC updates: List of MOCs modified
• Navigation: Before/Next files updated

Error Handling

Source file not found:

• Report the path that was tried
• Ask user to verify path

Domain unclear (from zettelkasten-agent):

• Present content summary
• Ask user to specify domain from: cs/web/ai/principle/devops/math

Analysis fails:

• Report error from zettelkasten-agent
• Abort workflow

Formatting fails:

• Report error from obsidian-formatter-agent
• Note: analysis is not lost, user can retry step 3

No related notes found:

• Proceed — Links section will be empty
• Warn user that no backlinks were added

MOC missing:

• Ask user: "Create new MOC or skip MOC update?"
• Proceed based on user choice