connect
Find related notes via semantic search and weave links. Stage 4 of the processing pipeline.
Install
npx skills add https://github.com/technicalpickles/pickled-claude-plugins/tree/main/plugins/second-brain/skills/connect
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
Connect Stage
Find related notes via semantic search (qmd) and weave forward/backward links.
See ../obsidian/references/pipeline.md for stage definitions and status flow.
See ../obsidian/references/connecting.md for the connection discovery algorithm.
Input
A routed note with status: routed.
Process
Check qmd availability: the
mcp__qmd__querytool if it is loaded, elsewhich qmd. If neither is available, log "Skipped connections: qmd not available", setstatus: connected, and return.Extract query terms from the note's title and body
Run semantic search with reranking off, through
mcp__qmd__query(collections,limit: 15,rerank: false) or the CLI:qmd query "{terms}" -c {collection} -n 15 --json --no-rerankFilter and rank per
../obsidian/references/connecting.md:- Remove self
- Remove already-linked notes
- Remove daily notes
- Remove weak matches, judged from the snippet (qmd scores are ranks, not a relevance scale)
If candidates found, present to human (when called by orchestrator):
- Show each candidate with its snippet and a few words on why it looks like a strong or weak match
- Let user multi-select which to connect
For selected connections:
- Add
## Relatedsection to the note with wiki-links - Offer backlink weaving for notes that have See Also/Related/TK sections
- Add
Update status to
connected
Output
- Note with
## Relatedsection added (if connections found) status: connected
Constraints
- Graceful skip if qmd unavailable (always log that it was skipped)
- The note being processed won't be in qmd's index yet. Search FROM its content, not for it.
- Don't add connections the user didn't approve
- Backlink weaving is optional (offer, don't force)
Files (pickled-claude-plugins)
-
SKILL.md 2.2 KB
--- name: connect description: Find related notes via semantic search and weave links. Stage 4 of the processing pipeline. allowed-tools: - Read(~/.claude/vaults/**/*.md) - Write(~/.claude/vaults/**/*.md) - Edit(~/.claude/vaults/**/*.md) - Bash(which:qmd) - Bash(qmd:query *) - Bash(qmd:collection list) - Bash(qmd:get *) - Bash(qmd:status) - mcp__qmd__query - mcp__qmd__get --- # Connect Stage Find related notes via semantic search (qmd) and weave forward/backward links. See `../obsidian/references/pipeline.md` for stage definitions and status flow. See `../obsidian/references/connecting.md` for the connection discovery algorithm. ## Input A routed note with `status: routed`. ## Process 1. Check qmd availability: the `mcp__qmd__query` tool if it is loaded, else `which qmd`. If neither is available, log "Skipped connections: qmd not available", set `status: connected`, and return. 2. Extract query terms from the note's title and body 3. Run semantic search with reranking off, through `mcp__qmd__query` (`collections`, `limit: 15`, `rerank: false`) or the CLI: ```bash qmd query "{terms}" -c {collection} -n 15 --json --no-rerank ``` 4. Filter and rank per `../obsidian/references/connecting.md`: - Remove self - Remove already-linked notes - Remove daily notes - Remove weak matches, judged from the snippet (qmd scores are ranks, not a relevance scale) 5. If candidates found, present to human (when called by orchestrator): - Show each candidate with its snippet and a few words on why it looks like a strong or weak match - Let user multi-select which to connect 6. For selected connections: - Add `## Related` section to the note with wiki-links - Offer backlink weaving for notes that have See Also/Related/TK sections 7. Update status to `connected` ## Output - Note with `## Related` section added (if connections found) - `status: connected` ## Constraints - Graceful skip if qmd unavailable (always log that it was skipped) - The note being processed won't be in qmd's index yet. Search FROM its content, not for it. - Don't add connections the user didn't approve - Backlink weaving is optional (offer, don't force)
Comments (0)
Sign in to join the conversation.
Reviews (0)
No reviews yet.
No comments yet.