Turn an external source (article, video, PDF, voice memo) into a clean vault note: extract → summarize → propose filing. Do not write without an OK.
Procedure
1. Extract clean content (reuse tools, don't reimplement)
By source type:
- Web article / blog → a clean-extraction skill if you have one (e.g. an
Obsidian/defuddle-style markdown extractor). Fallback: WebFetch. For
.mdURLs use WebFetch directly. - YouTube / PDF / DOCX / PPTX / image → a markdown converter if available (e.g. markitdown: YouTube yields the transcript, PDF/DOCX the text).
- Audio / voice memo → a transcription tool (e.g. a Whisper-based CLI).
If extraction fails, say so — do not invent content.
2. Summary (not a transcript)
- 3–6 bullet points of what matters most + one sentence on "why this is relevant to the user".
- Keep key numbers/names/URLs verbatim; mark author claims as claims.
- Cite the source (URL/channel/author) — every fact must be traceable.
3. Propose filing (GTD-style triage)
| Criterion | Target |
|---|---|
| Reference/guide/material (not actionable) | resources/ (or your reference folder) |
| Deadline + multiple steps | your projects folder (offer it; rare) |
| Unclear / to be sorted | inbox/ |
Propose a concrete path + file name (kebab-case, no diacritics) and the note body:
---
tags: [domain, subtype]
status: active
created: YYYY-MM-DD
source: <URL or origin>
---
# <Title>
<summary>
## Source
<URL / channel / author>
If your vault uses [[wikilinks]], add 1–2 links to existing related notes — find
them, don't guess them.
4. Propose → OK → write
List the target path + content, wait for the OK. After writing you can suggest
verify-before-done.
Conventions
- Kebab-case without diacritics, no placeholders, absolute dates.
- Frontmatter per your vault's convention (e.g.
tags/status/created). - Prefer a tight summary over a long transcript — the vault is for future you, not an archive of raw text.