capture
Use when the user asks to read a source and make a note for it, create or find an atomic note, or check whether a note already exists or add to one that does. Triggers on "read <url> and make a note", "make a note for", "create (or find) an atomic note", "do we have notes about X
Install
npx skills add https://github.com/technicalpickles/pickled-claude-plugins/tree/main/plugins/second-brain/skills/capture
claude plugin marketplace add https://llmmart.ai/marketplace.json && claude plugin install technicalpickles-pickled-claude-plugins@llmmart
git clone https://github.com/technicalpickles/pickled-claude-plugins.git
The skills CLI installs just this skill, for any of its supported agents. Claude Code installs the whole technicalpickles/pickled-claude-plugins collection as a plugin from our marketplace. Git is the plain clone.
Skill manifest
Capture
Write a note into the vault from a source the user hands you. One arc, six steps: open (search, fetch, ask why) -> read the primary source -> create through sb -> leave it in the inbox -> link connections -> fold in follow-ups. "Read this and make a note" means all six; the connect step won't happen unless this skill runs it.
Two requests take a different path through the same skill. Decide which one you have before Step 1:
| The user wants | Path |
|---|---|
| A source written up as a new note | Steps 1-6 below |
| To know what the vault already holds ("do we have notes on X", "find notes about X") | Lookup only |
| Something added to a note that already exists ("add this to the X note", "pull up the note for X", or a "yes, extend it" to Step 1) | Extend an existing note |
Note shape: references/note-format.md. sb commands: ../obsidian/references/sb-cli.md.
Step 0: Locate the vault
npx @techpickles/sb vault info
npx @techpickles/sb config qmd-collection
Read the vault's own CLAUDE.md if you haven't this session. Its policy (destinations, status
vocabulary, disambiguation) overrides the defaults here.
Step 1: Open - search, start the fetch, ask why
Do these in order, then end the turn. Nothing is written yet.
Start reading the source in the background (Bash with
run_in_background), using the first rung of references/fetch-ladder.md. Step 2 collects the result.Search the vault while it runs, through the qmd MCP tools (shelling out to
qmdhits Metal-init failures under the sandbox):mcp__qmd__query searches: [{type: 'lex', query: '<one distinctive term>'}, {type: 'lex', query: '<another term>'}, {type: 'vec', query: '<what the note would say>'}] collections: [<from sb config qmd-collection>] intent: '<why you are searching>' rerank: falseEach
lexis one or two terms, because lex ANDs its terms. Also Glob today's inbox captures (*/11 Inbox*/<YYYYMMDD>*.md), since the qmd index lags same-day notes.Send one message with: the hits (path + snippet + why each looks strong or weak; qmd scores are only ranks), the question "what made you grab this?", and on a strong match "extend
End the turn.
Then, keyed to what you observe:
- The request already states a reason: skip the why question and carry on.
- The fetch has failed when you send the message: say so there, in one line, and ask the same questions. The why question and the hits don't wait on the fetch.
- The fetch finishes before a reply: write with
**Why I saved this:** TODO. - A strong-match question is open: wait for the reply, then write.
- qmd tools aren't loaded yet: use Grep, say it was keyword-only, and run qmd before writing.
- A qmd path starts with
second-brain/: strip that prefix to get the path on disk. - The thing's name is unfamiliar: let the fetch land before the
vecquery. - A search misses, or the user says "that isn't the one": references/search-recovery.md.
Step 2: Read the actual primary source
Never write from search snippets. If Josh names a fetch method, use it or say why you can't.
A few sites have their own playbook. Match the host; anything else goes down the ladder in references/fetch-ladder.md (lightpanda first, WebFetch last):
| Source | Playbook |
|---|---|
x.com, twitter.com |
references/sites/x.md |
youtube.com, youtu.be |
references/sites/youtube.md |
reddit.com, redd.it |
references/sites/reddit.md |
| Any other URL, PDF, connector source | references/sites/web.md, which points at the ladder |
Each playbook also names frontmatter fields to add beside source in Step 3; carry them into the
note. New site: add references/sites/<site>.md and one row here.
If you cannot reach the source, or cannot find the thing the user described, stop and say so. No URL you did not load, no title you inferred, no details from background knowledge. "I couldn't find anything matching this" beats a plausible note that is wrong.
Step 3: Create the note through sb
npx @techpickles/sb note create --source auto --title "<title>" # returns JSON with the path
Then replace the whole file at that path with this skeleton, filled in. Keep captured from sb's
scaffold; everything else in the scaffold goes. Add any site fields from the playbook to the
frontmatter beside source (see references/note-format.md).
---
status: seedling
tags: [topic-tag, another-tag]
created: YYYY-MM-DD
captured: <from sb's scaffold>
source: <the URL or file path you read>
---
# <Title, in the source's own framing>
<What it is, in a sentence or two, with an inline link to the source.>
**Why I saved this:** <the user's reason, in their words - or TODO>
<The content: 3+ parallel items become bullets with a bold lead-in; every named tool, project,
paper, or doc gets its link from the source; every sentence restates the source.>
## Related
- [[<note a search returned>]] - <why it relates>
Each slot's rules, with a worked example: references/note-format.md.
sb owns the path (inbox, timestamp, slug); hand-rolled Write paths once orphaned 46 notes.
Step 4: Leave it in the inbox for process-inbox
The note stays where sb put it: don't ask about routing, don't route it, don't mention that it needs routing. This overrides the vault's "file rough, move on" guidance, which governs notes the user files by hand. Agent-written note on request -> inbox.
The exception is a destination the user named in the conversation ("put it in 66"). Resolve it as
route does: sb vault structure, match the phrase to a real destination, then
sb note move --from "{note-path}" --to "{destination}/". Never build the path from the user's
words alone.
Step 5: Link connections, append the daily breadcrumb
Connection discovery doesn't fire on its own. Run it every time, using the Step 1 results plus a fresh search from the finished note's content. Only the note you just created changes on its own:
- Confident - add it to the new note, don't ask. The existing note is the same subject
(same tool/person/project/event, not a shared theme) or is named in the source. Add it under
## Relatedwith a few words on why, check the target's basename exists first, and sayLinked to <note>.in your summary. - Everything else is a proposal, never an action. If you can't write the "why" without the words "theme" or "similar", it's a proposal.
Then append the daily breadcrumb yourself, with no yes/no:
npx @techpickles/sb daily append --section "Links" --content "- [[<note>]] - <one-line why>"
sb creates today's daily note from the vault's template when needed and matches the existing
## Links heading. Keep it to the link line, and don't pre-check, hand-copy the template,
restructure the daily note, or verify where the line landed. Report it in one line
(Added breadcrumb to today's daily note.); if the append fails, say so. A "created": true
response means the note was seeded verbatim from the template, so leave any placeholder in it
alone.
Closing proposals
End the summary with one line per proposal, in exactly this shape:
- [high|medium|low] <action in plain words> - <reason> (<path of the existing note>)
Actions: Add a link to this note from <note>, Make a note for <thing the source cites>,
Add this to <hub or list note>, Merge with <note>?, Link <note> too?.
Confidence is how sure you are Josh would say yes, with the reason as proof. Every target is a
note a search found, named by path. Skip the block when there is nothing to propose. For deeper
backlink weaving, hand off to the connect skill.
Step 6: Fold in follow-up research on the note you just wrote
If right after capture the user asks about the thing the note covers ("is there a release date yet?"), answer and then update the note with the answer, rather than leaving it stale in chat. Say what you added in one line. This stops at a genuinely new note or source.
Lookup only: "do we have notes on X"
The user wants to know what's in the vault, not to write anything. Run Step 0 and the Step 1 search (qmd, today's inbox Glob), and skip the fetch and the why question, since there is no source.
- Show the hits in one message: path + snippet, and a few words on why each looks strong or weak. qmd scores are only ranks, so don't quote them as relevance.
- Then offer, one line: "Extend
- Stop. Nothing is written, no breadcrumb, no closing proposals. Never suggest a new folder, hub, or note beyond the one the user asked about.
If they say yes, you're on the new-note arc (Steps 1-6, reusing these hits) or the extend path.
Extend an existing note
The right move is often to edit a note that's already there (a stub, or a note on the same subject), not to mint a second one. Skip Steps 3 and 4; the rest of the arc applies.
Read the existing note first, and the real source (Step 2 still applies).
Edit in place with Edit, not sb. sb only creates. The note keeps its path and folder: don't move it, don't rename it, don't touch
statusor its frontmatter beyond what the new content needs.Put the content where it belongs. Under an existing heading that fits, else a new
##section before## Related. Add only what the source says, with the same links and no-invention rules as references/note-format.md. Leave what's already there alone, and don't add a second**Why I saved this:**.Confident links follow Step 5: same subject or named in the source, under the note's
## Related, skipping any already there.Breadcrumb as in Step 5, but with
updatedso the daily note doesn't read like a new note:npx @techpickles/sb daily append --section "Links" --content "- [[<note>]] - updated: <what you added>"Closing proposals use the same block as Step 5. "Merge with
Several candidate notes? Edit the strongest one and propose the rest, unless the user said to cover them all.
Capturing several sources at once
For a batch of 3+ sources, dispatch one subagent per note, then do the cross-linking and closing proposals yourself. How: references/batch.md.
Constraints
- Only the new note (or the one you were asked to extend) changes without a yes. Confident links go inside it and the breadcrumb is automatic. A lookup changes nothing. Every other note edit and every new side note is a closing proposal, unless the user's phrasing already covers the whole batch.
- Never fabricate. No invented URLs, no unverified
[[links]], no filled-in details. - One note, one idea. If the source carries several distinct ideas, say so and offer to split.
Files (pickled-claude-plugins)
-
evals
-
results
-
2026-08-14-no-pointer.json 2.4 KB
Loading… -
2026-08-14-pointer-scoped-to-create.json 4.5 KB
Loading… -
2026-08-14-pointer-widened.json 4.5 KB
Loading… -
2026-09-19-site-baseline.json 1.2 KB
Loading… -
2026-09-19-site-pointer.json 5.4 KB
Loading…
-
-
scenarios
-
no-route-offer
-
scenario.yaml 6.6 KB
Loading…
-
-
-
eval_config.yaml 1.6 KB
Loading… -
README.md 7.3 KB
Loading… -
trigger-evals.json 4.9 KB
Loading… -
trigger_eval.py 8.2 KB
Loading…
-
-
references
-
sites
-
reddit.md 1.6 KB
Loading… -
web.md 595 B
Loading… -
x.md 1.2 KB
Loading… -
youtube.md 2.1 KB
Loading…
-
-
batch.md 1.4 KB
Loading… -
fetch-ladder.md 2.2 KB
Loading… -
note-format.md 5.4 KB
Loading… -
search-recovery.md 907 B
Loading…
-
-
SKILL.md 12.8 KB
--- name: capture description: Use when the user asks to read a source and make a note for it, create or find an atomic note, or check whether a note already exists or add to one that does. Triggers on "read <url> and make a note", "make a note for", "create (or find) an atomic note", "do we have notes about X?", "check if we have a note for", "capture this", "put together a note", "distill this", and on a bare URL/PDF/tweet/thread handed over with intent to write it up. Use inside an Obsidian vault or anywhere a vault is configured. Do NOT use for draining an accumulated inbox backlog (that is process-inbox), for extracting insights from the current conversation (that is devlog), or for routing already-captured notes to their homes (that is route). allowed-tools: - Read - Write(~/.claude/vaults/**/*.md) - Edit(~/.claude/vaults/**/*.md) - Glob - Grep - Bash(npx @techpickles/sb:*) - Bash(xtweet:*) - Bash(reddit-post:*) - Bash(yt-digest:*) - mcp__qmd__query - mcp__qmd__get - mcp__qmd__multi_get - mcp__qmd__status hooks: PreToolUse: - matcher: "Bash" hooks: - type: command command: "python3 \"${CLAUDE_PLUGIN_ROOT}\"/hooks/check-sb-before-call.py" - matcher: "WebFetch" hooks: - type: command command: "python3 \"${CLAUDE_PLUGIN_ROOT}\"/hooks/webfetch-prefer-lightpanda.py" --- # Capture Write a note into the vault from a source the user hands you. One arc, six steps: **open (search, fetch, ask why) -> read the primary source -> create through sb -> leave it in the inbox -> link connections -> fold in follow-ups.** "Read this and make a note" means all six; the connect step won't happen unless this skill runs it. Two requests take a different path through the same skill. Decide which one you have before Step 1: | The user wants | Path | |---|---| | A source written up as a new note | Steps 1-6 below | | To know what the vault already holds ("do we have notes on X", "find notes about X") | [Lookup only](#lookup-only-do-we-have-notes-on-x) | | Something added to a note that already exists ("add this to the X note", "pull up the note for X", or a "yes, extend it" to Step 1) | [Extend an existing note](#extend-an-existing-note) | Note shape: [references/note-format.md](references/note-format.md). sb commands: [../obsidian/references/sb-cli.md](../obsidian/references/sb-cli.md). ## Step 0: Locate the vault ```bash npx @techpickles/sb vault info npx @techpickles/sb config qmd-collection ``` Read the vault's own `CLAUDE.md` if you haven't this session. Its policy (destinations, status vocabulary, disambiguation) overrides the defaults here. ## Step 1: Open - search, start the fetch, ask why Do these in order, then end the turn. Nothing is written yet. 1. **Start reading the source in the background** (Bash with `run_in_background`), using the first rung of [references/fetch-ladder.md](references/fetch-ladder.md). Step 2 collects the result. 2. **Search the vault while it runs,** through the qmd MCP tools (shelling out to `qmd` hits Metal-init failures under the sandbox): ``` mcp__qmd__query searches: [{type: 'lex', query: '<one distinctive term>'}, {type: 'lex', query: '<another term>'}, {type: 'vec', query: '<what the note would say>'}] collections: [<from sb config qmd-collection>] intent: '<why you are searching>' rerank: false ``` Each `lex` is one or two terms, because lex ANDs its terms. Also Glob today's inbox captures (`*/11 Inbox*/<YYYYMMDD>*.md`), since the qmd index lags same-day notes. 3. **Send one message** with: the hits (path + snippet + why each looks strong or weak; qmd scores are only ranks), the question "what made you grab this?", and on a strong match "extend <note> or start a new one?". 4. **End the turn.** Then, keyed to what you observe: - **The request already states a reason:** skip the why question and carry on. - **The fetch has failed when you send the message:** say so there, in one line, and ask the same questions. The why question and the hits don't wait on the fetch. - **The fetch finishes before a reply:** write with `**Why I saved this:** TODO`. - **A strong-match question is open:** wait for the reply, then write. - **qmd tools aren't loaded yet:** use Grep, say it was keyword-only, and run qmd before writing. - **A qmd path starts with `second-brain/`:** strip that prefix to get the path on disk. - **The thing's name is unfamiliar:** let the fetch land before the `vec` query. - **A search misses, or the user says "that isn't the one":** [references/search-recovery.md](references/search-recovery.md). ## Step 2: Read the actual primary source Never write from search snippets. If Josh names a fetch method, use it or say why you can't. A few sites have their own playbook. Match the host; anything else goes down the ladder in [references/fetch-ladder.md](references/fetch-ladder.md) (lightpanda first, WebFetch last): | Source | Playbook | |--------|----------| | `x.com`, `twitter.com` | [references/sites/x.md](references/sites/x.md) | | `youtube.com`, `youtu.be` | [references/sites/youtube.md](references/sites/youtube.md) | | `reddit.com`, `redd.it` | [references/sites/reddit.md](references/sites/reddit.md) | | Any other URL, PDF, connector source | [references/sites/web.md](references/sites/web.md), which points at the ladder | Each playbook also names frontmatter fields to add beside `source` in Step 3; carry them into the note. New site: add `references/sites/<site>.md` and one row here. **If you cannot reach the source, or cannot find the thing the user described, stop and say so.** No URL you did not load, no title you inferred, no details from background knowledge. "I couldn't find anything matching this" beats a plausible note that is wrong. ## Step 3: Create the note through sb ```bash npx @techpickles/sb note create --source auto --title "<title>" # returns JSON with the path ``` Then replace the whole file at that path with this skeleton, filled in. Keep `captured` from sb's scaffold; everything else in the scaffold goes. Add any site fields from the playbook to the frontmatter beside `source` (see [references/note-format.md](references/note-format.md#site-fields)). ```markdown --- status: seedling tags: [topic-tag, another-tag] created: YYYY-MM-DD captured: <from sb's scaffold> source: <the URL or file path you read> --- # <Title, in the source's own framing> <What it is, in a sentence or two, with an inline link to the source.> **Why I saved this:** <the user's reason, in their words - or TODO> <The content: 3+ parallel items become bullets with a bold lead-in; every named tool, project, paper, or doc gets its link from the source; every sentence restates the source.> ## Related - [[<note a search returned>]] - <why it relates> ``` Each slot's rules, with a worked example: [references/note-format.md](references/note-format.md). **sb owns the path** (inbox, timestamp, slug); hand-rolled `Write` paths once orphaned 46 notes. ## Step 4: Leave it in the inbox for `process-inbox` The note stays where sb put it: don't ask about routing, don't route it, don't mention that it needs routing. This overrides the vault's "file rough, move on" guidance, which governs notes the user files by hand. **Agent-written note on request -> inbox.** The exception is a destination the user named in the conversation ("put it in 66"). Resolve it as `route` does: `sb vault structure`, match the phrase to a real destination, then `sb note move --from "{note-path}" --to "{destination}/"`. Never build the path from the user's words alone. ## Step 5: Link connections, append the daily breadcrumb Connection discovery doesn't fire on its own. **Run it every time**, using the Step 1 results plus a fresh search from the finished note's content. Only the note you just created changes on its own: - **Confident - add it to the new note, don't ask.** The existing note is the **same subject** (same tool/person/project/event, not a shared theme) or is **named in the source**. Add it under `## Related` with a few words on *why*, check the target's basename exists first, and say `Linked to <note>.` in your summary. - **Everything else is a proposal,** never an action. If you can't write the "why" without the words "theme" or "similar", it's a proposal. Then append the daily breadcrumb yourself, with no yes/no: ```bash npx @techpickles/sb daily append --section "Links" --content "- [[<note>]] - <one-line why>" ``` `sb` creates today's daily note from the vault's template when needed and matches the existing `## Links` heading. Keep it to the link line, and don't pre-check, hand-copy the template, restructure the daily note, or verify where the line landed. Report it in one line (`Added breadcrumb to today's daily note.`); if the append fails, say so. A `"created": true` response means the note was seeded verbatim from the template, so leave any placeholder in it alone. ### Closing proposals End the summary with one line per proposal, in exactly this shape: ``` - [high|medium|low] <action in plain words> - <reason> (<path of the existing note>) ``` Actions: `Add a link to this note from <note>`, `Make a note for <thing the source cites>`, `Add this to <hub or list note>`, `Merge with <note>?`, `Link <note> too?`. Confidence is how sure you are Josh would say yes, with the reason as proof. Every target is a note a search found, named by path. Skip the block when there is nothing to propose. For deeper backlink weaving, hand off to the `connect` skill. ## Step 6: Fold in follow-up research on the note you just wrote If right after capture the user asks about the thing the note covers ("is there a release date yet?"), answer and then **update the note** with the answer, rather than leaving it stale in chat. Say what you added in one line. This stops at a genuinely new note or source. ## Lookup only: "do we have notes on X" The user wants to know what's in the vault, not to write anything. Run Step 0 and the Step 1 search (qmd, today's inbox Glob), and skip the fetch and the why question, since there is no source. 1. **Show the hits** in one message: path + snippet, and a few words on why each looks strong or weak. qmd scores are only ranks, so don't quote them as relevance. 2. **Then offer, one line:** "Extend <note>?" when a hit is on the subject, "Want me to start one?" when nothing is. A miss follows [references/search-recovery.md](references/search-recovery.md) first. 3. **Stop.** Nothing is written, no breadcrumb, no closing proposals. Never suggest a new folder, hub, or note beyond the one the user asked about. If they say yes, you're on the new-note arc (Steps 1-6, reusing these hits) or the extend path. ## Extend an existing note The right move is often to edit a note that's already there (a stub, or a note on the same subject), not to mint a second one. Skip Steps 3 and 4; the rest of the arc applies. - **Read the existing note first, and the real source** (Step 2 still applies). - **Edit in place with Edit, not sb.** sb only creates. The note keeps its path and folder: don't move it, don't rename it, don't touch `status` or its frontmatter beyond what the new content needs. - **Put the content where it belongs.** Under an existing heading that fits, else a new `##` section before `## Related`. Add only what the source says, with the same links and no-invention rules as [references/note-format.md](references/note-format.md). Leave what's already there alone, and don't add a second `**Why I saved this:**`. - **Confident links** follow Step 5: same subject or named in the source, under the note's `## Related`, skipping any already there. - **Breadcrumb** as in Step 5, but with `updated` so the daily note doesn't read like a new note: ```bash npx @techpickles/sb daily append --section "Links" --content "- [[<note>]] - updated: <what you added>" ``` - **Closing proposals** use the same block as Step 5. "Merge with <note>?" and "Add this to <hub>" don't apply to the note you just extended; a second existing note that also fits is a proposal, not an edit. - **Several candidate notes?** Edit the strongest one and propose the rest, unless the user said to cover them all. ## Capturing several sources at once For a batch of 3+ sources, dispatch one subagent per note, then do the cross-linking and closing proposals yourself. How: [references/batch.md](references/batch.md). ## Constraints - **Only the new note (or the one you were asked to extend) changes without a yes.** Confident links go inside it and the breadcrumb is automatic. A lookup changes nothing. Every other note edit and every new side note is a closing proposal, unless the user's phrasing already covers the whole batch. - **Never fabricate.** No invented URLs, no unverified `[[links]]`, no filled-in details. - **One note, one idea.** If the source carries several distinct ideas, say so and offer to split.
Comments (0)
Sign in to join the conversation.
Reviews (0)
No reviews yet.
No comments yet.