zkfy-marketplace

zkfy

A Claude Code plugin that transforms unstructured content (URLs, videos, raw text) into structured Zettelkasten literature notes for Obsidian vaults.

What It Does

zkfy automates the process of converting web content, YouTube videos, and raw text into well-structured Zettelkasten literature notes:

• Extracts content from URLs, YouTube videos, or plain text
• Generates clean Markdown following your formatting rules
• Integrates into your vault with proper frontmatter, backlinks, and navigation
• Updates Maps of Content (MOCs) automatically
• Creates bidirectional links between related notes

Features

Multi-Phase Pipeline

INPUT → [VIDEO TRANSCRIPTION] → MARKDOWN GENERATION → ZETTELKASTEN INTEGRATION → OUTPUT

1. Phase 0 (Conditional): Extract video transcripts from YouTube/Vimeo
2. Phase 1: Convert content to clean, formatted Markdown
3. Phase 2: Integrate into vault with proper Zettelkasten structure

Specialized Agents

• video-agent: Fetches video transcripts
• markdown-file-agent: Extracts and converts content
• diagram-agent: Creates Mermaid diagrams for complex concepts
• zettelkasten-agent: Handles vault integration, frontmatter, and linking

Smart Features

• Zero data loss: Preserves all source content during transformation
• Automatic domain detection: Places notes in correct folders (cs/, web/, ai/, etc.)
• Navigation links: Generates Before/Next frontmatter for sequential reading
• Diagram generation: Creates visual aids for complex topics
• Progress tracking: Visual feedback for each pipeline phase

Installation

Prerequisites

• Claude Code CLI
• An Obsidian vault with proper folder structure

Required Vault Structure

Your Obsidian vault must contain these folders:

your-vault/
├── cs/                    # Computer Science notes
├── web/                   # Web development notes
├── ai/                    # AI/ML notes
├── principle/             # Principle notes
├── devops/                # DevOps notes
├── math/                  # Math notes
├── 000.Index/             # Maps of Content (MOCs)
└── zz.original-source/    # Source staging area

Install Plugin

# Clone the repository
git clone https://github.com/jasonsie/zkfy.git
cd zkfy

# Link to Claude Code plugins directory
ln -s "$PWD" ~/.claude/plugins/zkfy

# Create required prompt files
mkdir -p ~/.claude/prompts
touch ~/.claude/prompts/crawler.prompt.md
touch ~/.claude/prompts/obsidian-note.prompt.md

Configure Prompts

Create these prompt files with your formatting rules:

~/.claude/prompts/crawler.prompt.md - Markdown formatting rules for content extraction

~/.claude/prompts/obsidian-note.prompt.md - Zettelkasten literature note structure rules

Usage

Basic Command

# Navigate to your Obsidian vault
cd /path/to/your/vault

# Run zkfy with a source
/source-to-zk <url-or-text-or-file>

Examples

# From a YouTube video
/source-to-zk https://www.youtube.com/watch?v=dQw4w9WgXcQ

# From a web article
/source-to-zk https://example.com/article

# From raw text
/source-to-zk "Your content here..."

# From a file
/source-to-zk /path/to/source.txt

Output

The plugin generates:

1. Source file: Saved to zz.original-source/ with original content
2. Literature note: Placed in appropriate domain folder (e.g., web/, ai/)
3. Updated neighbors: Before/Next links updated in adjacent notes
4. MOC updates: Relevant Maps of Content updated with new entry

Note Structure

Generated notes follow this format:

---
Date: 2026-02-10
Type: literature
Categories: [Web, React]
Sub-Categories: [Hooks, State Management]
Aliases: [React Hooks, useState]
Before: '[[Web-Previous-Note]]'
Next: '[[Web-Next-Note]]'
Link: 'https://source-url.com'
Src: '[[zz.original-source/20260210-source]]'
---

# Note Title

## Abstract

- Key point 1
- Key point 2
- Key point 3

## Section 1: Main Concept

Content with code examples...

## Section 2: Related Concept

More content...

## Links

- [[Related-Note]] - Explanation of relationship

File Naming Convention

All notes use Train-Case naming:

Domain-Concept-Name-In-Train-Case.md

Examples:

• Web-React-Server-Components.md
• CS-Binary-Search-Tree.md
• AI-Transformer-Architecture.md

Architecture

Component Structure

zkfy/
├── plugin.json              # Plugin manifest
├── commands/
│   └── source-to-zk.md     # Main orchestration command
├── agents/
│   ├── video-agent.md
│   ├── markdown-file-agent.md
│   ├── diagram-agent.md
│   ├── ascii-diagram-agent.md
│   └── zettelkasten-agent.md
├── skills/
│   └── terminal-colors/    # Reusable output formatting
└── hooks/
    ├── hooks.json          # Event-based automation
    └── validate-zk-structure.sh

Agent Delegation