# Orphan Note Connector

> Find unlinked notes and suggest relevant semantic connections to other notes in the vault.

- **Type:** Skill
- **Install:** `agentstack add skill-tpitsunov-obsidian-skills-orphan-connector`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [tpitsunov](https://agentstack.voostack.com/s/tpitsunov)
- **Installs:** 0
- **Category:** [Security](https://agentstack.voostack.com/c/security)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [tpitsunov](https://github.com/tpitsunov)
- **Source:** https://github.com/tpitsunov/obsidian-skills/tree/main/orphan_connector

## Install

```sh
agentstack add skill-tpitsunov-obsidian-skills-orphan-connector
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Orphan Note Connector Workflow

When the user uses the slash command `/orphans` or asks to connect an orphan note or find connections for a specific note, follow these steps:

1. **Find Orphans**: If the user didn't specify a target note and just wants to see their orphans, **use the included Python script** to deterministically scan the vault for isolated files. Execute:
   ```bash
   python /absolute/path/to/Obsidian-AI-Skills/orphan_connector/scripts/find_orphans.py "/absolute/path/to/vault"
   ```
   Show the output to the user and ask which orphan they would like to connect.
2. **Read the Target Note**: Once an orphan is selected, read the target note thoroughly to understand its context.
3. **Extract Entities & Themes**: Identify the main keywords, named entities (characters, locations, organizations, concepts), and overarching themes in the text.
4. **Search the Vault**: Search the workspace for the extracted keywords and entities to find other notes that mention them but are not currently linked.
5. **Determine Connections**: Select the 3-5 most conceptually relevant notes from the search results.
6. **Propose Links**: Inform the user about the suggested connections. Explain *why* these notes should be linked and show a snippet of how the text could be changed to include a wiki-link `[[Target Note]]`.
7. **Apply Changes**: Upon user confirmation, edit the file to insert the wiki-links directly into the text. You can either turn existing words into links or add a 'Related:' section at the bottom.

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [tpitsunov](https://github.com/tpitsunov)
- **Source:** [tpitsunov/obsidian-skills](https://github.com/tpitsunov/obsidian-skills)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-tpitsunov-obsidian-skills-orphan-connector
- Seller: https://agentstack.voostack.com/s/tpitsunov
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.