Claude Skill

connect

Find related notes via semantic search and weave links. Stage 4 of the processing pipeline.

LLM Mart · 0 points · 0 views 0 listing impressions 0 install-command copies
Download technicalpickles-pickled-claude-plugins-plugins_second-brain_skills_connect-85f769c.zip · 1 KB

Install

skills CLI npx skills add https://github.com/technicalpickles/pickled-claude-plugins/tree/main/plugins/second-brain/skills/connect
Claude Code claude plugin marketplace add https://llmmart.ai/marketplace.json && claude plugin install technicalpickles-pickled-claude-plugins@llmmart
Git 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

  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:

    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)
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.

No comments yet.

Reviews (0)

No reviews yet.