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 use...

Security Scan

The skill's requirements and runtime instructions are consistent with its stated purpose (finding guitar tabs and producing practice notes); it requests no unusual permissions or installs, but you should be cautious about allowing any local file operations or uploading copyrighted PDFs.

Purpose & Capability

Name/description match the SKILL.md workflow: it only describes web lookups, ranking, and producing markdown/json/optional Obsidian notes. There are no unrelated env vars, binaries, or installs requested.

Instruction Scope

Instructions primarily describe web searches and structured output (markdown/json). The skill permits local filesystem operations (Obsidian mode, copying a provided PDF, deduplication checks) but explicitly requires explicit user consent and a target path before writing. This is reasonable but relies on the agent faithfully enforcing the guardrails; accidental or ambiguous prompts could lead to unwanted file reads/writes.

Install Mechanism

Instruction-only skill with no install spec and no code files — minimal footprint and nothing written to disk by default.

Credentials

No environment variables, credentials, or config paths are requested. The requested access (web search, optional user-specified local folder) is proportionate to the described functionality.

Persistence & Privilege

always is false and the skill is user-invocable; it does not request persistent or elevated platform privileges. Autonomous invocation is allowed by default but not combined with other concerning factors here.

Assessment

This skill appears coherent and low-risk in its default, web-only mode. Before allowing local file operations or uploading PDFs: (1) only provide a specific target folder (never a root or broad path), (2) confirm the agent's prompt asking to write files before permitting it, (3) avoid uploading copyrighted material you don't own or have rights to host, and (4) test with a harmless song first to verify it doesn't read or write outside the specified folder. If you see any unexpected filesystem access, revoke the skill immediately.

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

- 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": ""
}