zettel-brainstormer

# Zettel Brainstormer 🧠

This skill formalizes the process of taking a rough idea or draft and enriching it with deep research, diverse perspectives, and structured brainstorming.

The configuration file is `config/models.json`, which can be edited manually or using the `setup.py` script.

## New 3-Stage Workflow

This skill now supports a 3-stage pipeline to balance cost and quality:

1) Find References (with `find_links.py`)

- Run `scripts/find_links.py` to identify relevant existing notes.
  - **Wikilinked documents** (follows [[wikilinks]] N levels deep, up to M total docs)
  - **Tag-similar documents** (finds notes with overlapping tags)
  - **Native Obsidian Integration**: Uses `obsidian-cli` for high-performance indexing and discovery if available.
  - **Semantic Discovery (Optional)**: Can leverage the `zettel-link` skill for finding "hidden" conceptual connections that don't share explicit tags or links.
- Output: A JSON list of absolute file paths to relevant notes.

2) Subagent: Preprocess contents (with `preprocess_model`)

- The agent iterates through the list of files found in Stage 1.
- For each file:
  - Read the file content.
  - Apply `templates/preprocess.md` using the `preprocess_model`, pass the seed note keypoints and file content as context.
  - Extract: Relevance score, Summary, Key Points, and Quotes.
  - Output: A structured markdown summary of the note.

3) Draft & Humanize (with `pro_model`)

- Gather all preprocessed markdown outputs from Stage 2.
- Apply `templates/draft.md` using the `pro_model`.
- Synthesize points, add proper Obsidian properties, tags, and links.
- Uses the `obsidian` skill if available to match style.

## Files & Scripts

This skill includes the following resources under the skill folder:

- `scripts/find_links.py`  -- finds relevant note paths (linked + tag similar)
- `scripts/draft_prompt.py` -- (Deprecated) generate prompt for agent
- `scripts/obsidian_utils.py` -- shared utilities for wikilink extraction
- `te...

# Zettel Brainstormer

An AI-powered skill for expanding **Zettelkasten** notes into comprehensive writing drafts.

## Overview

This skill provides a **3-stage pipeline** to transform your atomic notes into a coherent draft:
1.  **Find Links**: Scans a seed note and identifies connections. Supports:
    - **Standard**: Wikilinks and Tag matching.
    - **`obsidian-cli` (Recommended)**: Uses the native CLI for fast vault indexing.
    - **`zettel-link` (Optional)**: Semantic discovery for "hidden" connections without explicit links.
2.  **Preprocess**: Reads the files and context to generate a high-quality Markdown outline using a sub-agent.
3.  **Draft**: Reads the outline and context to generate a high-quality Markdown draft using a Pro LLM.

## Documentation

**👉 See [SKILL.md](SKILL.md) for full installation, configuration, and usage instructions.**

## Quick Start

### Prerequisites
-   Python 3.10+
-   Your favorite AI Agent system (OpenCode, Cursor, OpenClaw, etc.)
-   Optionally, `OPENAI_API_KEY` (or OpenRouter key) set in environment.

### Installation
```bash
# Clone repository
npx skills install https://github.com/hxy9243/skills/blob/main/zettel-brainstormer/
```

### Usage

1. Prompt your AI Agent to configure the skill.
2. Prompt your AI Agent to run the skill.


## License
MIT