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
2. Accept song title, artist, and/or URL.
3. If URL is YouTube, resolve video title/channel first (oEmbed is enough).

4. Detect arrangement intent when present (e.g., fingerstyle, drop D, capo).

5. Search tabs/sheet sources

6. Use web search with multiple queries:
   • "<song>" "<artist>" guitar tab
   • "<song>" fingerstyle tab
   • "<video title>" tab

7. Prefer useful sources with direct learning value (tabs/sheet/video with tab links).

8. Rank and filter

9. Return top 3–5 links.
10. For each result include:
    • source name
    • URL
    • short reason (exact match, arrangement match, likely match, etc.)
    • confidence (high/medium/low)

11. Call out likely paywalled links clearly.

12. Build practice note content

13. Include fields (unless user wants a different template):
    • status
    • song
    • artist
    • arrangement
    • tuning
    • capo
    • difficulty
    • best tab links
    • next practice step

14. Keep compact and editable.

15. Output mode

16. markdown (default): portable note body.
17. json: machine-friendly object.
18. 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

- 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

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