# Guitar Tab Finder

> Find guitar tabs/sheet sources for a song from a title or link (especially YouTube), rank the best matches, and produce a clean practice note. Use when a user asks to locate tabs/chords/fingerstyle arrangements and optionally create/update an Obsidian note (or generic markdown/json output) for a learning queue.

- Skill: `dvcrn/guitar-tab-finder` (Agent Skill)
- Install (CLI): `npx skillmds@latest add dvcrn/guitar-tab-finder`
- Raw SKILL.md: https://api.skillmd.com/api/skills/dvcrn/guitar-tab-finder/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Docs & Writing
- Author: dvcrn (https://skillmd.com/u/dvcrn)
- Updated: 2026-09-08
- Page: https://skillmd.com/skills/dvcrn/guitar-tab-finder

---


# Guitar Tab Finder

## Overview

Use this skill to turn a song link/title into a usable practice packet:
1) identify the song/arrangement,
2) find likely tab/sheet sources,
3) rank results with confidence notes,
4) write structured output in the user’s preferred format.

Default to flexible output (markdown/json). Use Obsidian formatting only when the user explicitly wants vault notes.

## Consent + Filesystem Guardrails

- Default behavior is **web lookup + text output only** (`markdown` or `json`).
- Perform any local file/vault action **only when explicitly requested**.
- Before writing files, require a user-provided target path/folder (or clearly confirmed default).
- Do not read/write outside the approved target path.
- If the user does not want local file operations, stay in non-local mode (`markdown`/`json`).

## Workflow

1. **Parse input**
   - Accept song title, artist, and/or URL.
   - If URL is YouTube, resolve video title/channel first (oEmbed is enough).
   - Detect arrangement intent when present (e.g., fingerstyle, drop D, capo).

2. **Search tabs/sheet sources**
   - Use web search with multiple queries:
     - `"<song>" "<artist>" guitar tab`
     - `"<song>" fingerstyle tab`
     - `"<video title>" tab`
   - Prefer useful sources with direct learning value (tabs/sheet/video with tab links).

3. **Rank and filter**
   - Return top 3–5 links.
   - For each result include:
     - source name
     - URL
     - short reason (exact match, arrangement match, likely match, etc.)
     - confidence (`high`/`medium`/`low`)
   - Call out likely paywalled links clearly.

4. **Build practice note content**
   - Include fields (unless user wants a different template):
     - `status`
     - `song`
     - `artist`
     - `arrangement`
     - `tuning`
     - `capo`
     - `difficulty`
     - `best tab links`
     - `next practice step`
   - Keep compact and editable.

5. **Output mode**
   - `markdown` (default): portable note body.
   - `json`: machine-friendly object.
   - `obsidian`: include wikilinks/embeds and vault-friendly file naming.

## Obsidian Mode Rules (optional)

Use these only when user asks for Obsidian output.

- Do not duplicate title in body if vault UI already shows filename as title.
- Use one note per song under user-specified folder.
- If a local PDF is provided, place/copy it near the note and link with:
  - `[[file.pdf]]` for link
  - `![[file.pdf]]` for embed preview
- Deduplicate by checking for existing note with same normalized song+artist name before creating a new one.

## Quality Bar

- Prefer accuracy over volume.
- Be explicit when uncertain.
- Do not claim tabs are free if not confirmed.
- Keep notes concise and practical (ready for immediate practice).

## Example Prompts

- “find guitar tabs for this song: https://www.youtube.com/watch?v=bApQqay1iJA”
- “get me the best fingerstyle tab sources for bee gees how deep is your love”
- “build a practice note for blackbird with top tab links and difficulty”
- “return json only with ranked links + confidence for this song”
- “obsidian mode: create a note in `guitar projects/songs to learn` and include tab links”
- “i uploaded a pdf tab. in obsidian mode, create note + embed the pdf”

## Output Templates

### Markdown template

```markdown
- status: to learn
- song: <title>
- artist: <artist>
- arrangement: <arrangement>
- tuning: <if known>
- capo: <if known>
- difficulty: <beginner/intermediate/advanced/unknown>

- best tab links:
  - <source> — <url> (<confidence>; <reason>)
  - <source> — <url> (<confidence>; <reason>)

- next practice step: <single concrete step>
```

### JSON template

```json
{
  "song": "",
  "artist": "",
  "arrangement": "",
  "tuning": "",
  "capo": "",
  "difficulty": "unknown",
  "links": [
    {"source":"","url":"","confidence":"high","reason":""}
  ],
  "next_step": ""
}
```

