Skip to main content
ClaudeWave
Skill1.5k repo starsupdated 3mo ago

search

This Claude Code skill enables rapid keyword searching across Obsidian vault markdown files using Grep pattern matching, returning results organized by directory without requiring indexes or plugins. Use it when you need to find specific content, keywords, or tags scattered throughout your vault notes, particularly for locating references to projects, goals, daily entries, or archived information.

Install in Claude Code
Copy
git clone --depth 1 https://github.com/ballred/obsidian-claude-pkm /tmp/search && cp -r /tmp/search/vault-template/.claude/skills/search ~/.claude/skills/search
Then start a new Claude Code session; the skill loads automatically.

SKILL.md

# Search Skill

Fast keyword search across all vault markdown files using the Grep tool. No indexes, no plugins, no setup — just structured search with directory grouping.

## Usage

```
/search <term>
```

Examples:
- `/search project planning`
- `/search weekly review`
- `/search TODO`

## How to Execute

When the user invokes `/search <term>`:

### Step 1: Search for the term

Use the **Grep** tool to search all `.md` files for the term:

```
Grep:
  pattern: <search term>
  glob: "*.md"
  output_mode: content
  -n: true
  -C: 1
```

Exclude hidden directories (`.claude/`, `.obsidian/`) and templates:

```
Grep:
  pattern: <search term>
  glob: "*.md"
  path: .
  output_mode: content
  -n: true
  -C: 1
```

Filter out results from `.claude/`, `.obsidian/`, and `Templates/` directories.

### Step 2: Group results by directory

Organise matches into sections by their parent directory:

- **Daily Notes/** — journal entries
- **Goals/** — goal and vision documents
- **Projects/** — project notes
- **Archives/** — archived content
- **Inbox/** — unprocessed items
- **(root)** — top-level notes

### Step 3: Present results

Format output as:

```markdown
## Search: "<term>"

### Daily Notes/
- **2024-01-15.md** (line 23): ...matching context...
- **2024-01-14.md** (line 8): ...matching context...

### Projects/
- **Project Alpha.md** (line 45): ...matching context...

### Goals/
- **2024 Goals.md** (line 12): ...matching context...

**Found X matches across Y files**
```

### Step 4: Suggest related content

After showing results, check if any matched files contain `[[wiki-links]]` to other notes. If so, briefly mention:

```
💡 Related notes mentioned in results: [[Note A]], [[Note B]]
```

## No Results

If no matches are found:
1. Suggest alternative search terms (synonyms, related words)
2. Offer to search with case-insensitive matching if the original search was case-sensitive
3. Suggest checking `Archives/` if not already included

## Tips

- Search is case-sensitive by default. Add `-i: true` to the Grep call for case-insensitive search
- Use regex patterns for advanced searches: `task.*complete`, `#tag-name`
- Combine with `/daily` to quickly find when something was mentioned
goal-alignerSubagent

Analyze alignment between daily activities and long-term goals. Identify gaps, over/under-investment, and suggest rebalancing. Use for goal audits and priority checks.

inbox-processorSubagent

Process inbox items using GTD principles. Categorize, clarify, and organize captured notes into actionable items. Use for inbox zero and capture processing.

note-organizerSubagent

Organize and restructure vault notes. Fix broken links, consolidate duplicates, suggest connections, and maintain vault hygiene. Use when managing vault organization or cleaning up notes.

weekly-reviewerSubagent

Facilitate comprehensive weekly review process. Analyze past week's daily notes, calculate goal progress, and help plan next week. Use for Sunday/Monday weekly reviews.

adoptSkill

Scaffold the PKM system onto an existing Obsidian vault. Scans your vault structure, maps folders interactively, and generates configuration — no template required.

check-linksSkill

Find broken wiki-links in the vault. Read-only analysis — scans for [[links]] and verifies target files exist. No writes, no dependencies.

dailySkill

Create daily notes and manage morning, midday, and evening routines. Structure daily planning, task review, and end-of-day reflection. Use for daily productivity routines or when asked to create today's note.

goal-trackingSkill

Track progress toward 3-year, yearly, monthly, and weekly goals. Calculate completion percentages, surface stalled goals, connect daily tasks to objectives. Use for goal reviews and progress tracking.