relferreira/brain-dump

Overview

This skill captures URLs, text, and images into a personal Markdown-based knowledge base stored in ~/.brain-dump/. It provides quick commands to save, list, search, and learn from saved items, turning scattered notes into reusable, searchable content. Use it to archive web pages, visual assets, and ad-hoc notes with automatic summaries and tags.

How this skill works

The skill detects the input type (list, search, learn, URL, image, or text) and runs the appropriate flow. For URLs it fetches the main content, creates a summarized Markdown file with frontmatter, and saves the source. For images it copies the asset, generates a description and tags, then writes a Markdown note linking the asset. For text it summarizes long content or saves short notes and generates titles/tags. It always uses the full expanded home path (not ~) and produces safe, deduplicated filenames.

When to use it

• Save a web article quickly: "/brain-dump https://example.com/article"
• Capture a local image with description: "/brain-dump /path/to/photo.jpg"
• Store a quick note or long text: "/brain-dump <your text>"
• Find prior entries: "/brain-dump search <query>"
• Turn saved content into a short lesson and quiz: "/brain-dump learn"
• See recent saves: "/brain-dump" (no arguments)

Best practices

• Always rely on the full $HOME path for file operations (echo $HOME) instead of ~.
• Write clear titles or paste context so automatic filename generation produces readable names.
• Use short tags or one-word labels; the skill normalizes them to lowercase.
• Run /brain-dump learn regularly to reinforce weak or new dumps tracked in learn-history.json.
• When saving many items programmatically, check for filename collisions documented in confirmations.

Example use cases

• Save a research article and get a 2–4 sentence summary plus tags for later review.
• Archive meeting notes or pasted text; long notes are summarized with the original appended.
• Import screenshots or photos, get an automatic description and image-backed note.
• Search across all saved Markdown dumps for quick retrieval of facts or quotes.
• Use learn random to practice and quiz yourself on new and weak items from your knowledge base.