# Vault Find Sections

> Find all sections across vault matching a heading pattern. Triggers on "find sections", "notes with heading", "all X sections", "which notes have".

- Skill: `majiayu000/vault-find-sections` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add majiayu000/vault-find-sections`
- Raw SKILL.md: https://api.skillmd.com/api/skills/majiayu000/vault-find-sections/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: majiayu000 (https://skillmd.com/u/majiayu000)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/majiayu000/vault-find-sections

---


# Section Finder

Find all notes containing a specific heading pattern across your vault.

## When to Use

Invoke when you want to:
- Find all notes with "## References" sections
- Discover which notes have a specific heading
- Search for heading patterns (regex supported)
- Audit section usage across the vault

## Arguments

| Argument | Required | Default | Description |
|----------|----------|---------|-------------|
| `pattern` | Yes | - | Regex pattern to match heading text |
| `folder` | No | - | Limit search to specific folder |

## Process

### 1. Parse User Input

Identify the heading pattern:
- "find all notes with a References section"
- "which notes have a TODO heading?"
- "find sections matching 'Implementation.*'"
- "notes in projects/ with a Status section"

### 2. Call MCP Tool

```
mcp__flywheel__find_sections(
  pattern: "References",
  folder: null  // or "projects/" to limit scope
)
```

### 3. Format Results

**Sections Found:**
```
Section Search Results
=================================================

Pattern: "References"
Scope: Entire vault

Found 23 notes with matching sections:

-------------------------------------------------

Projects (12 notes):
  projects/Alpha.md
    └─ ## References (line 45)
  projects/Beta.md
    └─ ## References (line 32)
    └─ ### Code References (line 67)
  projects/Gamma.md
    └─ ## References (line 28)
  ... and 9 more

Tech Notes (8 notes):
  tech/frameworks/React.md
    └─ ## References (line 89)
  tech/frameworks/Vue.md
    └─ ## External References (line 102)
  tech/tools/Docker.md
    └─ ## References (line 56)
  ... and 5 more

Daily Notes (3 notes):
  daily-notes/2025-12-30.md
    └─ ## References (line 23)
  daily-notes/2025-12-29.md
    └─ ## References (line 31)
  daily-notes/2025-12-28.md
    └─ ## References (line 27)

-------------------------------------------------

Summary:
  Total matches: 25 headings in 23 notes
  Most common: "## References" (21 occurrences)
  Variations: "External References", "Code References"

=================================================
```

**With Regex Pattern:**
```
Section Search Results
=================================================

Pattern: "TODO|Tasks|Action Items"
Scope: projects/

Found 8 notes with matching sections:

-------------------------------------------------

  projects/Alpha.md
    └─ ## TODO (line 15)
  projects/Beta.md
    └─ ## Tasks (line 22)
    └─ ### Subtasks (line 34)
  projects/Gamma.md
    └─ ## Action Items (line 18)
  projects/Delta.md
    └─ ## TODO (line 12)
    └─ ## Completed Tasks (line 45)
  ... and 4 more

-------------------------------------------------

Pattern Tips:
  - Use ".*" for wildcards
  - Use "|" for alternatives
  - Case-insensitive matching

=================================================
```

**No Sections Found:**
```
Section Search Results
=================================================

Pattern: "Appendix"
Scope: Entire vault

No matching sections found.

Suggestions:
  - Try a different pattern
  - Check spelling
  - Use regex: "Append.*" for partial match

Similar headings that exist:
  - "## Appendices" (2 notes)
  - "## Additional Notes" (5 notes)

=================================================
```

## Common Patterns

| Pattern | Finds | Use Case |
|---------|-------|----------|
| `References` | All "References" sections | Link audit |
| `TODO\|Tasks` | TODO or Tasks headings | Task overview |
| `^Status$` | Exact "Status" heading | Project tracking |
| `Implementation.*` | Any Implementation heading | Code sections |
| `Notes?` | "Note" or "Notes" | Note sections |

## Use Cases

- **Vault auditing**: "How many notes have a References section?"
- **Template compliance**: "Which project notes are missing a Status section?"
- **Content discovery**: "Find all notes with Implementation details"
- **Section extraction**: "Find sections to extract for a report"

## Integration

Works well with other skills:
- **vault-section**: Extract content from found sections
- **vault-search**: Combine with metadata filtering
- **vault-health**: Include in vault structure audits

---

**Version:** 1.0.0